Envia uma mensagem do agente para um usuário.
O usuário precisa ter o RCS ativado e estar acessível pela plataforma RCS for Business para que o agente envie uma mensagem. Caso contrário, o agente vai receber um código do erro 404.
Se o usuário estiver on-line, a plataforma RCS for Business vai entregar a mensagem imediatamente. Caso contrário, a plataforma RCS para empresas coloca a mensagem em fila e a entrega quando o usuário estiver on-line novamente.
A plataforma do RCS for Business ignora qualquer mensagem de agente enviada com um ID que foi usado por uma mensagem ou evento anterior enviado pelo mesmo agente.
As mensagens do agente podem ser revogadas entre o momento em que são enviadas e o momento em que são entregues.
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 phones/+12223334444, e o endpoint resultante seria https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages. |
Parâmetros de consulta
| Parâmetros | |
|---|---|
messageId |
Obrigatório. O ID exclusivo da mensagem, atribuído pelo agente. Precisa ser um UUID, conforme definido em https://www.rfc-editor.org/info/rfc9562. A plataforma do RCS for Business ignora qualquer mensagem de agente enviada com um ID que foi 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 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 OAuth 2.0 Overview.