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.