API RCS Business Messaging — Documentación y ejemplos

Arquitectura

Cómo funciona el RCS de SMS.es

🤖

Agente RCS

Cada marca tiene su propio Agente RCS en Google RCS Developer Console. El Agente define nombre de marca, logo y caso de uso: promocional, transaccional, OTP o multi-uso.

🔗

Business Messenger

Conecta tu Agente a SMS.es Business Messenger con Agent ID, Región y Webhook URL. La plataforma gestiona todo el enrutamiento con operadoras.

📡

Campaign API

Envía campañas RCS programáticamente vía la Campaign API REST. OAuth2, payloads JSON, webhooks y fallback SMS — todo en un lugar.

Paso a Paso

Configuración de tu Agente RCS

1

Crea una Marca y Agente en Google RCS Console

Accede a Google Business Communications Developer Console y crea una marca. Luego crea un Agente vinculado — elige Nombre, Región (permanente), Categoría de facturación y Caso de uso. El caso de uso no se puede cambiar tras enviar el Agente a lanzamiento.

→ Open Google RCS Console ↗

2

Añade Dispositivos de Prueba

Antes del lanzamiento, tu Agente solo puede enviar mensajes a dispositivos de prueba. En la Consola de Google ve a Dispositivos y añade números. Cada número recibe una invitación que debe aceptarse. RCS requiere Android con Google Mensajes, o iOS 18+.

3

Conecta el Agente a SMS.es Business Messenger

En SMS.es Business Messenger ve a Ajustes → Canales → RCS. Introduce Agent ID, Nombre y Región. Al guardar recibirás un Webhook URL y Client Token — pégalos en la Consola de Google en Integraciones de tu Agente → Configurar → Verificar.

4

Verifica y Lanza

Al terminar las pruebas, usa Verificación y luego Lanzamiento en el menú lateral de la Consola de Google. El lanzamiento es específico por operadora — tu Agente queda disponible públicamente tras la aprobación de cada operadora.

5

Configura el opt-in y empieza a enviar

Configura formularios de opt-in en Servicios Web → Formularios Web y reglas en Inbound Manager → RCS. Luego usa la Campaign API para programar y enviar tu primera campaña RCS.

Autenticación

OAuth2 — obtener tu token de acceso

Contacta con SMS.es para obtener tu client_id y client_secret. Luego canjéalos por un token de acceso (válido 7 días):

curl https://accounts.YOUR-PLATFORM-DOMAIN/oauth2/access-token   -d 'grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET'

# Response
{
  "access_token": "ACCESS_TOKEN",
  "token_type": "Bearer",
  "expires_in": 604800
}

El separador en el dominio puede ser un punto (.) o un guión (-). Pregunta a tu Account Manager de SMS.es por tu dominio exacto.

Campaign API

Envía tu primera campaña RCS

POST /services/{serviceUuid}/campaigns — cURL

curl -X POST   'https://api.YOUR-PLATFORM-DOMAIN/news/v1/services/SERVICE_UUID/campaigns'   -H 'accept: application/json'   -H 'Content-Type: application/json'   -H 'Authorization: Bearer ACCESS_TOKEN'   -d '{
    "name": "RCS Summer Sale",
    "status": "active",
    "sending_type": "rbm",
    "schedule_type": "once",
    "schedule_rrule": "2025-06-01 10:00:00",
    "template": "Hi @first_name, your exclusive offer is ready!",
    "sender": "YourBrandAgentName",
    "recipient_lists": "YOUR-LIST-UUID"
  }'

# sending_type "rbm" = RCS Business Messaging

Clone & personalise a campaign — cURL

curl -X POST   'https://api.YOUR-PLATFORM-DOMAIN/news/v1/services/SERVICE_UUID/campaigns'   -H 'Authorization: Bearer ACCESS_TOKEN'   -H 'Content-Type: application/json'   -d '{
    "clone_uuid": "EXISTING-CAMPAIGN-UUID",
    "template_vars": { "first_name": "María", "offer": "30% off" },
    "name": "Summer Sale — Segment B"
  }'

List active RCS campaigns — Node.js

const res = await fetch(
  `https://api.YOUR-PLATFORM/news/v1/services/${SERVICE_UUID}/campaigns?sending_type=rbm&status=active`,
  { headers: { 'Authorization': `Bearer ${accessToken}` } }
);
const { data, meta } = await res.json();
console.log(`${meta.pagination.total} active RCS campaigns`);

Campaign API — endpoints

Method	Endpoint	Acción
POST	/services/{uuid}/campaigns	Crear o clonar campaña
GET	/services/{uuid}/campaigns	Listar campañas
GET	/services/{uuid}/campaigns/{id}	Obtener campaña por UUID
PUT	/services/{uuid}/campaigns/{id}	Actualizar campaña
PATCH	/services/{uuid}/campaigns/{id}	Activar/pausar
DELETE	/services/{uuid}/campaigns/{id}	Eliminar campaña

Opt-in y Eventos

Gestión de consentimiento y eventos

Formularios de Opt-in

RCS requiere opt-in explícito. Crea formularios en Business Messenger en Servicios Web → Formularios Web. Las respuestas llegan a tu bandeja Easy Dialog.

Reglas de Opt-in

Define reglas de palabras clave en Inbound Manager → RCS. Sin reglas no se almacenan contactos. Configura una lista predeterminada en Ajustes → General para guardar todos los contactos RCS automáticamente.

Webhooks

Tu webhook URL (de la configuración del canal SMS.es) recibe eventos en tiempo real: entregado, leído y respuestas del usuario. Configúralo en la Consola de Google en Integraciones → Configurar.

Código QR

SMS.es genera un QR para tu Agente RCS (PNG o SVG). Escanearlo abre una conversación RCS. Para Agentes no lanzados, el QR solo funciona en dispositivos de prueba que hayan recibido al menos un mensaje.

Documentación

Guías oficiales para desarrolladores

Setup

API RCS — integra en minutos

Cómo funciona el RCS de SMS.es

Agente RCS

Business Messenger

Campaign API

Configuración de tu Agente RCS

Crea una Marca y Agente en Google RCS Console

Añade Dispositivos de Prueba

Conecta el Agente a SMS.es Business Messenger

Verifica y Lanza

Configura el opt-in y empieza a enviar

OAuth2 — obtener tu token de acceso

Envía tu primera campaña RCS

POST /services/{serviceUuid}/campaigns — cURL

Clone & personalise a campaign — cURL

List active RCS campaigns — Node.js

Campaign API — endpoints

Gestión de consentimiento y eventos

Formularios de Opt-in

Reglas de Opt-in

Webhooks

Código QR

Guías oficiales para desarrolladores

Configuración del Canal RCS

Campaign API v1.0

Conversation API

Obtén tu acceso a la API RCS