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