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 que ele está digitando, 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, não é possível revogar os eventos do agente 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 +1-222-333-4444, o valor seria "phones/+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. Ele precisa ser um UUID, conforme definido em https://tools.ietf.org/html/rfc4122 (em inglês). A plataforma RBM ignora todas as mensagens do agente enviadas com um ID usado por uma mensagem ou evento anterior enviado do 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 a Visão geral do OAuth 2.0.