RCS
Send branded, verified RCS messages with rich cards, carousels and buttons from your own RCS agent, with SMS fallback for phones without RCS.
RCS (Rich Communication Services) is the upgrade to SMS built into Google Messages and, from iOS 18, iPhone Messages. Instead of a phone number, your messages come from a verified business profile: your name, logo, banner and a verified tick, with rich cards, swipeable carousels, tappable buttons and read receipts. Phones that cannot receive RCS can get the same message as plain SMS from one of your numbers.
RCS is available on every plan that includes the inbox. Accounts without it get 403.
Quick reference
| Property | Value |
|---|---|
| Sender | Your RCS agent: name, logo, banner, colour and a verified tick |
| Message types | Text, media, rich card, carousel, plus up to 11 buttons |
| Buttons | Reply, open URL, dial, view location, share location, add to calendar |
| Replies | Thread into the inbox as platform rcs; message.received webhook |
| Receipts | message.delivered, message.read and message.failed |
| Fallback | Plain SMS from one of your SMS-enabled numbers |
| Idempotency | Idempotency-Key header |
Brand and agent
Two things get approved by the carriers:
- Brand: the legal company behind the messages (legal name, tax ID, address, a contact at the business). One brand can back several agents.
- Agent: the sender people see in their messaging app (display name, description, logo, banner, colour, contact buttons). Every agent belongs to one profile and gets its own inbox account once it exists with the carriers.
You create both in one call and we review the details before anything is filed, so nothing is charged until a correct request is submitted.
Countries and carriers
The launch market is the country of the brand's address.
| Country | Carriers |
|---|---|
| United States | Verizon, T-Mobile, AT&T, US Cellular, Dish Wireless, C-Spire, Google Fi, Spectrum, Tracfone |
| United Kingdom | EE/BT, Sky, Virgin Mobile (O2), Lycamobile, Three, Vodafone |
| Austria | A1, Three, T-Mobile Austria |
| Bangladesh | Robi |
| Brazil | Claro, TIM, Vivo |
| DR Congo | Orange |
| France | Bouygues, Coriolis, Free Mobile, Lycamobile, NRJ, Orange, SFR |
| Germany | Telekom, O2 (Telefonica), Vodafone, 1&1 |
| India | Vodafone Idea, Airtel, BSNL, Reliance Jio |
| Italy | Iliad, TIM, Wind, Vodafone |
| Mexico | Altan, AT&T, Movistar, Telcel |
| Netherlands | KPN, Odido, Vodafone |
| Nigeria | 9mobile, Airtel, Glo, MTN |
| Norway | Telia, Telenor |
| Portugal | MEO, NOS, Vodafone |
| Singapore | M1, Simba, Singtel, StarHub |
| South Africa | Cell C, Telkom, Vodacom |
| Spain | Digi, Orange, Telefonica, Vodafone, MasMovil |
| Sweden | Telia, Tele2, Telenor |
Spain is accepted but launches there are paused by the carriers while a new sender regulation is clarified. We file Spanish agents as soon as they reopen.
Lifecycle and timing
Every agent moves through these statuses, and each change fires the rcs.agent.status_updated webhook.
- United States:
requested(our review) →brand_vetting→agent_review→testing(you try it on your own phones) →launch_review(our review of the launch details) →launching(carrier review) →live. Carrier review usually takes 4 to 6 weeks. - Other markets:
requested(our review) →brand_vetting(filed with the carriers by our team) →launching→live. You send the launch details together with the request.
Side exits: changes_requested (we need something fixed), rejected and deactivated.
Pricing
| United States | Other markets | |
|---|---|---|
| Setup, when we submit the agent | $150 | $150 |
| On carrier approval | $750 | None |
| Monthly, from the day it goes live | $160 | $75 |
| Messages, sent and received | Carrier cost x1.5 | Carrier cost x1.5 |
Monthly billing is month to month and never runs while the agent is in review. RCS requires usage-based billing and a card on file.
In this section
Registering an agent
Create the brand and agent, test on your phones and launch
Sending
Text, media, rich cards, carousels, buttons and SMS fallback
Receiving
Replies, button taps, locations, files and read receipts
Related
- SMS: the fallback channel and its US carrier registration.
- Inbox webhooks:
message.received,message.delivered,message.readandmessage.failed. - Idempotency and error handling.
Media & Limits
WhatsApp media formats and size limits, what the API does not expose, and the Meta error codes you will meet, each with its fix.
Registering an agent
Create an RCS brand and agent with POST /v1/rcs/agents, answer our review, test on your own phones and send the launch details to the carriers.