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 500 números por chamada (uma mensagem por número)
  • Usar agentes branded via instâncias RCS — logo, nome e remetente da sua marca
  • Agendar envio para data e hora futuras
  • Consultar status de cada envio pelo id
  • Receber respostas (MO) e vinculá-las ao envio original
  • 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.

​
Remetente: compartilhado ou instância

No envio, passe from para usar um agente específico. Se omitir, a plataforma usa a instância padrão do workspace (se ACTIVE) ou o remetente compartilhado.
Criar e provisionar instâncias: guia Instâncias RCS. Listar agentes: GET /v1/rcs/instances.

​
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 (payload.message)
  • CARD — imagem, título, descrição e botões (cardImage, cardTitle, cardMessage, buttons)
  • CAROUSEL — vários cards na mesma mensagem (payload.cards[])
  • FILE — arquivo por URL pública + nome (file, fileName, message)
Em CARD e CAROUSEL, o campo payload.message não é exibido ao destinatário. Use cardMessage em cada card para o texto descritivo.
Detalhe de campos e exemplos: referência da API na aba RCS (playground com exemplos de texto, card, carrossel com 3 cards, arquivo e template).

​
Como funciona na prática

  1. Crie uma API Key com rcs:send (e rcs:read / rcs:cancel se for consultar ou cancelar)
  2. (Opcional) Provisione um agente RCS e aguarde status ACTIVE
  3. Envie com POST /v1/rcs/messages, to em array, type, payload e from (id ou nome do agente) quando aplicável
  4. 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, READ, CLICKED, RESPONDED, FAILED ou CANCELLED. Cancelamento pela API funciona enquanto o status for QUEUED ou SCHEDULED.
O POST /v1/rcs/messages responde 202 com messageIds e status — não repete o payload. Para saber o que foi enviado, use GET /v1/rcs/messages/:id ou GET /v1/rcs/messages (cada item traz payload, messageType e refer).
Com links curtos ativos, o primeiro clique em um link clicar.co do envio pode marcar CLICKED, webhook rcs.clicked.

​
Respostas recebidas (inbound)

Consulte mensagens MO com GET /v1/rcs/inbound. Quando o cliente responde a um envio seu, o inbound pode trazer relatedRcsLogId e, no detalhe, o objeto relatedRcsLog com o mesmo nível de informação de GET /v1/rcs/messages/:id (status, payload, messageType e timestamps).

​
O que dá para fazer

  • Enviar para 1 a 500 números por chamada (140 créditos BASIC; 200 CARD/CAROUSEL/FILE)
  • Agendar com schedule.sendAt
  • Consultar um envio pelo id retornado
  • Listar histórico com filtros de status, destino e data
  • 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.

​
Localização e variáveis

  • localization e i18n traduzem o conteúdo do card/texto RCS por idioma do contato.
  • A resposta 202 pode incluir data.localization.
Guia completo: Localização e i18n.

​
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