Skip to main content
POST
Enviar mensaje RCS

Autorizaciones

Authorization
string
header
requerido

Clave API sin autorización de encabezado. Ejemplo: Authorization: Bearer sk_live_xxxxx

Encabezados

Idempotency-Key
string

Clave única para evitar envíos duplicados.

x-idempotency-key
string

Clave de idempotencia (alternativa).

Cuerpo

application/json
to
string[]
requerido

Lista de números en formato E.164 (ej.: 5511999999999). Un mensaje RCS por número; cada uno consume 60 créditos.

Required array length: 1 - 100 elements
payload
object
requerido

Conteúdo conforme messageType. BÁSICO: {mensaje}. TARJETA: { mensaje, imagen de tarjeta, título de tarjeta, mensaje de tarjeta, botones? }. CARRUSEL: { mensaje, tarjetas } (tarjeta cada: cardImage, cardTitle, cardMessage, botones?). ARCHIVO: { mensaje, archivo, nombre de archivo } (archivo = URL pública).

type
enum<string>

Tipo de mensaje (canónico, minúsculas): básico (texto), tarjeta, carrusel, archivo o template (workspace). Utilice messageType en MAYÚSCULAS como alias de compatibilidad.

Opciones disponibles:
basic,
card,
carousel,
file,
template
messageType
enum<string>

Alias ​​de compatibilidad para type. Prefiera minúsculas type para nuevos integradores.

Opciones disponibles:
BASIC,
CARD,
CAROUSEL,
FILE
schedule
object
refer
string

Referencia opcional para correlación (por ejemplo, ID de pedido).

options
object
metadata
object

Metadatos en RcsLog.metadata (cadena→cadena).

Respuesta

RCS aceptado. En cola para envío inmediato o programado.

success
boolean
requerido
Ejemplo:

true

data
object
requerido