Pular para conteúdo

Status e respostas

Ciclo da mensagem

accepted → sent → delivered → read

Status Significado
sent Entregue à rede RCS
delivered Chegou ao aparelho
read O cliente abriu a mensagem
failed Não foi entregue e não virou SMS (fallback: false); o valor é devolvido
fallback_sms Foi enviada como SMS; sms_id é o SMS que a substituiu

Consulte a qualquer momento com GET /rcs/{id}, que traz também delivered_at e read_at.

Webhooks

Os eventos usam o mesmo formato, cabeçalhos e assinatura dos webhooks de SMS.

rcs.status

Enviado a cada mudança de status.

{
  "event": "rcs.status",
  "occurred_at": "2026-10-06T14:05:12Z",
  "customer_id": 42,
  "customer_ref": null,
  "id": "5f0c2b1e-9a7d-4c1e-8f43-2b6a1d0e7c55",
  "to": "5511999990000",
  "status": "read",
  "error": null,
  "sms_id": null
}

Quando o status é fallback_sms, o andamento do SMS que substituiu a mensagem chega pelo evento message.status, com o id de sms_id.

Respostas e toques

O evento rcs.received chega quando o cliente digita uma resposta ou toca em um botão do tipo reply.

{
  "event": "rcs.received",
  "occurred_at": "2026-10-06T14:06:40Z",
  "customer_id": 42,
  "customer_ref": null,
  "id": "rmo_1",
  "agent_id": 3,
  "from": "5511999990000",
  "text": "Confirmar",
  "postback": "confirmar_123",
  "in_reply_to": "5f0c2b1e-9a7d-4c1e-8f43-2b6a1d0e7c55"
}
Campo Conteúdo
text O que o cliente digitou, ou o texto do botão tocado
postback O valor que você definiu no botão; null quando foi texto digitado
in_reply_to A última mensagem RCS enviada a esse cliente nos últimos 30 dias

Use o postback para identificar a ação sem depender do texto do botão: confirmar_123 diz o que fazer e com qual registro.