Skip to main content
POST
https://api-ai.zixflow.com
/
api
/
ingestion
/
rcs
/
v1
/
message
/
document
/
send
Send RCS Document Message
curl --request POST \
  --url https://api-ai.zixflow.com/api/ingestion/rcs/v1/message/document/send \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-workspace-id: <x-workspace-id>' \
  --data '
{
  "recipient": "<string>",
  "document_url": "<string>",
  "bot_id": "<string>",
  "suggestions": [
    {}
  ],
  "post_back_url": "<string>",
  "post_back_data": "<string>"
}
'
{
  "status": true,
  "message": "RCS document message sent successfully"
}

Description

This endpoint allows you to send a document message via RCS. You can include interactive suggestions for quick replies.

Headers

x-api-key
string
required
Your API key for authentication.
x-workspace-id
string
required
Your workspace ID for authentication.

Body

recipient
string
required
The phone number of the recipient in international format (e.g., “919876543210”).
document_url
string
required
The URL of the document to send. The document must be publicly accessible.
bot_id
string
The RCS bot ID to use for sending the message.
suggestions
array
Array of interactive suggestions (quick reply buttons) to include with the message.
post_back_url
string
Optional URL to receive post-back notifications about the message status.
post_back_data
string
Optional data to include in post-back notifications.

Response

status
boolean
Indicates whether the call was successful. true if successful, false if not.
message
string
Success or error response message.
{
  "status": true,
  "message": "RCS document message sent successfully"
}