Revoca un mensaje del agente que se envió, pero aún no se entregó.
Si la plataforma de RCS para empresas revoca correctamente un mensaje, este se borra de la cola de mensajes del usuario y nunca se entrega (200 OK).
Una respuesta 404 Not Found significa que el intento de revocación falló porque se entregó el mensaje.
Existe una pequeña posibilidad de que el agente inicie una revocación mientras la plataforma de RCS for Business está en proceso de entregar el mensaje. En estos casos poco frecuentes, el agente recibe un evento de usuario DELIVERED para el mensaje poco después de iniciar la solicitud de revocación.
Solicitud HTTP
DELETE https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*/agentMessages/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
name |
"phones/{E.164}/agentMessages/{messageId}", donde {E.164} es el número de teléfono del usuario en formato E.164 y {messageId} es el ID asignado por el agente del mensaje del agente que se debe revocar. Por ejemplo, con el número de teléfono de EE.UU. +1-222-333-4444 y un mensaje del agente con el ID "12345xyz", el extremo resultante sería https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages/12345xyz. |
Parámetros de consulta
| Parámetros | |
|---|---|
agentId |
Obligatorio. Es el identificador único del agente. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.
Permisos de autorización
Requiere el siguiente permiso de OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para obtener más información, consulta OAuth 2.0 Overview.