Method: phones.agentMessages.create

Envia uma mensagem do agente para um usuário.

O usuário precisa estar com o RCS ativado e acessível pela plataforma RCS for Business para que o agente envie uma mensagem. Caso contrário, o agente vai receber um código de 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 for Business coloca a mensagem em uma fila e a entrega quando o usuário estiver on-line novamente.

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.

As mensagens do representante 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

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 phones/+12223334444, e o endpoint resultante seria https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/agentMessages.

Parâmetros de consulta

Parâmetros
messageId

string

Obrigatório. O ID exclusivo da mensagem, 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

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 OAuth 2.0 Overview.