Method: phones.dialogflowMessages.create

Prompts a Dialogflow agent to send messages through an RBM agent.

If Dialogflow integration isn't enabled for an RBM agent, this method returns 403 PERMISSION_DENIED.

When an RBM agent is integrated with a Dialogflow agent, this method triggers an event 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.

If a Dialogflow intent defines multiple responses, the RBM Platform sends users one message per defined response.

If you contact a webhook with Dialogflow fulfillment, the fulfillment request includes the following information in the payload:

Field Description


The user's phone number.


The user's location, if they tapped the share location suggested action.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



"phones/{E.164}", where {E.164} is the user's phone number

Query parameters



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.



Required. The agent's unique identifier.

Request body

The request body contains an instance of DialogflowEvent.

Response body

If successful, the response body contains a newly created instance of DialogflowEvent.

Authorization scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.