For the complete documentation index, see llms.txt. This page is also available as Markdown.

How to Create and Send an RCS Message in a One-on-One Conversation

Once your RCS channel is active, you can start individual conversations just like you would on WhatsApp. This article walks you through opening a chat and building each type of RCS message.

Step 1: Open the Conversation

  1. Go to Chats.

  2. Click New, then select New Chat.

  3. Enter the customer's phone number, including the country code (for example, +91 for India).

  4. Under Send message via, select your RCS channel. If another channel is already selected, click Change and choose RCS.

  5. Click Start Chat.

The conversation opens exactly like a WhatsApp chat.


Step 2: Choose Your Message Type

Inside the conversation, click the Attachment (paperclip) icon to choose the type of content you'd like to send. RCS supports three message types.

Rich Card

A Rich Card combines media, text, and interactive buttons into a single card. Best for highlighting one product, offer, or announcement with a clear call-to-action button.

Each Rich Card includes:

  • Optional image, video, or PDF

  • Card orientation (Vertical or Horizontal)

  • Title (up to 200 characters)

  • Description (up to 2000 characters)

  • Up to 4 buttons

Media limits: images up to 5 MB (JPEG/PNG), videos up to 16 MB (MP4), and PDFs up to 100 MB.

Carousel

A Carousel displays multiple Rich Cards that customers can swipe through. Best for showcasing several products or options that customers can browse.

When building a Carousel, you can:

  • Choose Small or Medium card width

  • Add 2 to 10 cards

  • Configure each card with optional media, a title, a description.

  • Title (up to 200 characters)

  • Description (up to 2000 characters)

  • Up to 4 buttons

Media limits: images up to 5 MB (JPEG/PNG), videos up to 16 MB (MP4), and PDFs up to 100 MB.


Rich Cards and Carousel cards support several interactive button types. Each one gives your customer a different way to respond or take action.

  • Quick Reply — The customer taps to send a predefined reply. Required: Button Label (maximum 25 characters).

  • Open URL — Opens a website. Required: Button Label, Destination URL. Optional: Open inside WebView.

  • Dial Number — Starts a phone call. Required: Button Label, Phone Number.

  • View Location — Opens a map showing a predefined location. Required: Button Label, Latitude, Longitude.

  • Request Location — Prompts the customer to share their live location. No additional fields required.

  • Calendar Event — Lets the customer save an event to their phone's calendar. Required: Button Label, Event Title, Start Date & Time, End Date & Time. Optional: Event Description.


Step 4: Send the Message

Once your message is ready, send it just like any other chat message.

Note: RCS only works on Android devices with RCS enabled. If the recipient is using an iPhone or has RCS disabled, the message cannot be delivered, and you'll see this error: "RCS is not supported on the recipient's device. This typically happens when the user is on an iPhone or has RCS disabled on their Android device."

Last updated