Skip to main content
RCS é o SMS turbinado: quando o aparelho e a operadora suportam, você manda imagem, botões e carrossel, ainda assim para um número de telefone.

​
O que é RCS na Notifique?

É o canal para mensagens ricas no celular (Rich Communication Services). O destino continua sendo um número internacional (E.164, sem +), como no SMS, mas o conteúdo pode ir além do texto puro. Você pode:
  • Enviar texto (BASIC), card com imagem e botões (CARD), carrossel (CAROUSEL) ou arquivo por URL (FILE)
  • Disparar para 1 a 100 números por chamada (uma mensagem por número)
  • Agendar envio para data e hora futuras
  • Consultar status de cada envio pelo id
  • Cancelar enquanto estiver na fila ou agendado
  • Rastrear cliques em link curto ou botão via webhook
Pense num panfleto digital no bolso: mais visual que SMS, mas só chega onde a rede RCS está disponível.
Diferente do WhatsApp, RCS não usa instância de canal. Basta API Key com os escopos certos e números em formato internacional (ex.: 5511999999999).

​
Quando usar?

Funciona muito bem para campanha com imagem e botões, aviso promocional e mais conversão que SMS puro, para quem recebe RCS. Para OTP que precisa chegar em qualquer celular, prefira SMS. Nem todo aparelho entrega RCS; tenha plano B (SMS, WhatsApp ou e-mail) quando a entrega precisar ser garantida.

​
Tipos de mensagem

  • BASIC, só texto
  • CARD, imagem, título, descrição e botões
  • CAROUSEL, vários cards na mesma mensagem
  • FILE, arquivo por URL pública + nome
Detalhe de campos por tipo: referência da API na aba RCS.

​
Como funciona na prática

  1. Crie uma API Key com rcs:send (e rcs:read / rcs:cancel se for consultar ou cancelar)
  2. Envie com POST /v1/rcs/messages, to em array, type e payload conforme o formato
  3. A plataforma enfileira, envia e atualiza o status; seu backend recebe avisos se configurou webhooks
Cada API Key pertence a um workspace. Na v1 não envie x-workspace-id.

​
Ciclo da mensagem

Depois do envio, o RCS passa por status como QUEUED, SCHEDULED, PROCESSING, SENT, DELIVERED, CLICKED, FAILED ou CANCELLED. Cancelamento pela API funciona enquanto o status for QUEUED ou SCHEDULED. Com links curtos ativos, o primeiro clique em um link clicar.co do envio pode marcar CLICKED, webhook rcs.clicked.

​
O que dá para fazer

  • Enviar para 1 a 100 números por chamada (60 créditos por mensagem)
  • Agendar com schedule.sendAt
  • Consultar um envio pelo id retornado
  • Cancelar na fila ou agendado
  • Idempotência com header Idempotency-Key
  • Webhook por envio em options.webhook (só aquele lote)
Veja Cobrança. Detalhe de erros: referência da API na aba RCS.

​
Depois do primeiro envio

  • Acompanhe entrega, clique e falha por webhooks (rcs.sent, rcs.delivered, rcs.clicked, rcs.failed)
  • Trate FAILED com fallback para SMS ou outro canal quando a rede não entregar RCS
  • Teste no Sandbox com sk_test_... antes de produção

​
Próximos passos