Method: phones.dialogflowMessages.create

Solicita que um agente do Dialogflow envie mensagens por um agente do RCS for Business.

Se a integração do Dialogflow não estiver ativada para um agente do RCS for Business, esse método vai retornar 403 PERMISSION_DENIED.

Quando um agente do RCS for Business é integrado a um agente do Dialogflow, esse método aciona um evento no agente do Dialogflow. A plataforma RCS para empresas encaminha as respostas do Dialogflow para o dispositivo do usuário e as mensagens do usuário de volta para o agente do Dialogflow.

Se uma intent do Dialogflow definir várias respostas, a plataforma RCS for Business enviará aos usuários uma mensagem por resposta definida.

Se você entrar em contato com um webhook usando o fulfillment do Dialogflow, a solicitação de fulfillment vai incluir as seguintes informações no payload:

Campo Descrição

rbm_user_phone_number

O número de telefone do usuário.

rbm_share_location_response

A localização do usuário, se ele tocou na ação sugerida "Compartilhar local".

Solicitação HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/dialogflowMessages

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

Parâmetros de consulta

Parâmetros
messageIdPrefix

string

Um prefixo exclusivo de IDs de mensagens do RCS for Business que resultam do evento do Dialogflow. O Dialogflow é compatível com várias respostas para um determinado evento. Se um evento acionar várias respostas, o RCS Business Messaging vai encaminhar cada uma delas como uma mensagem separada. Cada ID de mensagem compartilha o mesmo prefixo.

agentId

string

Obrigatório. O identificador exclusivo do agente.

Corpo da solicitação

O corpo da solicitação contém uma instância de DialogflowEvent.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de DialogflowEvent.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Para mais informações, consulte OAuth 2.0 Overview.