Envia um evento do agente para um usuário.
Os eventos do agente podem ser usados para indicar que ele leu uma mensagem do usuário ou que está digitando (o que adiciona um elemento humano à experiência do RCS for Business). Se o RCS for Business não conseguir entrar em contato com o usuário, a plataforma vai 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 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. Precisa ser um UUID, conforme definido em https://tools.ietf.org/html/rfc4122. A plataforma RCS for Business ignora qualquer mensagem do agente enviada com um ID usado por uma mensagem ou evento anterior 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.