Envia uma mensagem do agente para um usuário.
O usuário precisa estar ativado e acessível pela plataforma RBM para que o agente envie uma mensagem. Quando a mensagem é enviada, a chamada é retornada sem erro. Caso contrário, o agente recebe um código de erro.
Se o usuário estiver on-line, a plataforma RBM entrega a mensagem imediatamente. Caso contrário, a plataforma RBM vai colocar a mensagem na fila e entregá-la na próxima vez que o usuário ficar on-line.
A plataforma RBM ignora todas as mensagens do agente enviadas com um ID usado por uma mensagem ou evento anterior enviado do mesmo agente.
As mensagens do agente podem ser revogadas entre o momento de envio e de entrega.
Solicitação HTTP
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/agentMessages
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, 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/agentMessages. |
Parâmetros de consulta
Parâmetros | |
---|---|
messageId |
O ID exclusivo da mensagem, 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 AgentMessage
.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de AgentMessage
.
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.