Add Read Receipts and Typing Indicators for ACS Advanced Messaging

specification/communication/Communication.Messages/client.tsp

@@ -7,7 +7,7 @@ import "./main.tsp";
 using Azure.ClientGenerator.Core;
 using TypeSpec.Versioning;
 
-@useDependency(Azure.Communication.MessagesService.Versions.c2025_04_01_Preview)
+@useDependency(Azure.Communication.MessagesService.Versions.c2025_09_01_Preview)
 namespace ClientForAcsMessages;
 
 @client({
@@ -20,6 +20,7 @@ interface NotificationMessagesClient
   @access(Access.internal, "csharp")
   @clientName("downloadMediaInternal", "csharp")
   downloadMedia is Azure.Communication.MessagesService.StreamOperations.getMedia;
+  sendReadReceipt is Azure.Communication.MessagesService.ReadReceiptsOperations.send;
 }
 
 @client({

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationAdministration_CreateConversation.json

@@ -0,0 +1,79 @@
+{
+  "title": "Creates a new conversation",
+  "operationId": "ConversationAdministrationOperations_CreateConversation",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "content-type": "application/json",
+    "body": {
+      "conversation": {
+        "topic": "Test",
+        "deliveryChannelIds": [
+          "0f0eb78e-a576-1dfc-b414-0f0756de3338"
+        ],
+        "outboundDeliveryStrategy": "allParticipants",
+        "participants": [
+          {
+            "displayName": "Customer",
+            "kind": "external",
+            "contacts": [
+              {
+                "id": "12345678901",
+                "kind": "whatsApp"
+              }
+            ]
+          },
+          {
+            "displayName": "Support",
+            "kind": "internal",
+            "contact": {
+              "id": "8:acs:uuid1",
+              "kind": "communication"
+            }
+          }
+        ]
+      },
+      "initialMessage": {
+        "content": "I need help"
+      }
+    },
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "19:[email protected]",
+        "topic": "Test",
+        "deliveryChannelIds": [
+          "0f0eb78e-a576-1dfc-b414-0f0756de3338"
+        ],
+        "outboundDeliveryStrategy": "allParticipants",
+        "participants": [
+          {
+            "id": "8:acs:uuid2",
+            "displayName": "Customer",
+            "kind": "external",
+            "contacts": [
+              {
+                "id": "12345678901",
+                "kind": "whatsApp"
+              },
+              {
+                "id": "8:acs:uuid2",
+                "kind": "communication"
+              }
+            ]
+          },
+          {
+            "id": "8:acs:uuid1",
+            "displayName": "Support",
+            "kind": "internal",
+            "contact": {
+              "id": "8:acs:uuid1",
+              "kind": "communication"
+            }
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationAdministration_DeleteConversation.json

@@ -0,0 +1,12 @@
+{
+  "title": "Deletes a specific conversation",
+  "operationId": "ConversationAdministrationOperations_DeleteConversation",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "conversationId": "19:[email protected]",
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "204": {}
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationAdministration_GetConversation.json

@@ -0,0 +1,47 @@
+{
+  "title": "Gets the details of a specific conversation",
+  "operationId": "ConversationAdministrationOperations_GetConversation",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "conversationId": "19:[email protected]",
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "19:[email protected]",
+        "topic": "Test",
+        "deliveryChannelIds": [
+          "0f0eb78e-a576-1dfc-b414-0f0756de3338"
+        ],
+        "outboundDeliveryStrategy": "allParticipants",
+        "participants": [
+          {
+            "id": "8:acs:uuid2",
+            "displayName": "Customer",
+            "kind": "external",
+            "contacts": [
+              {
+                "id": "12345678901",
+                "kind": "whatsApp"
+              },
+              {
+                "id": "8:acs:uuid2",
+                "kind": "communication"
+              }
+            ]
+          },
+          {
+            "id": "8:acs:uuid1",
+            "displayName": "Support",
+            "kind": "internal",
+            "contact": {
+              "id": "8:acs:uuid1",
+              "kind": "communication"
+            }
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationAdministration_TerminateConversation.json

@@ -0,0 +1,12 @@
+{
+  "title": "Terminates a specific conversation",
+  "operationId": "ConversationAdministrationOperations_TerminateConversation",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "conversationId": "19:[email protected]",
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "200": {}
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationThread_AddParticipants.json

@@ -0,0 +1,39 @@
+{
+  "title": "Adds participants to a specific conversation",
+  "operationId": "ConversationThreadOperations_AddParticipants",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "content-type": "application/json",
+    "conversationId": "19:[email protected]",
+    "options": {
+      "participants": [
+        {
+          "displayName": "Customer",
+          "kind": "external",
+          "contacts": [
+            {
+              "id": "12345678901",
+              "kind": "whatsApp"
+            }
+          ]
+        },
+        {
+          "displayName": "Support",
+          "kind": "internal",
+          "contact": {
+            "id": "8:acs:uuid1",
+            "kind": "communication"
+          }
+        }
+      ]
+    },
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "207": {
+      "body": {
+        "invalidParticipants": []
+      }
+    }
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationThread_AnalyzeConversation.json

@@ -0,0 +1,16 @@
+{
+  "title": "Get AI Analysis of a conversation",
+  "operationId": "ConversationThreadOperations_AnalyzeConversation",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "conversationId": "19:[email protected]",
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "summary": "The customer needs help."
+      }
+    }
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationThread_ListConversations.json

@@ -0,0 +1,86 @@
+{
+  "title": "Retrieves list of conversations",
+  "operationId": "ConversationThreadOperations_ListConversations",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "maxPageSize": 25,
+    "channelId": "0f0eb78e-a576-1dfc-b414-0f0756de3338",
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "19:[email protected]",
+            "topic": "Test",
+            "deliveryChannelIds": [
+              "0f0eb78e-a576-1dfc-b414-0f0756de3338"
+            ],
+            "outboundDeliveryStrategy": "allParticipants",
+            "participants": [
+              {
+                "id": "8:acs:uuid2",
+                "displayName": "Customer",
+                "kind": "external",
+                "contacts": [
+                  {
+                    "id": "12345678901",
+                    "kind": "whatsApp"
+                  },
+                  {
+                    "id": "8:acs:uuid2",
+                    "kind": "communication"
+                  }
+                ]
+              },
+              {
+                "id": "8:acs:uuid1",
+                "displayName": "Support",
+                "kind": "internal",
+                "contact": {
+                  "id": "8:acs:uuid1",
+                  "kind": "communication"
+                }
+              }
+            ]
+          },
+          {
+            "id": "19:[email protected]",
+            "topic": "Test",
+            "deliveryChannelIds": [
+              "0f0eb78e-a576-1dfc-b414-0f0756de3338"
+            ],
+            "outboundDeliveryStrategy": "allParticipants",
+            "participants": [
+              {
+                "id": "8:acs:uuid3",
+                "displayName": "Customer",
+                "kind": "external",
+                "contacts": [
+                  {
+                    "id": "12331112222",
+                    "kind": "whatsApp"
+                  },
+                  {
+                    "id": "8:acs:uuid3",
+                    "kind": "communication"
+                  }
+                ]
+              },
+              {
+                "id": "8:acs:uuid3",
+                "displayName": "Support",
+                "kind": "internal",
+                "contact": {
+                  "id": "8:acs:uuid3",
+                  "kind": "communication"
+                }
+              }
+            ]
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationThread_ListMessages.json

@@ -0,0 +1,39 @@
+{
+  "title": "Retrieves list of conversation messages",
+  "operationId": "ConversationThreadOperations_ListMessages",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "conversationId": "19:[email protected]",
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "1593108077690",
+            "sequenceId": 6,
+            "message": {
+              "kind": "text",
+              "content": "My order did not arrive"
+            },
+            "senderDisplayName": "Jane",
+            "createdOn": "2020-06-25T18:01:17.6900000Z",
+            "senderCommunicationIdentifier": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b"
+          },
+          {
+            "id": "1593107077690",
+            "sequenceId": 5,
+            "message": {
+              "kind": "text",
+              "content": "Hi I need help"
+            },
+            "senderDisplayName": "Jane",
+            "createdOn": "2020-06-25T17:44:37.6830000Z",
+            "senderCommunicationIdentifier": "8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b"
+          }
+        ]
+      }
+    }
+  }
+}

specification/communication/Communication.Messages/examples/2025-09-01-preview/ConversationThread_RemoveParticipants.json

@@ -0,0 +1,22 @@
+{
+  "title": "remove a participant from a conversation",
+  "operationId": "ConversationThreadOperations_RemoveParticipants",
+  "parameters": {
+    "api-version": "2025-09-01-preview",
+    "content-type": "application/json",
+    "conversationId": "19:[email protected]",
+    "options": {
+      "participantIds": [
+        "8:acs:uuid2"
+      ]
+    },
+    "endpoint": "https://my-resource.communication.azure.com"
+  },
+  "responses": {
+    "207": {
+      "body": {
+        "invalidParticipants": []
+      }
+    }
+  }
+}