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.




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

Screenshot 2025-01-31 at 12.58.56 PM.png



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
RCS Documentation for Clients
https://m.9m.io/fcf6sbm


Form Requirements:

RCS Optin.png

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 -



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. 



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



d. Image:

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



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



e. Region: Select the region.


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



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



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.



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



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.



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

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.

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.



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


 
​​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.


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.

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.



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. 



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.



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.



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.



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.



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.



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.






RCS Template Creation
Apr 15, 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.


​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.


           

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


RCS Template creation and Best Practices
Apr 15, 2025


This document specifies the general validation for template creation.

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.

  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.

RCS Template Limitations
May 14, 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.



Channel Integration Status :- Click on Configure RCS.


Add Private RSP: Click on Add “Private RSP”


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

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.

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

Now get the WebEngage API Key (Auth Token)

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

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.




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


Step 2: Give Campaign name and select the Target Segment


Step 3 :  Save&Continue


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


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


Step 6:  Clcik on the “Launch Campaign” Button

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

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
Prev