Revoca un mensaje de agente que se haya enviado, pero que aún no se haya entregado.
Si la plataforma de RBM revoca correctamente un mensaje, este se borrará de la cola de mensajes del usuario y nunca se entregará.
Este método muestra inmediatamente 200 OK, ya sea que el mensaje se haya revocado correctamente o no.
Existe una pequeña posibilidad de que el agente inicie una revocación mientras la plataforma de RBM está en proceso de entregar el mensaje. En estos casos poco frecuentes, el agente recibe un evento de usuario ENTREGADO 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. 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 está vacío.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/rcsbusinessmessaging
Para obtener más información, consulta la Descripción general de OAuth 2.0.