CommunicationMessagesClient (stable:2024-08-30)

2025/04/11 • 1 updated methods

NotificationMessagesOperations_Send (updated)
Description :  Sends a notification message from Business to User.
Reference :  Link ¶

⚶ Changes

{
  "#id": "NotificationMessagesOperations_Send",
  "$parameters": {
    "body": {
      "$properties": [
        {
          "#name": "kind",
          "Description": {
            "new": "The type discriminator describing a message type.",
            "old": "The type discriminator describing a notification type."
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /messages/notifications:send
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
Repeatability-Request-ID:
{
Description: An opaque, globally-unique, client-generated string identifier for the request. ,
Required: False ,
}
string ,
Repeatability-First-Sent:
{
Description: Specifies the date and time at which the request was first created. ,
Format: date-time ,
Required: False ,
}
string ,
x-ms-client-request-id:
{
Description: An opaque, globally-unique, client-generated string identifier for the request. ,
Format: uuid ,
Required: False ,
}
string ,
body:
{
Description: Details of the message to send. ,
Required: True ,
}
{
channelRegistrationId:
{
Description: The Channel Registration ID for the Business Identifier. ,
Format: uuid ,
Required: True ,
}
string ,
to:
{
Description: The native external platform user identifiers of the recipient. ,
Required: True ,
}
[
string ,
]
,
kind:
{
Description: The type discriminator describing a message type. ,
Enum:
{
text: Text message type. ,
image: Image message type. ,
image_v0: Image message type. Legacy image type for `MediaNotificationContent` which is being deprecated ,
document: Document message type. ,
video: Video message type. ,
audio: Audio message type. ,
template: Template message type. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
repeatability-result:
{
Description: Indicates whether the repeatable request was accepted or rejected. ,
}
string ,
x-ms-client-request-id:
{
Description: An opaque, globally-unique, client-generated string identifier for the request. ,
}
string ,
}
,
$schema:
{
Description: Result of the send message operation. ,
}
{
receipts:
{
Description: Receipts of the send message operation. ,
Required: True ,
}
[
{
messageId:
{
Description: The message id. ,
Required: True ,
}
string ,
to:
{
Description: The native external platform user identifier of the recipient. ,
Required: True ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
$headers:
{
x-ms-error-code:
{
Description: String error code indicating what went wrong. ,
}
string ,
}
,
$schema:
{
Description: A response containing error details. ,
}
{
error:
{
Description: The error object. ,
Required: True ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: True ,
}
string ,
message:
{
Description: A human-readable representation of the error. ,
Required: True ,
}
string ,
target:
{
Description: The target of the error. ,
Required: False ,
}
string ,
details:
{
Description: An array of details about specific errors that led to this reported error. ,
Required: False ,
}
[
string ,
]
,
innererror:
{
Description: An object containing more specific information than the current object about the error. ,
Required: False ,
}
{
code:
{
Description: One of a server-defined set of error codes. ,
Required: False ,
}
string ,
innererror:
{
Required: False ,
}
string ,
}
,
}
,
}
,
}