> For the complete documentation index, see [llms.txt](https://learn.doubletick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.doubletick.io/additonal-channels/rcs/how-to-send-an-rcs-message-in-a-one-on-one-conversation.md).

# How to send an RCS message in a one-on-one conversation

Learn how to open an RCS conversation and build a rich card, carousel, or text message for a one-on-one chat.

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

{% embed url="<https://youtu.be/nEeBX_m2cN8?si=D1ApjYwn-M-FJaXZ>" %}

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FpBO6VUtT5zgHJYGcAuZO%2FUntitled%20design%20-%202026-07-10T163038.101.gif?alt=media&#x26;token=d55d321b-cb5f-4157-a07c-cd07af805a2b" alt=""><figcaption></figcaption></figure>

**Step 1: Open the conversation**\
Go to **Chats**, click **New → New Chat**, and enter the customer’s phone number with the country code (for example, +91 for India). Under **Send message via**, select your **RCS channel**. If another channel is already selected, click **Change** and choose RCS. Then click **Start Chat**. The conversation will open just 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.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FknrtFDN8rg6sCkEoHGgU%2FUntitled%20design%20-%202026-07-10T165132.078.gif?alt=media&#x26;token=1b916694-2ac8-430e-a628-061ff172261b" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FhtIhBmcklAi92KGaZ8K7%2FUntitled%20design%20-%202026-07-10T163847.397.gif?alt=media&#x26;token=7a5acf9f-37df-4f95-bc33-772cc00429cc" alt=""><figcaption></figcaption></figure>

{% embed url="<https://youtu.be/InyLomZ1mT4?si=7H92ri7VmLjQ34I1>" %}

**Carousel**\
Displays multiple rich cards that customers can swipe through. Best for showcasing several products or options customers can browse.

* Choose small or medium card width
* Add 2 to 10 cards
* Configure each card with optional media, a title, and 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.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FDYhcJAzbQViX2iybZ0DY%2FUntitled%20design%20-%202026-07-10T165546.132.gif?alt=media&#x26;token=2ca75693-cf47-46c6-95d1-39995849a1d4" alt=""><figcaption></figcaption></figure>

**Step 3: Add buttons (rich card and carousel only)**

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.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FSheoHdV8xoFMGI4qdl5Y%2FUntitled%20design%20-%202026-07-10T164222.049.gif?alt=media&#x26;token=0d5aee25-eb4c-43a3-a591-427b2b9f2fdc" alt=""><figcaption></figcaption></figure>

**Step 4: Send the message**

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

{% hint style="warning" %}
RCS only works on Android devices with RCS enabled. If the recipient is using an iPhone or has RCS disabled, the message can't 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."
{% endhint %}

Want to reach a whole list at once instead? See how to broadcast an RCS message.

#### Key takeaways

* Start an RCS chat the same way you'd start a WhatsApp chat, selecting your RCS channel under Send message via.
* You can send a rich card or carousel, both with up to 4 interactive buttons.
* Rich cards and carousels follow the same media limits: images up to 5 MB, videos up to 16 MB, PDFs up to 100 MB.
* Messages can only be delivered to Android devices with RCS enabled.

#### Frequently asked questions

**How do I open an RCS conversation?**\
Go to Chats, click New → New Chat, enter the customer's number, select your RCS channel under Send message via, and click Start Chat.

**What message types can I send in a one-on-one RCS chat?**\
Rich cards and carousels, each with optional media, text, and up to 4 interactive buttons.

**How many buttons can a rich card have?**\
Up to 4, chosen from types like quick reply, open URL, dial number, view location, request location, and calendar event.

**What are the media limits for RCS messages?**\
Images up to 5 MB (JPEG/PNG), videos up to 16 MB (MP4), and PDFs up to 100 MB.

**Why isn't my RCS message delivering to a customer?**\
The recipient is likely on iPhone or has RCS disabled on their Android device — RCS only delivers to Android devices with RCS enabled.

#### **Suggested articles**

How to broadcast an RCS message\
Getting started with RCS on DoubleTick\
RCS vs WhatsApp Business API: which should you choose\
How to start a new chat with a customer\
RCS frequently asked questions


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.doubletick.io/additonal-channels/rcs/how-to-send-an-rcs-message-in-a-one-on-one-conversation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.