Envía un evento del agente a un usuario.
Los eventos de agente se pueden usar para indicar que el agente leyó un mensaje del usuario o que está en proceso de escribir (lo que agrega un elemento humano a la experiencia de RBM). Si RBM no puede llegar al usuario, la plataforma de RBM muestra 404 NOT_FOUND
.
A diferencia de los mensajes del agente, los eventos del agente no se pueden revocar después del envío.
Solicitud HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
"phones/{E.164}", donde {E.164} es el número de teléfono del usuario en formato E.164. Por ejemplo, para un usuario con el número de teléfono de EE.UU. +1-222-333-4444, el valor sería teléfonos/+12223334444 y el extremo resultante sería https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents. |
Parámetros de consulta
Parámetros | |
---|---|
eventId |
El ID del evento que asigna el agente. Debe ser un UUID, como se define en https://tools.ietf.org/html/rfc4122. La plataforma de RBM ignora cualquier mensaje al agente enviado con un ID utilizado por un mensaje o evento anterior enviado desde el mismo agente. |
agentId |
Obligatorio. El identificador único del agente. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de AgentEvent
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de AgentEvent
.
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.