Method: phones.agentMessages.delete

Revoca un mensaje de agente que se envió, pero que aún no se entregó.

Si la plataforma de RBM revoca correctamente un mensaje, este se borra de la cola de mensajes del usuario y nunca se entrega.

Este método devuelve inmediatamente 200 OK, independientemente de si el mensaje se revocó 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 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

string

"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 de 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

string

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 es un objeto JSON 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 OAuth 2.0 Overview.