Method: phones.agentEvents.create

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

string

"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

string

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

string

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.