Revocación de mensajes RCS
Al enviar un mensaje RCS a través de Messages API de Vonage, puedes solicitar posteriormente que ese mensaje sea revocado (es decir, que la red descendente no lo entregue al dispositivo del destinatario).
La revocación de un mensaje RCS se inicia mediante un PATCH al punto final de la Messages API en el objeto de mensaje creado por la solicitud inicial POST para enviar el mensaje. El objeto mensaje se identifica por su UUID (que se devuelve en la respuesta a la petición POST que crean el objeto de mensaje).
En PATCH debe contener un JSON que establece el valor de status a `revocado.
Puede consultar más detalles sobre la Messages API PATCH en el Especificación de la API de Messages y ver un ejemplo de código para el PATCH solicitud en el Fragmentos de código de la API de Messages
Elegir el punto final adecuado
Para enviar una solicitud de Revocación de Mensaje RCS al Messages API PATCH punto finaltendrá que utilizar el servidor geolocalizado para la solicitud. Esto dependerá del país en el que el Agente RCS ha sido lanzado. Por favor, consulte la siguiente tabla como guía para saber qué servidor utilizar.
| Región | Servidor | Ejemplos de países |
|---|---|---|
| EMEA (Europa, Oriente Medio y África) | api-eu.nexmo.com | Francia, España, Portugal, Sudáfrica, Nigeria, Noruega, Suecia, Países Bajos, Austria, Alemania, Reino Unido, Italia |
| NA + LATAM (Norteamérica y Sudamérica) | api-us.nexmo.com | México, Brasil, Canadá |
| APAC (Asia-Pacífico) | api-ap.nexmo.com |
Aspectos a tener en cuenta
- Realizar una solicitud de revocación no garantiza que un mensaje vaya a ser revocado (es decir, no entregado). Por ejemplo, puede que el mensaje ya se haya entregado o que no sea posible revocarlo.
- Una solicitud de revocación sólo puede producirse en las 24 horas siguientes a la creación del objeto de mensaje original.