Skip to main content

​
Por que este canal importa

RCS (Rich Communication Services) é o “SMS evoluído” em muitas redes: dá para mandar imagem, botões e carrossel quando o aparelho e a operadora suportam. Para o seu produto, significa mais conversão e menos texto seco — mantendo o destino como número de telefone, como no SMS.

​
O que você encontra no painel

  • API Keys e escopos — rcs:send, rcs:read, rcs:cancel (e o que mais o painel expuser para o workspace).
  • Cobrança — RCS consome mais créditos que um e-mail simples (ex.: 60 créditos por mensagem na tabela atual) ou saldo em Pague pelo uso; o painel ajuda a alinhar expectativa de custo.
  • Workspace ativo — plano suspenso ou expirado bloqueia envio (402), como nos outros canais.

​
O que você encontra na API

  • Destinatários — to como lista de 1 a 100 números em E.164; uma mensagem é criada por número.
  • Tipos de mensagem — BASIC (texto), CARD (imagem + título + botões), CAROUSEL (vários cards), FILE (arquivo por URL pública + nome).
  • Agendamento — schedule.sendAt em ISO 8601; resposta pode trazer status: "SCHEDULED".
  • Cancelamento — mensagens QUEUED ou SCHEDULED podem ser canceladas; depois de enviadas, não.
  • Idempotência — Idempotency-Key / x-idempotency-key no POST /v1/rcs/messages.
O provedor de conectividade (ex.: Comtele) fica por conta da infraestrutura Notifique; você integra só na API estável v1.

​
Payload por tipo (lembrete rápido)

  • BASIC: { "message": "Texto da mensagem" }
  • CARD: { "message": "...", "cardImage": "https://...", "cardTitle": "Título", "cardMessage": "Descrição", "buttons": [{ "text": "Botão", "url": "https://..." }] }
  • CAROUSEL: { "message": "...", "cards": [{ ... }, ...] }
  • FILE: { "message": "...", "file": "https://...", "fileName": "Documento.pdf" }

​
Limitação do mundo real

Nem todo número entrega RCS o tempo todo: depende de aparelho, operadora e região. Trate respostas FAILED e tenha fallback (SMS, WhatsApp, e-mail) quando o negócio exigir garantia de entrega.

​
Status possíveis

SCHEDULED e QUEUED (canceláveis em condições permitidas) → PROCESSING → SENT → DELIVERED ou FAILED; também CANCELLED.

​
Próximos passos

  • Quick Start — primeiro envio BASIC, consulta de status e cancelamento
  • API Reference (RCS) — na documentação publicada, abra a referência OpenAPI do canal para payloads CARD, CAROUSEL e FILE