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/models.tsp

@@ -53,7 +53,7 @@ union CommunicationMessageKind {
 
   @added(Versions.c2025_01_15_Preview)
   @doc("Interactive Actionable message type.")
-  interactive: "interactive",
+  interactive: "interactive"
 }
 
 @added(Versions.c2025_01_15_Preview)
@@ -291,6 +291,19 @@ model InteractiveNotificationContent extends NotificationContent {
   interactiveMessage: InteractiveMessage;
 }
 
+@added(Versions.c2025_09_01_Preview)
+@doc("A request to send a status update.")
+model ReadReceiptContent {
+  @doc("The id of the message this status refers to.")
+  messageId: string;
+
+  @doc("The Channel Registration ID for the Business Identifier.")
+  channelRegistrationId: string;
+
+  @doc("Whether this status update includes a typing indicator.")
+  typingIndicator?: boolean;
+}
+
 @added(Versions.c2025_01_15_Preview)
 @doc("The Interactive message content to which user can read and respond.")
 model InteractiveMessage {
@@ -651,6 +664,16 @@ model Notifications {
   id: string;
 }
 
+@resource("messages/readreceipts")
+@doc("A notification.")
+model ReadReceipts {
+  @key
+  @visibility(Lifecycle.Read) 
+  @invisible(Lifecycle) // The ID is only used as a key parameter.
+  @doc("The ID is only used as a key parameter.")
+  id: string;
+}
+
 @resource("messages/channels")
 @doc("A communication channel.")
 model CommunicationChannel {
@@ -737,6 +760,14 @@ model NotificationMessagesSendRequestBody {
   body: NotificationContent;
 }
 
+@added(Versions.c2025_09_01_Preview)
+@doc("Read Receipt send request body.")
+model ReadReceiptSendRequestBody {
+  @doc("Details of the read receipt update to send.")
+  @bodyRoot
+  body: ReadReceiptContent;
+}
+
 @added(Versions.c2025_04_01_Preview)
 @doc("The options of the outbound delivery strategy for messages sent by participants in a conversation.")
 union OutboundDeliveryStrategyKind {
@@ -1082,4 +1113,8 @@ enum Versions {
   @doc("Azure Communication Messages 2025-04-01-preview api version")
   @useDependency(Azure.Core.Versions.v1_0_Preview_2)
   c2025_04_01_Preview: "2025-04-01-preview",
+
+  @doc("Azure Communication Messages 2025-09-01-preview api version")
+  @useDependency(Azure.Core.Versions.v1_0_Preview_2)
+  c2025_09_01_Preview: "2025-09-01-preview",
 }

specification/communication/Communication.Messages/routes.tsp

@@ -40,6 +40,18 @@ interface NotificationMessagesOperations {
   >;
 }
 
+interface ReadReceiptsOperations {
+  @tag("ReadReceipts")
+  @added(Versions.c2025_09_01_Preview)
+  @doc("Sends a read receipt update from Business to User.")
+  send is Operations.ResourceCollectionAction<
+    ReadReceipts,
+    ReadReceiptSendRequestBody,
+    AcceptedResponse
+  >;
+}
+
+
 interface StreamOperations {
   @tag("Stream")
   @doc("Download the Media payload from a User to Business message.")

specification/communication/data-plane/Messages/preview/2025-01-15-preview/communicationservicesmessages.json

@@ -363,7 +363,8 @@
           "description": "Set or group of actions.",
           "items": {
             "$ref": "#/definitions/ActionGroup"
-          }
+          },
+          "x-ms-identifiers": []
         }
       },
       "required": [
@@ -441,7 +442,8 @@
           "description": "An array of details about specific errors that led to this reported error.",
           "items": {
             "$ref": "#/definitions/Azure.Core.Foundations.Error"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "innererror": {
           "$ref": "#/definitions/Azure.Core.Foundations.InnerError",
@@ -468,7 +470,7 @@
     },
     "Azure.Core.Foundations.InnerError": {
       "type": "object",
-      "description": "An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.",
+      "description": "An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.",
       "properties": {
         "code": {
           "type": "string",
@@ -934,7 +936,8 @@
           "description": "The template values.",
           "items": {
             "$ref": "#/definitions/MessageTemplateValue"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "bindings": {
           "$ref": "#/definitions/MessageTemplateBindings",
@@ -1304,7 +1307,8 @@
           "description": "The MessageTemplateItem items on this page",
           "items": {
             "$ref": "#/definitions/MessageTemplateItem"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "nextLink": {
           "type": "string",
@@ -1349,7 +1353,8 @@
           "description": "Receipts of the send message operation.",
           "items": {
             "$ref": "#/definitions/MessageReceipt"
-          }
+          },
+          "x-ms-identifiers": []
         }
       },
       "required": [
@@ -1548,28 +1553,32 @@
           "description": "The header template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsComponent"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "body": {
           "type": "array",
           "description": "The body template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsComponent"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "footer": {
           "type": "array",
           "description": "The footer template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsComponent"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "buttons": {
           "type": "array",
           "description": "The button template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsButton"
-          }
+          },
+          "x-ms-identifiers": []
         }
       },
       "allOf": [

specification/communication/data-plane/Messages/preview/2025-04-01-preview/communicationservicesmessages.json

@@ -1136,7 +1136,8 @@
           "description": "Set or group of actions.",
           "items": {
             "$ref": "#/definitions/ActionGroup"
-          }
+          },
+          "x-ms-identifiers": []
         }
       },
       "required": [
@@ -1266,7 +1267,8 @@
           "description": "An array of details about specific errors that led to this reported error.",
           "items": {
             "$ref": "#/definitions/Azure.Core.Foundations.Error"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "innererror": {
           "$ref": "#/definitions/Azure.Core.Foundations.InnerError",
@@ -1293,7 +1295,7 @@
     },
     "Azure.Core.Foundations.InnerError": {
       "type": "object",
-      "description": "An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.",
+      "description": "An object containing more specific information about the error. As per Microsoft One API guidelines - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.",
       "properties": {
         "code": {
           "type": "string",
@@ -2089,7 +2091,8 @@
           "description": "The template values.",
           "items": {
             "$ref": "#/definitions/MessageTemplateValue"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "bindings": {
           "$ref": "#/definitions/MessageTemplateBindings",
@@ -2525,7 +2528,8 @@
           "description": "The MessageTemplateItem items on this page",
           "items": {
             "$ref": "#/definitions/MessageTemplateItem"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "nextLink": {
           "type": "string",
@@ -2656,7 +2660,8 @@
           "description": "Receipts of the send message operation.",
           "items": {
             "$ref": "#/definitions/MessageReceipt"
-          }
+          },
+          "x-ms-identifiers": []
         }
       },
       "required": [
@@ -2944,28 +2949,32 @@
           "description": "The header template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsComponent"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "body": {
           "type": "array",
           "description": "The body template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsComponent"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "footer": {
           "type": "array",
           "description": "The footer template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsComponent"
-          }
+          },
+          "x-ms-identifiers": []
         },
         "buttons": {
           "type": "array",
           "description": "The button template bindings",
           "items": {
             "$ref": "#/definitions/WhatsAppMessageTemplateBindingsButton"
-          }
+          },
+          "x-ms-identifiers": []
         }
       },
       "allOf": [