Revogação de mensagens RCS
Ao enviar uma mensagem RCS por meio da Messages API do Vonage, é possível solicitar posteriormente que essa mensagem seja revogada (ou seja, que não seja entregue no dispositivo do destinatário pela rede de destino).
A revogação de mensagens RCS é iniciada por um PATCH solicitação ao endpoint da Messages API com o objeto de mensagem que foi criado pela solicitação inicial POST solicitação para enviar a mensagem. O objeto da mensagem é identificado por seu UUID (que é retornado na resposta à POST solicitação que cria o objeto de mensagem).
O PATCH A solicitação deve conter um JSON corpo que define o valor de status para `revogado.
Você pode ver mais detalhes sobre a Messages API PATCH ponto final no Especificação da Messages API e veja um exemplo de código para o PATCH solicitação no Trechos de código da Messages API
Escolhendo o terminal certo
Para enviar uma solicitação de revogação de mensagem RCS ao Messages API PATCH ponto final, você precisará usar o correto servidor com localização geográfica para a solicitação. Isso dependerá do país em que o RCS Agent foi iniciado. Consulte a tabela abaixo como orientação para saber qual servidor utilizar.
| Região | Servidor | Exemplos de países |
|---|---|---|
| EMEA (Europa, Oriente Médio e África) | api-eu.nexmo.com |
França, Espanha, Portugal, África do Sul, Nigéria, Noruega, Suécia, Países Baixos, Áustria, Alemanha, Reino Unido, Itália |
| NA + LATAM (América do Norte e América do Sul) | api-us.nexmo.com |
México, Brasil, Canadá |
| APAC (Ásia-Pacífico) | api-ap.nexmo.com |
Pontos a serem observados
- A apresentação de uma solicitação de revogação não garante que uma mensagem será revogada (ou seja, que não será entregue). Por exemplo, a mensagem pode já ter sido entregue ou pode não ser possível revogá-la por outros motivos.
- Um pedido de revogação só pode ser feito dentro de 24 horas após a criação do objeto da mensagem original.