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 |
"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 |
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 |
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.