address certification comments

Author: lei-msft

certified-connectors/Azure Communication Services Chat/README.md

@@ -1,37 +1,19 @@
-# Azure Communication Services Chat Connector
-
-This Chat Connector can be used to add real-time text communication to your cross-platform applications. You can read more about Azure Communication Services Chat [here](https://docs.microsoft.com/en-us/rest/api/communication/chat/chat-thread).
+# Azure Communication Services Chat
+This Chat Connector can manage users in a chat, create chats threads, and send messages in a chat. [API ref for chat](https://docs.microsoft.com/en-us/rest/api/communication/chat/chat),  [API ref for chat thread](https://docs.microsoft.com/en-us/rest/api/communication/chat/chat-thread). 
 
 ## Publisher: Microsoft
 
 ## Prerequisites
-
 You will need the following to proceed:
 * A Microsoft Power Apps or Power Automate plan with custom connector feature
 * An Azure subscription
 * An Azure Communication Services resource
 
-### Set up an Azure Communication Services resource
-- [Quickstart doc](https://review.docs.microsoft.com/en-us/azure/communication-services/quickstarts/create-communication-resource?branch=main&tabs=windows&pivots=platform-azp)
-
-
-## Obtaining Credentials
-
-### Connection String Authentication
-You can create a new connection using an [Azure Communication Services resource connection string](https://docs.microsoft.com/en-us/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp#access-your-connection-strings-and-service-endpoints).
-
-## Deployment Instructions
-
-Run the following commands and follow the prompts:
-
-```paconn
-paconn create --api-def .\apiDefinition.swagger.json --api-prop .\apiProperties.json --script .\script.csx --icon .\icon.png
-```
-
 ## Supported Operations
+The connector supports the following operations:
 
 ### Send Chat
-Send a chat to a sepcified chat thread given an access token.
+Send a chat to a specified chat thread given an access token.
 
 ### Create Chat
 Create a chat given a chat topic. 
@@ -46,10 +28,27 @@ List Messages From Thread.
 Get the properties of a chat thread.
 
 ### Add Participant
-Add a participant to a chat thread
+Add a participant to a chat thread.
 
 ### Remove Participant
-Remove a participant from a chat thread
+Remove a participant from a chat thread.
 
 ### List Participants
-List participants in a chat thread
+List participants in a chat thread.
+
+## Obtaining Credentials
+
+1 Set up an Azure Communication Services resource
+- [Quickstart doc](https://review.docs.microsoft.com/en-us/azure/communication-services/quickstarts/create-communication-resource?branch=pr-en-us-192537&tabs=windows&pivots=platform-azp)
+
+2 Connection String Authentication
+- You can create a new connection using an [Azure Communication Services resource endpoint url](https://docs.microsoft.com/en-us/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp#access-your-connection-strings-and-service-endpoints).
+
+## Known Issues and Limitations
+Does not support Service principal (Azure AD application) Authentication at this time.
+
+## Deployment Instructions
+Run the following commands and follow the prompts:
+```paconn
+paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --script script.csx --icon icon.png
+```

certified-connectors/Azure Communication Services Chat/apiDefinition.swagger.json

@@ -1,7 +1,7 @@
 {
   "swagger": "2.0",
   "info": {
-    "title": "Azure Communication Services Chat",
+    "title": "Azure Communication Chat",
     "description": "Connector to utilize Azure Communication Services Chat features.",
     "version": "1.0",
     "x-ms-api-annotation": {
@@ -42,7 +42,7 @@
     "/chat/threads/{chatThreadId}/messages": {
       "get": {
         "responses": {
-          "201": {
+          "200": {
             "description": "Success.",
             "schema": {
               "type": "object",
@@ -124,6 +124,12 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "summary": "List chat thread messages",
@@ -160,6 +166,12 @@
               }
             }
           }
+        },
+        "401": {
+          "description": "Unauthorized"
+        },
+        "403": {
+          "description": "Forbidden"
         }
       },
       "summary": "Send message to thread",
@@ -207,6 +219,12 @@
         "responses": {
           "201": {
             "description": "Success."
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "summary": "Add chat thread participants",
@@ -263,6 +281,12 @@
         "responses": {
           "204": {
             "description": "Success."
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "summary": "Remove chat thread participant",
@@ -292,7 +316,7 @@
     "/chat/threads": {
       "get": {
         "responses": {
-          "201": {
+          "200": {
             "description": "Success.",
             "schema": {
               "type": "object",
@@ -334,6 +358,12 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "summary": "List chat threads",
@@ -387,6 +417,12 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "summary": "Create chat thread",
@@ -441,7 +477,7 @@
     "/chat/threads/{chatThreadId}/participants": {
       "get": {
         "responses": {
-          "201": {
+          "200": {
             "description": "Success.",
             "schema": {
               "type": "object",
@@ -474,6 +510,12 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "summary": "List chat thread participants",
@@ -501,7 +543,7 @@
     "/chat/threads/{chatThreadId}": {
       "get": {
         "responses": {
-          "201": {
+          "200": {
             "description": "Success.",
             "schema": {
               "type": "object",
@@ -544,6 +586,12 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
           }
         },
         "operationId": "GetThreadProperties",

certified-connectors/Azure Communication Services Chat/apiProperties.json

@@ -15,9 +15,10 @@
         }
       }
     },
-    "iconBrandColor": "#3C1D6E",
+    "iconBrandColor": "#007ee5",
     "capabilities": [],
     "policyTemplateInstances": [],
-    "publisher": "Microsoft"
+    "publisher": "Microsoft",
+    "stackOwner": "Microsoft"
   }
 }