new_releases Atualizações: consulte as
notas da versão para ver os novos recursos e atualizações do produto.
Method: phones.dialogflowMessages.create
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Solicita um agente do Dialogflow para enviar mensagens por meio de um agente do RBM.
Se a integração do Dialogflow não estiver ativada para um agente do RBM, esse método retornará 403 PERMISSION_DENIED.
Quando um agente do RBM é integrado a um agente do Dialogflow, esse método aciona um evento no agente do Dialogflow. Ela encaminha as respostas do Dialogflow para o dispositivo e as mensagens do usuário de volta para o agente do Dialogflow.
Se uma intent do Dialogflow definir várias respostas, a plataforma RBM enviará aos usuários uma mensagem por resposta definida.
Se você entrar em contato com um webhook com 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
| O local do usuário, se ele tocar na ação sugerida de compartilhamento de 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 dos IDs das mensagens do RBM resultantes do evento do Dialogflow. O Dialogflow oferece suporte a várias respostas para um determinado evento. Se um evento acionar várias respostas, o RBM vai encaminhar cada resposta 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.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThis API method allows a Dialogflow agent to send messages through an RBM agent, requiring Dialogflow integration to be enabled for the RBM agent.\u003c/p\u003e\n"],["\u003cp\u003eWhen triggered, this method initiates an event in the integrated Dialogflow agent, routing responses from Dialogflow to the user and messages from the user back to Dialogflow.\u003c/p\u003e\n"],["\u003cp\u003eIf a Dialogflow intent has multiple responses, the RBM platform will send each response as a separate message to the user.\u003c/p\u003e\n"],["\u003cp\u003eWebhook fulfillment requests from Dialogflow will include the user's phone number and, if provided, their shared location in the payload.\u003c/p\u003e\n"],["\u003cp\u003eThe API request requires specific parameters, including the user's phone number in E.164 format and a unique prefix for RBM message IDs, and requires the \u003ccode\u003ehttps://www.googleapis.com/auth/rcsbusinessmessaging\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: phones.dialogflowMessages.create\n\nPrompts a [Dialogflow](https://dialogflow.com) agent to send messages through an RBM agent.\n\nIf Dialogflow integration isn't enabled for an RBM agent, this method returns `403 PERMISSION_DENIED`.\n\nWhen an RBM agent is integrated with a Dialogflow agent, this method triggers an [event](https://dialogflow.com/docs/events) in the Dialogflow agent. The RBM Platform routes responses from Dialogflow to the user's device and routes messages from the user back to the Dialogflow agent.\n\nIf a Dialogflow [intent](https://dialogflow.com/docs/intents) defines multiple responses, the RBM Platform sends users one message per defined response.\n\nIf you contact a webhook with Dialogflow [fulfillment](https://dialogflow.com/docs/fulfillment), the fulfillment request includes the following information in the payload:\n\n\u003cbr /\u003e\n\n| Field | Description |\n|---------------------------------------------|--------------------------------------------------------------------------|\n| \u003cbr /\u003e `rbm_user_phone_number` \u003cbr /\u003e | The user's phone number. |\n| \u003cbr /\u003e `rbm_share_location_response` \u003cbr /\u003e | The user's location, if they tapped the share location suggested action. |\n\n\u003cbr /\u003e\n\n### HTTP request\n\n`POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/dialogflowMessages`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------|\n| `parent` | `string` \"phones/{E.164}\", where {E.164} is the user's phone number |\n\n### Query parameters\n\n| Parameters ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `messageIdPrefix` | `string` A unique prefix of RBM message IDs that result from the Dialogflow event. Dialogflow supports multiple responses for a given event. If an event triggers multiple responses, RBM forwards each response as a separate message. Each message ID shares the same prefix. |\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Request body\n\nThe request body contains an instance of [DialogflowEvent](/business-communications/rcs-business-messaging/reference/rest/v1/phones.dialogflowMessages#DialogflowEvent).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [DialogflowEvent](/business-communications/rcs-business-messaging/reference/rest/v1/phones.dialogflowMessages#DialogflowEvent).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
