Method: phones.agentMessages.create

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

string

"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

string

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

string

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.