Send Message
This section describes how to send messages via the Sinch India Conversation API. The message endpoint is the primary endpoint of the API, and this is where all messages are sent.
Request Type: POST
API URL: https://convapi.aclwhatsapp.com/v1/projects/<projectId>/messages:send
Request Parameters
| S.No. | Attribute | Required | Data Type | Details |
|---|---|---|---|---|
| 1 | app_id | Yes | String | The ID of the app sending the message |
| 2 | recipient | Yes | Object | Contains the channel and end user identity details |
| 2.1 | identified_by | Yes | Object | Contains the channel and end user identity details |
| 2.1.1 | channel_identities | Yes | Array of objects | Contains all the channels, including fallback ones, and their corresponding MSISDNs |
| 2.1.1.1 | identity | Yes | String | Starting with country code followed by mobile number. e.g. 919876543210 |
| 2.1.1.2 | channel | Yes | String | Channel identifier. Enum: WHATSAPP, RCS, SMS |
| 3 | message | Yes | Object | Message object — see message types below |
| 4 | callback_url | No | String | Overwrites the default callback URL for delivery receipts for this message |
| 5 | channel_priority_order | No | Array of strings | Explicitly defines channels and order in which they are tried. Items Enum: WHATSAPP, RCS, SMS |
| 6 | message_metadata | No | String | Metadata associated with the message. Returned in DLR. Up to 1024 characters |
Message Object Types
The message field accepts one of the following object types:
- Card Message
- Carousel Message
- Choice Message
- Location Message
- Media Message
- Template Message
- Text Message
- List Message