Method: phones.agentEvents.create

Envia um evento do agente para um usuário.

Os eventos do agente podem ser usados para indicar que o agente leu uma mensagem do usuário ou está em processo de digitação, o que adiciona um elemento humano à experiência do RBM. Se o RBM não conseguir alcançar o usuário, a plataforma retornará 404 NOT_FOUND.

Ao contrário das mensagens do agente, os eventos do agente não podem ser revogados após o envio.

Solicitação HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentEvents

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

"phones/{E.164}", em que {E.164} é o número de telefone do usuário no formato E.164. Por exemplo, para um usuário com o número de telefone dos EUA +1-222-333-4444, o valor seria phone/+12223334444, e o endpoint resultante seria https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentEvents.

Parâmetros de consulta

Parâmetros
eventId

string

O ID do evento, atribuído pelo agente. Precisa ser um UUID, conforme definido em https://tools.ietf.org/html/rfc4122 (em inglês). A plataforma de RBM ignora qualquer mensagem de agente enviada com um ID usado por uma mensagem anterior ou um evento enviado pelo mesmo agente.

agentId

string

Obrigatório. O identificador exclusivo do agente.

Corpo da solicitação

O corpo da solicitação contém uma instância de AgentEvent.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de AgentEvent.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Para mais informações, consulte OAuth 2.0 Overview.