RCS Business API

The RCS Business API facilitates seamless integration of RCS messaging into your applications, enabling efficient and personalized customer communication. With rich features, it empowers businesses to engage effectively, provide timely updates, and offer responsive customer support on a trusted platform, strengthening connections with their audience.

Endpoint

Headers

Name
contentType
Type
string
Description
This should be set to application/json.
Name
apikey
Type
string
Description
Find your API key under your login account.

POST

Plane Text

This endpoint is used to send an RCS (Rich Communication Services) message using a predefined campaign and template. The message is sent via a specified bot ID and can be targeted to a valid RCS-enabled phone number.

Required attributes

Name
number
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through RCS

Request

POST

   curl -G - /v1/rcs\
  -H 'apikey':'string'
  -H "Content-Type: application/json" \
  -d '{
        "number":"+91XXXXXXXXXX",
        "campaignName": "api-test",
        "botId": "EXPOSE",
        "type": "PRETRANS",
        "templateName": "plane_text"
      }'

Response

{
    "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
    "data": [
    {
        "recipient": "+91XXXXXXXXXX",
        "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
    }],
    "totalCount": 1,
    "message": "Message Sent Successfully!",
    "error": null
    }

POST

Rich Text

Rich Text in RCS refers to messages that go beyond simple plain text by allowing formatting and media enhancements such as: Buttons with actions.

Required attributes

Name
number
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through RCS

Request

POST

   curl -G - /v1/rcs\
  -H 'apikey':'string'
  -H "Content-Type: application/json" \
  -d '{
        "number":"+91XXXXXXXXXX",
        "campaignName": "api-test",
        "botId": "EXPOSE",
        "type": "PRETRANS",
        "templateName": "rich_text"
      }'

Response

{
    "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
    "data": [
    {
        "recipient": "+91XXXXXXXXXX",
        "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
    }],
    "totalCount": 1,
    "message": "Message Sent Successfully!",
    "error": null
    }

POST

Text with variables

This endpoint is for text templates with customizable parameters—simple integration, versatile customization.

Required attributes

Name
from
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type
Name
content
Type
array
Description
To build a message content object for RCS, typically include various fields such as param, fileUrl( images, video, and other media).
Name
params
Type
string
Description
If you have a registered template with placeholders and you need to submit parameter values in the same order as in the template, you can represent this as an array of values. Ensure that the values are not null, and if the template was registered without placeholders, you can submit an empty array.

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through WhatsApp

Request

POST

    curl -G - /v1/rcs\
   -H 'apikey':'string'
   -H "Content-Type: application/json" \
   -d '{
         "campaignName": "rcs-api-sms",
         "botId": "EXPOSE",
         "type": "PRETRANS",
         "number": "+91XXXXXXXXXX",
         "templateName": "text_with_variables",
         "content": [
             {
                 "params": [
                     "Bussiness",
                      "API'\''s"
                 ]
             }
         ]
     }'

Response

{
  "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
  "data": [
  {
  "recipient": "+91XXXXXXXXXX",
  "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
  } ],
  "totalCount": 1,
  "message": "Message Sent Successfully!", 
  "error": null
}

POST

STANDALONE if don't want to change the image in the Template

Required attributes

Name
number
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through RCS

Request

POST

   curl -G - /v1/rcs\
  -H 'apikey':'string'
  -H "Content-Type: application/json" \
  -d '{
        "number":"+91XXXXXXXXXX",
        "campaignName": "api-test",
        "botId": "EXPOSE",
        "type": "PRETRANS",
        "templateName": "standalone"
      }'

Response

{
    "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
    "data": [
    {
        "recipient": "+91XXXXXXXXXX",
        "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
    }],
    "totalCount": 1,
    "message": "Message Sent Successfully!",
    "error": null
    }

POST

STANDALONE if want to change the image in the Template

This endpoint is for text templates with customizable parameters—simple integration, versatile customization.

Required attributes

Name
from
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type
Name
content
Type
array
Description
To build a message content object for RCS, typically include various fields such as param, fileUrl( images, video, and other media).
Name
fileUrl
Type
string
Description
Publicly accessible URL to the media file you want to send

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through WhatsApp

Request

POST

    curl -G - /v1/rcs\
   -H 'apikey':'string'
   -H "Content-Type: application/json" \
   -d '{
         "campaignName": "rcs-api-sms",
         "botId": "EXPOSE",
         "type": "PRETRANS",
         "number": "+91XXXXXXXXXX",
         "templateName": "standalone",
         "content": [
             {
               "fileUrl": "https://omni-whtaspp-media.s3.ap-south-1.amazonaws.com/uploads/1740046830337.jpg"
             }
         ]
     }'

Response

{
  "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
  "data": [
  {
  "recipient": "+91XXXXXXXXXX",
  "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
  } ],
  "totalCount": 1,
  "message": "Message Sent Successfully!", 
  "error": null
}

POST

CAROUSEL if want to change the image in the Template

This endpoint is for text templates with customizable parameters—simple integration, versatile customization.

Required attributes

Name
from
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type
Name
content
Type
array
Description
To build a message content object for RCS, typically include various fields such as param, fileUrl( images, video, and other media).
Name
fileUrl
Type
string
Description
Publicly accessible URL to the media file you want to send

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through WhatsApp

Request

POST

    curl -G - /v1/rcs\
   -H 'apikey':'string'
   -H "Content-Type: application/json" \
   -d '{
         "campaignName": "rcs-api-sms",
         "botId": "EXPOSE",
         "type": "PRETRANS",
         "number": "+91XXXXXXXXXX",
         "templateName": "carousel_with_chips&buttons",
         "content": [
              {
                  "fileUrl": "https://omni-whtaspp-media.s3.ap-south-1.amazonaws.com/uploads/1740055635755.jpg"
              },
              {
                  "fileUrl": "https://omni-whtaspp-media.s3.ap-south-1.amazonaws.com/uploads/1740055635765.jpg"
                }
         ]
     }'

Response

{
  "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
  "data": [
  {
  "recipient": "+91XXXXXXXXXX",
  "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
  } ],
  "totalCount": 1,
  "message": "Message Sent Successfully!", 
  "error": null
}

POST

CAROUSEL if don't want to change the image in the Template

Required attributes

Name
number
Type
string
Description
Recipient's phone number (must be RCS-enabled and in international format) For example, if the number is in the India, the format would be: +91XXXXXXXXXX
Name
templateName
Type
string
Description
Name of the message template to be used.
Name
botId
Type
string
Description
Identifier of the RCS bot used to send the message
Name
type
Type
string
Description
Type of message. Typically "PRETRANS" or another predefined type

Optional attributes

Name
campaignName
Type
string
Description
The RCS campaign name refers to the specific name or title given to a campaign conducted through RCS

Request

POST

   curl -G - /v1/rcs\
  -H 'apikey':'string'
  -H "Content-Type: application/json" \
  -d '{
        "number":"+91XXXXXXXXXX",
        "campaignName": "api-test",
        "botId": "EXPOSE",
        "type": "PRETRANS",
        "templateName": "carousel_with_chips&buttons"
      }'

Response

{
    "id": "58d63c02-XXXX-XXXX-XXXX-XXXXbb39453",
    "data": [
    {
        "recipient": "+91XXXXXXXXXX",
        "messageId": "58d63c02-XXXXX-XXXXX-XXXXX-XXXX9bb39453:1"
    }],
    "totalCount": 1,
    "message": "Message Sent Successfully!",
    "error": null
    }