twilio-rcs-messaging

Imported from openai/plugins (plugins/twilio-developer-kit/skills/twilio-rcs-messaging/SKILL.md). Install upstream with npx skills add openai/plugins --skill twilio-rcs-messaging. Copyright stays with the author.

Overview

RCS (Rich Communication Services) Business Messaging delivers branded, rich messages natively in the phone's default messaging app — no separate app needed. Messages show your brand logo, colors, and verified sender name. Supports rich cards, carousels, suggested actions, and media.

RCS uses the same messages.create() API as SMS and WhatsApp. For the full channel comparison and onboarding sequence, see twilio-messaging-overview.

Device Support

Regional Availability

RCS availability depends on carrier approval per country. See RCS regional availability for the current list. US carriers (T-Mobile, AT&T, Verizon) are supported. Global support is expanding.

Prerequisites

• Twilio paid account — free trials cannot use RCS
• Messaging Service (RCS senders must be added to a Messaging Service)
• Environment variables: TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN — See twilio-iam-auth-setup for credential setup
• SDK: pip install twilio / npm install twilio

Compliance Onboarding (US)

RCS onboarding takes 4-6 weeks minimum. A Twilio onboarding specialist reviews everything before carrier submission. You won't be charged until you go live.

Part 1: Sender Profile Setup

Create your RCS Sender in Console with:

Part 2: Privacy Policy & Terms of Service

• Privacy policy URL — must be publicly accessible
• Terms of Service URL — must be publicly accessible
• Both must cover SMS/RCS messaging, data handling, opt-out process
• The privacy policy must state that information will be shared with third parties for the purpose of transmitting RCS messages
• Some countries require local-language versions

For US-specific compliance details, see the RCS Compliance Onboarding Guide.

Part 3: Eligibility & Acceptable Use

US carriers require:

• Legal business name matching EIN records
• EIN (Employer Identification Number)
• Business must not be on restricted industries list (cannabis, firearms, etc.)
• CTIA Messaging Principles and Best Practices handbook compliance

Part 4: Campaign Details

• Use case category (transactional, promotional, OTP, mixed)
• Traffic volume estimates
• Campaign description with specific messaging scenarios
• For recurring messages: frequency, content types

Part 5: Opt-In & Consent

• Describe how users opt in to receive RCS messages
• Must show explicit consent collection mechanism
• Opt-in must be specific to RCS/messaging (not buried in general ToS)
• HELP and STOP keyword handling required

Part 6: Sample Messages

• 2+ sample messages that match your declared use case
• Must include opt-out language
• Must reflect actual message content (not generic)

Part 7: Common Rejection Reasons

Registration Flow

1. Create RCS Sender in Console → complete all 7 parts above
2. Test Phase — Add test devices, send and receive messages without carrier approval. Non-test devices get SMS fallback.
3. Compliance Submission — Twilio specialist reviews, then submits to Google + carriers:
   • Google registration: authorized rep details, opt-in/opt-out policy, use case video, interaction flow
   • US registration (additional): legal business name + EIN, traffic metrics, CTIA compliance, HELP/STOP examples
4. Carrier approval — Per-carrier, per-country. First carrier approval = you can go live in that country.
5. Go live — Add RCS Sender to your Messaging Service. Start sending.

Sending RCS Messages

RCS uses the same messages.create() API. No address prefix needed — Twilio routes based on the sender type.

Python

import os
from twilio.rest import Client

client = Client(os.environ["TWILIO_ACCOUNT_SID"], os.environ["TWILIO_AUTH_TOKEN"])

message = client.messages.create(
    messaging_service_sid="MGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    to="+15558675310",
    body="Your order has shipped! Track it here: https://example.com/track/12345"
)
print(message.sid, message.status)

Node.js

const twilio = require("twilio");
const client = twilio(process.env.TWILIO_ACCOUNT_SID, process.env.TWILIO_AUTH_TOKEN);

const message = await client.messages.create({
    messagingServiceSid: "MGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    to: "+15558675310",
    body: "Your order has shipped! Track it here: https://example.com/track/12345",
});
console.log(message.sid, message.status);

Rich Cards & Carousels

Use Content Templates for rich RCS messages (cards with images, titles, descriptions, and action buttons). Create templates via twilio-content-template-builder, then send with contentSid:

Python

message = client.messages.create(
    messaging_service_sid="MGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    to="+15558675310",
    content_sid="HXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    content_variables='{"1": "Order #12345", "2": "$49.99"}'
)

SMS Fallback

When a recipient's device doesn't support RCS Business Messaging, Twilio automatically falls back to SMS — no code changes needed. This is handled at the Messaging Service level.

• Fallback is automatic when the Messaging Service has both RCS sender and phone numbers
• If you send via messagingServiceSid, Twilio checks RCS capability first, then falls back to SMS
• Without Twilio's fallback: the message simply fails to deliver (no automatic retry to SMS)

Multiple RCS Senders

A single brand can have multiple RCS senders, but each must have a distinct use case (e.g., one for transactional, one for marketing). The use case must be clearly different — carriers reject duplicate-purpose senders for the same brand.

• Each sender has its own display name, logo, and campaign details
• All senders go through independent carrier approval
• Each sender can only belong to one Messaging Service

ISV Path

ISVs (Independent Software Vendors) registering RCS senders for client businesses:

• Can register on behalf of clients using the same compliance process
• Each client business needs its own RCS Sender with its own branding
• The ISV's Twilio account can host multiple RCS Senders
• Programmatic sender creation at scale is not supported — each sender must be created individually in Console

Common Errors

CANNOT

• Cannot use RCS on free trial accounts — Paid account required
• Cannot send RCS without a Messaging Service — RCS senders must be added to a Messaging Service
• Cannot add an RCS sender to multiple Messaging Services — Each sender belongs to one service only
• Cannot create RCS senders programmatically at scale — Console-only, one at a time
• Cannot skip carrier approval — Even with Google approval, each carrier must independently approve in each country
• Cannot guarantee RCS delivery to iOS — iOS 18 supports P2P RCS, but RCS Business Messaging support depends on Apple + carrier. Always have SMS fallback.
• Cannot control fallback behavior per-message — Fallback to SMS is automatic at the Messaging Service level when both RCS and SMS senders are present
• Cannot send RCS to landlines — Mobile-only channel
• Cannot use unique display names that match existing senders — Carriers enforce uniqueness globally
• Cannot update sender profile after approval without re-review — Profile changes trigger a new carrier review cycle

Next Steps

• Channel overview and onboarding guide: twilio-messaging-overview
• Create rich message templates: twilio-content-template-builder
• Set up Messaging Service for sender pool + fallback: twilio-messaging-services
• Compliance registration for other channels: twilio-compliance-onboarding
• Number and sender type selection: twilio-numbers-senders