Skip to main content
POST
Enviar RCS

Autorizações

Authorization
string
header
obrigatório

API Key no header Authorization. Exemplo: Authorization: Bearer sk_live_xxxxx

Cabeçalhos

Idempotency-Key
string

Chave única para evitar envio duplicado.

x-idempotency-key
string

Chave de idempotência (alternativa).

Corpo

application/json
to
string[]
obrigatório

Lista de números no formato E.164 (ex.: 5511999999999). Uma mensagem RCS por número; cada uma consome 60 créditos.

Required array length: 1 - 100 elements
payload
object
obrigatório

Conteúdo conforme messageType. BASIC: { message }. CARD: { message, cardImage, cardTitle, cardMessage, buttons? }. CAROUSEL: { message, cards } (cada card: cardImage, cardTitle, cardMessage, buttons?). FILE: { message, file, fileName } (file = URL pública).

type
enum<string>

Tipo da mensagem (canônico, minúsculo): basic (texto), card, carousel, file, ou template (workspace). Use messageType em MAIÚSCULO como alias de compatibilidade.

Opções disponíveis:
basic,
card,
carousel,
file,
template
messageType
enum<string>

Alias de compatibilidade para type. Prefer type em minúsculo para novos integradores.

Opções disponíveis:
BASIC,
CARD,
CAROUSEL,
FILE
schedule
object
refer
string

Referência opcional para correlação (ex.: ID do pedido).

options
object
metadata
object

Metadados em RcsLog.metadata (string→string).

Resposta

RCS aceito(s). Enfileirado(s) para envio imediato ou agendado.

success
boolean
obrigatório
Exemplo:

true

data
object
obrigatório