Envía un evento del agente a un usuario.
Los eventos del agente se pueden usar para indicar que el agente leyó un mensaje del usuario o que está escribiendo (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 "phones/+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, asignado por el agente. Debe ser un UUID, como se define en https://tools.ietf.org/html/rfc4122. La plataforma de RBM ignora cualquier mensaje de agente enviado con un ID que se haya usado en 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 incluye 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 la Descripción general de OAuth 2.0.