Msg91 Help Doc
RCS

RCS

Everything about RCS Implementation

Follow the below steps for RCS Registration.

NOTE : RCS users who send messages within India are required to provide their GST/ PAN card details.


1. Click on the RCS in your MSG91 Dashboard.


seevn165952487841465



2. Click on “Schedule a Call With Us” button to get started.

Screenshot 2025-01-31 at 12.58.56 PM.png-qbkdot



3. Need some documents for Agent Registration -
You can fill this google spreadsheet and attach the required documents as mentioned in the form and share it over the email-

[email protected]

or

[email protected]

:

RCS Documentation for Clients-0vwoj3
RCS Documentation for Clients

https://m.9m.io/fcf6sbm


Form Requirements:

RCS Optin.png-p71j9e

Agent Registration Details


- Brand Name : User will see this as the sender in their messaging app (Maximum Limit of 40 Characters)
- Agent Description : A short description related to your business.(Maximum limit of 100 characters)
- Agent Hero Image : Dimensions: 1440x448 pixels, Aspect ratio : 45:14, Maximum File Size : 360 kB , File type: PNG/JPEG. & Attach file in the mail.
- Agent Logo : Dimension 224x224 pixels, Maximum file size of 90KB, Type: PNG/JPEG, & Attach file in the mail.
- Brand Color : Provide “Hex Code” of your brand's primary color.
- Phone Number : Mention the calling number, your user can call you on this number.(917316914378)
- Label for Phone Number : Maximum limit of 25 characters.(Contact Us, Call Us, Phone Number etc.)
- Email Address : Mention your official email address. This will be visible with label to all the end users. ([email protected])
- Label for Email Address : Maximum limit of 25 characters. (Contact Us, Mail Us, Email etc.)
- Website : Mention your business website. (https://msg91.com)

- Label for Website : Maximum limit of 25 characters.( Visit Us, Website, etc.)

Brand Registration Details

- Brand Legal Name : Registered name of your brand that is used for legal and administrative purposes
- Privacy Policy URL : Web link to your brand's official privacy policy document
- Terms & Condition URL : Web link to your brand's terms and conditions document.
- Status of Company : (Proprietor/ HUF/ Partnership Firm/LLP/ Pvt Ltd/ Ltd Co.)
- CIN Number : (In case of Company form of organization)
- Website URL : Official web link of the brand

- Brand Logo Please ensure that it is in the dimensions of 224x224 pixels with a maximum file size of 50 kB (PNG/JPEG). Please leave sufficient space in your image to account for cropping.

- PAN Card Number
- GST Number
- GST Status Valid from - Status Validation starts from this date.
- GST Status Valid to - Status Validation ends at this date.
- Certification of Incorporation / GST certificate : Maximum file size should be 2 MB (PDF)
- Brand Manager Details
POC Name : Person who will serve as a primary point of contact for RCS team for any interactions or communication with your brand.
POC Email Address
POC Mobile Number
POC Department
POC Function / Designation
- How do you obtain opt- in to message users with RCS? Opt-in is critical for approving Brand and Agent Launch. Please write in 1-2 lines how is opt-in obtained.
- What message will be sent when a user decides to opt-out?



5. After your RCS get approved it looks like this -


16593002554451659300


a. Display Name/Brand Name. : Here put the name, you want to display when a message gets delivered.


b. Description/Brand Description: Here you put the description you want below the brand name. 


16593002537891659300


c. Color: Here give the brand color so that icon and the selected items are displayed in that specific color only. 


16593002539301659300


d. Image:

Larger banner image (1440 x 448)*: Here put the background image.


16593002550161659300


Small logo (224 x 224): Here put the brand logo.


16593002552951659300


e. Region: Select the region.


f. Primary Phone Number: Provide the primary phone number to be displayed.


16593002556301659300


g. Label For Primary Phone Number*: Put the name to be displayed for the primary number. 


16593002543401659300


Note: You can add 2 more numbers.


h. Primary Website, Label for Primary Email: Here you can put the website to be displayed and the name to be displayed, but is completely optional.


i. Primary Email: Email to be displayed.


16593002542141659300


j. Label for Primary Email: Here is the label to be displayed in the email.


16593002558421659300


k. Terms of Service: Put the terms and condition page URL from website.


l. Privacy Policy: Put the privacy page URL from website.


m. RCS Use: Select the medium through which you want to use RCS with.


16593002515231659300


n. Opt-in-URL: Opt-in is critical for approving the agent launch. Provide details for how opt-in is acquired. If opt-in is through a website or an app, provide web address.

IMG_6975.png-jvh2o8

o. What actions trigger messages to users? When is the first message sent from the agent to the user? Are messages sent at a consistent date/time, do user actions (such as a purchase) trigger messages, or do external triggers (such as package delivery) trigger messages?

p. What message does the agent send when user opts out? When a user sends the word "STOP", your agent must reply, confirming that the user is opted out and won't receive more messages unless they opt in again. The agent can't send the user additional messages after this. Your agent must recognize “STOP” in English and the equivalent translations in other languages the agent supports.

16593002540661659300
RCS Form Registration Guide
May 1, 2025

NOTE : Please note that promotional messaging is permitted only between 9 AM and 9 PM, as per the standard policy. Kindly schedule your promotional campaigns within this time frame.

Step 1: Go to the MSG91 Dashboard and click on RCS.

image



Step 2: From the left-hand side panel, click on Templates. Then click on Create Template from the upper right-hand side corner.

image


 
​​Step 3: To create a template in 'Calendar Event,' first name the template, then select 'Calendar Event' in the function option. Enter the required values in the available fields, and finally click the 'Save' button.

image


Step 4: To create a template in 'Carousel,' first name the template, then select 'Carousel' in the function option, enter the values in the card option, click 'Add Button' if you want to include more cards in the template. Select action function for every card and then finally click the 'Save' button.

image

Step 5: To create a template in 'Dial,' first name the template, then select 'Dial' from the function option. Enter the required values, and once done, click the 'Save' button.

image



Step 6: To create a template in ‘Media’, first name the template, then select ‘Media’ from the function option. Enter the required values, and once done, click on the ‘Save’ button. 

image



Step 7: To create a template in ‘Open URL’, first name the template, then select ‘Open URL’ from the action option. Enter the required values, and once done, click on the ‘Save’ button.

image



Step 8: To create a template in ‘Rich Card’, first name the template, then select ‘Rich Card’ in the function option. Enter the values in the options appearing. Select the action function for the card, fill the details and then finally click on the ‘Save’ button.

image



Step 9: To create a template in 'Share Location,' first name the template, then select 'Share Location' in the function option. Enter the required values in the options that appear, and finally, click the 'Save' button.

image



Step 10: To create a template in ‘Suggested Replies’, first name the template, then select ‘Suggested Replies’ in the function option. Enter the values in the options appearing. Select the action function for the card, fill the details and then finally click on the ‘Save’ button.

image



Step 11: To create a template in 'Text Message,' first name the template, then select 'Text Message' under the function option, enter the values, and finally click the save button.

image



Step 12: To create a template in ‘View Location’, first name the template, then select ‘View Location’ from the function option, enter the values and finally click on the save button.


image





RCS Template Creation
Jul 25, 2025

NOTE : Please note that promotional messaging is permitted only between 9 AM and 9 PM, as per the standard policy. Kindly schedule your promotional campaigns within this time frame.

RCS will be delivered to:

  1. Android Users only not for IOS users.

  2. Internet Connection of the user must be on.

  3. Phone must have Google messaging to receive RCS.

Basic Message

The Basic Message within Rich Communication Services (RCS) operates functionally identical to a Short Message Service (SMS) text message. It transmits content solely in plain text format, prioritizing reliable delivery for straightforward communication.

Kb173383386612243173


​Single Rich Cards

It is a regular text message with a single, interactive element to grab attention. Add a picture/video/gif , product link, or clickable button to make your message stand out. Rich cards can contain the following items:

  • Image/video

  • Title text

  • Description text

A list of suggested replies and suggested actions (maximum 4) A rich card can contain any or all of the listed items, but a card must contain at least an image, video, or title to be valid.

Kb173383390106756173


           

Best Practices for Rich Card with images

  • Maximum 2MB for standalone image

  • Optimum resolution for media (Rich card Image ) is 1440px x720px

  • Number of characters in Card Description should not exceed 2000 characters. (We recommend 112 characters or below)

  • Number of characters in Card Title should not exceed 80 characters. (We recommend 40 characters or below)

  • Maximum four Suggested Actions (CTAs) allowed. (We recommend 2CTAs per rich card)


Supported Formats

  • For Images: jpeg, jpg, gif, png

  • For videos: mp4, mpeg, mpeg4, webm.

Best practices for Rich Card for Videos

  • Maximum 10MB for standalone video

  • Maximum 40Kb for thumbnails

  • Optimum resolution for media (Video) is 1440px x720px. (Recommended but not mandatory)

  • Optimum resolution for the media's thumbnail is 770x335 px. (Recommended but not mandatory)

  • Number of characters in Card Description should not exceed 2000 characters. (We recommend 112 characters or below)

  • Number of characters in Card Title should not exceed 80 characters. (We recommend 40 characters or below)

  • Maximum four Suggested Actions (CTAs) allowed. (We recommend 2 CTAs per rich card)

Supported Formats

  • For videos: mp4, mpeg, mpeg4, webm

Carousel Teamplate 
The RCS carousel is a horizontally scrollable set of 2 to 10 vertical rich cards. Each card can include the following elements.

Title text - Maximum 200 characters
Subtitle text - Maximum 2000 characters
Media - It should have an aspect ratio of 4:3.When the media has a 4:3 aspect ratio, the optimal resolution for the media is 960x720 px with a maximum file size of 1 MB for images and 5 MB for video
Media Thumbnail: The optimal resolution for the media's thumbnail is 605x452 px with a recommended file size of 40 kB and a recommended maximum size of 100 kB
Suggested actions have a maximum of 25 characters
​ Up to 4 buttons (RCS limitations) In each rich card

Kb173383398019785217


RCS Template creation and Best Practices
Apr 15, 2025


This document specifies the general validation for template creation as well as RCS message sending limitations.

Limitations:

  1. The promotional messaging is permitted only between 9 AM and 9 PM, as per the standard policy. Kindly schedule your promotional campaigns within this time frame.

  2. As per operator guidelines, you are allowed to send a maximum of 4 RCS templates to each user per month.

Template Name:

Template names must be between 4 to 20 characters only.

Media Validations:

Rich Card:

For image:

  1. Max size: 2 MB

  2. Dimensions: 300×250 px

For Video:

  1. Max_size: 10 MB

  2. Dimensions: 770×335 px

Carousel:

For image:

  1. Max size: 1 MB

  2. Dimensions: 960×720 px

For Video:

  1. Max size: 5 MB

  2. Dimensions: 960×720 px

NOTE:

When designing images, ensure that all important information—such as text, logos, or key visuals—is placed at the center. This helps prevent essential content from being cropped on various mobile device screens, where aspect ratios and display areas may vary.

Types of Templates:


1. Text Message:

In RCS text messsage Must be less than 1000 characters.

Screenshot 2025-05-12 at 9.00.17 PM.png



  1. Calendar Event

Required Fields:

  1. Text - Must be less than 1000 characters.

  2. Start time - You can select from the calender icon given or set the variable.

    Formate for the time: 05/15/2025, 8:00:06 AM

  3. End time - You can select from the calender icon given or set the variable.

    Format for the time: 05/15/2025, 8:00:06 AM

  4. Title - Must be less than 100 characters.

  5. Description - Must be less than 500 characters.

  6. Text to show - Must be less than 25 characters.


Screenshot 2025-05-12 at 9.11.33 PM.png



3. Carousal
-Number of cards must be between 2 to 10.

-For each card max sum of replies and action buttons must be less than 4.

-Card without any button may also be possible,

Required Fields:

  1. Title - Must be less than 40 characters.

  2. Description - Must be less than 112 characters.

  3. Replies list - Must be less than 25 characters.

  4. Action list - Must follow action validation described below.

  5. Image urls - One variable/image is supported in each card.

    Dimensions for each card:

    960 × 720 pixels (Aspect Ratio: 3:2)

    ✅ Tips:

    Keep the file size below 1 MB (smaller is better for faster delivery).

    Use JPEG or PNG formats.

    Ensure important content (text, logos) stays within the center “safe area” to avoid cropping on different devices.

Screenshot 2025-05-12 at 11.49.30 PM.png


  1. Dial

Required Fields:

  1. Dial number - Variable supported. Must contain a phone number. (combination of +, #, and * with phone number are allowed like - +917316914378)

  2. Text - Variable supported. Must be less than 1000 characters.

  3. Text to show - Variable supported. Must be less than 25 characters.

Screenshot 2025-05-13 at 12.07.52 AM.png


5. Open_url:

Required Fields:

  1. Text - Variable supported. Must be less than 1000 characters.

  2. Text to show- Variable supported. Must be less than 25 characters.

  3. Url - Variable supported. Url must start with https or http.

    Screenshot 2025-05-13 at 12.15.55 AM.png

  1. Rich card:

Required Fields:

  1. Media url - Variable supported.

  2. Replies list - Must be less than 25 characters.

  3. Actions - Total number of Actions and Replies must be less than 4.

  4. Title - Variable supported. Must be less than 40 characters.

  5. Description - Variable supported. Must be less than 112 characters.

Screenshot 2025-05-13 at 12.22.09 AM.png

7. Suggested replies:
Max sum of replies and action button must be less than 11. At least one action or reply is required. It is similar to a text message with any type of action buttons and replies button.

 Required Fields:

  1. Text - Variable supported. Must be less than 1000 characters.

  2. Replies list - Must be less than 25 characters.

  3. Actions - Max sum of replies and action button must be less than 11.

Screenshot 2025-05-13 at 12.36.12 AM.png

  1. View Location: 

Required Fields:

  1. Text - Variable supported. Must be less than 1000 characters.

  2. Location query - Variable supported.

  3. Text - Variable supported. Must be less than 1000 characters.

  4. Text to show - Variable supported. Must be less than 25 characters.

Screenshot 2025-05-13 at 12.44.59 AM.png

Action button validations:

Calender Event:

Required field:

  1. Text to show: 25 characters.

  2. Start time:  One variable supported. Date & time should be in : Year-Month-Day T Hour:Minute:Second.Microseconds in UTC (ISO 8601 format).

  3. End time: Variable support. Date & time should be in : Year-Month-Day T Hour:Minute:Second.Microseconds in UTC (ISO 8601 format).

  4. Title: Variable support.

  5. Description: Variable supported.


Dial:

Required field:

  1. Dial number: Variable supported. Must contain correct phone number, with combination of + # and * are allowed

  2. Text to show: Variable supported. Must be less than 25 characters.


Open url:

Required field:

  1. Url: Variable supported. Url must start with https or http.

  2. Text to show: Variable supported. Must be less than 25 characters.


Share location:

Required field:

  1. Text to show: Variable supported. Must be less than 25 characters.


View location:

Required field:

  1. Location query: Variable supported

  2. Text to show: Variable supported. Must be less than 25 characters.


RCS Template Limitations
Jul 9, 2025

WebEngage RCS Integration through MSG91

WebEngage RCS Integration Using RSP Private Connector

This help document guides you through integrating WebEngage with RCS using the RSP Private Connector. Follow these steps to set up the integration and configure the Webhook for fetching delivery events.

How to Setup the RCS Connector in WebEngage?

Login to WebEngage :- Go to the WebEngage website and log in with your credentials.

Navigate to Integrations :- In the WebEngage dashboard, navigate to Data Platforms > Integrations.

AD_4nXcD2FzH2Xhtfbdq



Channel Integration Status :- Click on Configure RCS.

AD_4nXeN3dik9ysLMziA


Add Private RSP: Click on Add “Private RSP”

AD_4nXfXdkaMaCQ6kges


Enter all the details step by step:
Fill in the Configuration Details:-

RCS Service Provider :- Private RSP

Configuration Name :- MSG91 RCS

RCS Business Number :- MSG91 RCS Project ID (

How to Get RCS Project Id?

)

MSG91 RCS API URL :

https://control.msg91.com/api/v5/rcs/send-rcs-message-web-engage/

Add Custom Headers

Custom Headers ( authkey ) :-  MSG91Authkey (

How to Get Authkey?

)

Click on Add RSP Button to save the configuration

AD_4nXf56kisUCMO3tCQ

Select Private RSP in RCS Service Provider >> Give a Name to this Connector (i.e. MSG91 RCS) >> RCS Business Number (Enter RCS Project id From MSG91) >> Add MSG91 RCS API URL mentioned above image >> Click on Add Header and Then type “authkey” in First Box and Enter the MSG91 authkey in second box >> Click “Add RSP” Button.

Configuring the Webhook for Fetching Delivery Events

In the WebEngage dashboard, navigate to Data Platforms > Integrations > Configure RCS.
Click on the three dots next to your configured RCS integration and select View Webhook URL.
Copy the displayed URL.

AD_4nXfGyyPyo5R0ekXq

Data Platforms >>  Integrations >>  Configure RCS >> Click on Three Dots >> View Webhook URL >> Copy the Displayed URL

Now get the WebEngage API Key (Auth Token)

AD_4nXchX-KXE2z1F6uN

Data Platform >> Integrations >> Rest API >> Click View >> Copy The API Key (WebEngage DSN Auth Token) and keep it with you.


Share both the copied Delivery Webhook URL you copied and the API (DSN Auth Token) with MSG91 support team at

[email protected]

to enable webengage webhook payload setting in your MSG91 account after that your connector is ready to send RCS messages.


How to Create RCS Template In WebEngage?

Navigate to Integrations :- In the WebEngage dashboard, navigate to Data Platforms > Integrations > Channel Integration Status > Click on Configure RCS. > RCS Templates “+” Button

AD_4nXfNlaZTfsuYkT-l

Data Platforms > Integrations > Channel Integration Status > Click on Configure RCS. > Click on RCS Templates “+” Button.

Add Template: Enter the details of RCS Template Approved on MSG91 and click on Add Template Button on the Right Bottom as shown in below images.

AD_4nXeViGICTPq6ibCl

AD_4nXf0C53HfJPn4pR-

AD_4nXc28HAFJY-ZwOWi




How to run a RCS campaign Via WebEngage?

Navigate to Channels :- In the WebEngage dashboard, Navigate to Channels > RCS > Click on RCS “+” Button+
Navigate to Channels > RCS > Click on RCS “+” Button > Follow the Step by Step instruction as shown in below images.

Step 1: Click on the “+” Button

AD_4nXedA2vYtswJOcCL


Step 2: Give Campaign name and select the Target Segment

AD_4nXeb0rq7bAIL0daE


Step 3 :  Save&Continue

AD_4nXfuxyd5fsb1p75k


Step 4:  Select Template and then click on Save&Continue

AD_4nXe-INaMi0CTybiw


Step 5 : Test The Campaign and Click on “Save&Continue” (If Received the Test Message)

AD_4nXeFEW5hz02FlTfx


Step 6:  Clcik on the “Launch Campaign” Button

AD_4nXesz_3v-mwmfvto

Step 7 : Go to the channels > RCS > Click on the Campaign Name > Overview > Check the Delivery Logs Report.

AD_4nXeNd-4pSdVw63ss

Go to the channels >> RCS >> Click on the Campaign Name >> Overview >> Check the Delivery Logs Report



Summary:


By following these steps, you will successfully integrate WebEngage with RCS using MSG91's RSP Private Connector. This setup allows you to send personalized messages and track delivery events efficiently. Ensure that all configurations are accurately filled in to avoid any issues with the integration.



Contributors

This section was created by the Partners Team:

[email protected]

* Tahir Khan



WebEngage RCS Integration
May 20, 2025


This guide explains — what’s not allowed at all on RCS and what’s allowed only with conditions. Think of it as the rulebook before you go for RCS application and before sending the messages.


Absolutely Not Allowed (Don't Even Think About It)
No matter how appealing your content is, these are strictly banned:

  • Fake or duplicate products: Copying big brands or selling replicas? Straight up rejected.

  • Explosives or banned materials: Anything illegal or dangerous like weapons or drugs won't go through.

  • Violent or hateful content: Anything promoting violence or hate is strictly disallowed.

  • Adult content or escort services: Sexual content or services of this nature are completely off-limits.

  • Tobacco, guns, or any weapons: Even if they’re legal somewhere, RCS doesn’t allow promotions.

  • Political or election messaging: Content related to campaigning or political promotion is not permitted.

  • Human trafficking or exploitation: Any form of exploitation-related content is permanently banned.


Allowed, But Only If You Follow the Rules…
These are not banned, but come with serious conditions. You need approval first:

  • Alcohol-related promotions: Not allowed in India.

  • Gambling or betting services: May be permitted with valid operational licenses and strict adherence to age verification protocols.

  • Medical and health-related products: Prescription drugs, supplements, or healthcare services may be approved with documented regulatory compliance.


Still confused? Reach out to MSG91’s support team- [email protected]. Following the rules not only keeps you safe—it ensures your RCS applications gets the approval.

RCS Prohibited & Restricted Industries and Content – MSG91 Help Guide
Jul 22, 2025


RCS Error Code - FAQ’S

MSG91 PANEL

ERROR

Why This Happens

How to Fix It

Unreachable Number 

RCS Not Enabled on Device, Number Format Issue, Device Offline / No Data, Temporary Network Issue

Ensure proper formatting

https://msg91.com/help/rcs/new-article-1724395069894781

, Add fallback channels (sms, email, whatsapp)

https://msg91.com/help/campaign/how-to-create-a-campaign-flow

 

Image provided is greater than maximum limit

RCS Image Size Limits - 

Resize the Dimensions as

https://msg91.com/help/rcs/rcs-create-template-with-validations

Invalid Number

Number Format Issue, Fake or Test Numbers, Number Not Registered for RCS, Blocked or Inactive Number

Always Use country code before number, Add fallback channels (sms, email, whatsapp)

https://msg91.com/help/campaign/how-to-create-a-campaign-flow

 

Too many requests

Rate Limit Exceeded

Send only 4 RCS templates to each user per month

https://msg91.com/help/rcs/rcs-create-template-with-validations


Note that the promotional messaging is permitted only between 9AM to 9PM, as per standard policy.

User not found 

Recipient is not RCS-enabled, Using iOS or Unsupported Device, Temporary Network/Registration Issue, Number Issue

It means users not having RCS enabled in their mobile phone.
Set fallback (sms, whatsapp, email)

https://msg91.com/help/campaign/how-to-create-a-campaign-flow

Opted out customer 

User blocked the brand agent, User opted out of promotional messages, Consent not taken or expired, Google RBM policy violation

Check if the user is on the OPTOUT list to receive RCS messages. If you want to send messages, remove the number from the Blacklist Number list

https://msg91.com/help/rcs/how-to-set-opt-out-rules-in-rcs-


API

Http Code

Massages

Code

Why This Happens

How to Fix It

400

Bad request 

2

Invalid JSON Payload, Wrong Parameter Names, Empty or Missing Required Fields, Invalid URL

Validate JSON Payload, Ensure Media URLs, Check Headers

401

Unauthorized

3

Invalid or Expired Access Token, Missing Authorization Header, Wrong API Key or Credentials

Regenerate Access Token, Check API Key

402

Forbidden

4

Wrong Project / Brand Mapping, Agent Not Approved or Not Live

Check Agent Status, Verify Token and Project

404

User Not found


5


User is not RCS-enabled, Unsupported Device or IOS, Inactive or Wrong Number

Check RCS Capability Before Sending, Use Correct Number Format, Enable Fallback Messaging

429

Too many requests

6

Exceeding API Rate Limit,
Concurrent Requests Overload

Implement a Queue, Check Provider Limits

500

Internal Server Error

7

Temporary network disruptions, API server overload, DNS or routing failures

Check your internet connectivity, Ensure API endpoint is reachable and not under maintenance

429

Bot Rate Limit Exceeded 

9

Sending too many messages in a short period (bulk campaign without throttling), Improper batching or queuing mechanism, Multiple retries fired simultaneously

Implement retry logic with exponential backoff when this error occurs, Contact your provider to request higher rate limits if needed

500

Internal Server Error

11

Slow network connectivity, Server overload or high latency, API processing delay

Ensure you have a stable internet connection, Implement timeout and retry logic with exponential backoff, If the issue persists, check server status or contact support

500

Internal Server Error

12


Temporary server outage or overload, Misconfigured reverse proxy or load balancer, Network routing issues

Retry the request after some time, Check your network connectivity, Contact your service provider if the issue persists

500

Internal Server Error

13


Temporary server outage or overload, Misconfigured reverse proxy or load balancer, Network routing issues

Retry the request after some time, Check your network connectivity, Contact your service provider if the issue persists

500

Internal Server Error

14


Temporary server outage or overload, Misconfigured reverse proxy or load balancer, Network routing issues

Retry the request after some time, Check your network connectivity, Contact your service provider if the issue persists

400

Invalid value for message, one of fields for expiry is already set 

15

Wrong field name or incorrect data type in the payload, Duplicate message parameters in the request body

Validate the payload structure as per RCS API documentation, Ensure correct data type

400

Invalid value for message field expiry time.

16

Expiry time is set in the past or exceeds the maximum allowed duration. Negative or non-numeric value is provided. Incorrect field name or extra parameters in the request.

Ensure expiry time is future-dated and within the allowed limit, Remove any conflicting expiry fields

400

Invalid value for message field ttl, the ttl duration must a digit string ending with 's'

17

TTL is missing the unit ‘s’ (seconds) at the end, TTL contains invalid characters or spaces, TTL exceeds maximum allowed duration

Ensure TTL value does not exceed 14 days, Validate your JSON payload format before sending.

500

Internal Server Error

20

Temporary network or server issues, The user’s carrier or device did not respond to the capability check, API timeout or upstream service failure

Retry the request after some time, Ensure you have a stable internet connection, Validate that the phone number

500

Internal Server Error

21

Missing or incorrect fields in the request body, Unsupported media format or size, Invalid phone number format

Validate the message payload against the API documentation, Ensure media files meet RCS requirements, Check your authentication token and regenerate if needed


403

Operation not allowed. Account inactive 

23

Account not yet approved or verified by Google RBM, Account suspended due to policy violation or inactivity, Billing or subscription issues with the RCS provider 

Complete any pending verification or approval steps, Resolve billing or compliance issues, If account was suspended, contact support to reactivate it

403

Operation not allowed. User has opted out.

24

User blocked your brand or replied with STOP, Consent expired or was revoked, Sending promotional messages without proper opt-in

Provide a clear opt-in mechanism via SMS, email, or website, Maintain an updated opt-out suppression list in your system

500

Internal Server Error

25

Missing or incorrect fields in the request body, Unsupported media format or size, Invalid phone number format

Validate the message payload against the API documentation, Ensure media files meet RCS requirements

500

Too many requests! Account configured TPS exceeded/
Too many requests! Default Account TPS exceeded 

28

Bulk campaigns sending messages too quickly, No throttling or queuing implemented, Multiple concurrent API calls exceeding account quota

Contact your provider to increase TPS limits if needed, Monitor your campaign flow and adjust scheduling to avoid bursts

500

Internal Server Error

30

Corrupted or incomplete assistant configuration, Missing required parameters during creation, Network or server connectivity issues during setup.

Re-create the assistant with all mandatory configuration fields, Verify your authentication credentials and permissions, Ensure a stable network connection during setup


RCS Error Code - FAQ’S
Jul 24, 2025