Register an RCS agent

An RCS agent is the branded sender your recipients see. Registering one starts from the Dashboard; SignalWire then provisions the agent for testing and handles the launch with mobile operators.

Prerequisites

Have the details listed under Prerequisites ready, including image URLs for your logo and banner and the phone numbers of your test devices.

Fees

Setting up and testing an agent carries no registration fees. Messages sent during testing are billed at standard RCS messaging rates.

Annual vetting fees apply once your agent is ready to launch for production use. Resubmitting the registration or updating brand assets incurs additional fees. Fees are subject to change; see SignalWire messaging pricing for current rates.

Submit the registration

Open the registration form

In your SignalWire Dashboard, go to Messaging Campaigns → RCS Agents and select Add New.

The RCS Agents menu item appears only once RCS agent registration is enabled for your Space. If you don’t see it, contact Support to have it enabled.

Fill in the form

The form has these sections, in this order:

Section	What it asks for
Organization	Your organization’s name and legal entity name, and whether you’re registering on behalf of another brand.
Contact	The name, title, email address, and phone number of the person to contact about the registration.
Branding Information	The brand name, description, color, logo, and banner shown on the recipient’s device, and your privacy policy and terms and conditions URLs.
Contact Methods	At least one phone number, email address, or website shown on the agent so recipients can reach you, each with an optional label.
Messaging Setup	The phone numbers of your RCS test devices, and optionally an SMS Sender ID and a callback or webhook URL.
Sender Agent Use	The billing category and the agent’s use case.
Launch Details	How you obtain user opt-in, what triggers your messages, the interactions you expect, and your opt-out confirmation message. Mobile operators review these answers before approving the agent for launch.
Agent Preview	How a reviewer can try the experience: a tester opt-in URL, an opt-out video URL, or a screenshots URL.
Launch Countries	Where the agent launches, and other countries where you’d like RCS.

A preview beside the form shows how your agent appears on a device as you fill it in.

Under Launch Countries, the United States is always selected: RCS messaging is available only to US phone numbers for now. The countries you pick under Other Geographic Areas of Interest are saved with your registration to tell us where you’d like RCS next. The agent doesn’t launch there.

Submit

Confirm that you’re authorized to register the agent on behalf of your organization, then select Register. The agent’s page opens with the status pending, and the agent is listed under RCS Agents.

Test the agent

When SignalWire has provisioned your agent for testing, its status changes to in_review and the agent’s page shows its Agent ID. Until the agent is launched, it can send messages only to the test device numbers registered on it.

Send a message with the Agent ID as from and one of your test numbers as to, and confirm it arrives on that device with your branding. If the API returns rcs_agent_not_sendable, the agent isn’t in in_review, launching, or launched. If it returns rcs_agent_not_configured, the agent hasn’t finished provisioning for testing.

Launch the agent

After testing, SignalWire applies to the mobile operators in the United States and the agent’s status becomes launching. Once the operators approve it, the status becomes launched and the agent can message any US subscriber on those networks.

Agent statuses

Status	Meaning	Can send
`pending`	The registration was submitted and is waiting to be provisioned.	No
`in_review`	The agent is provisioned for testing.	To test devices only
`launching`	SignalWire is applying to mobile operators in the United States.	To test devices only
`launched`	Mobile operators approved the agent.	To any US subscriber on those networks
`rejected`	The registration was not approved.	No
`suspended`	The agent was suspended.	No

Next steps

Send RCS messages

Send plain text and rich content from your agent.

Receive RCS messages

Assign your agent to a Resource to handle inbound messages.