Contact us
Recommended
Save time by chatting with RChee, available online 24/7.
Submit a case
The most direct way to match you to the right expert on your issue. Responses within 48 hours.
Contact us
FOR SALES
1 (888) 898-4591
FOR SUPPORT
1 (888) 898-4591
Submit a case
Contact us
FOR SALES
FOR SUPPORT
Welcome to MyRingCentral
Hi, ${extension.contact.firstName}!
Welcome to MyRingCentral
Hi, ${extension.contact.firstName}!
Engage Digital | Integrating with Google Dialogflow
Last updated on April 14, 2021
This integration requires:
- An instance of Engage Digital
- A user with administrative rights on the Engage Digital instance
- A supported chat channel (see Supported messaging channels) to use with the Engage Digital instance
- A RingCentral account and a RingCentral user account with administrative rights
- A Google user account (preferably, one generic account per client)
- Optionally: a billable Google Cloud account
Setting up Engage Digital for Google Dialogflow
In this procedure, you will create a new non-SSO Engage Digital user that will hold API keys and have the same set of permissions as a bot. You will also need to set up the necessary access rights to a specific channel for this user and create the categories for initial and fallback routing. For security purposes, you will generate an API access token to connect Engage Digital to Google Dialogflow.
Creating an Engage Digital agent with channel access rights
- Navigate to Users > Agents via the left-hand navigation bar.
- Click New agent to create a new non-SSO Engage Digital user.
- Enter a name and email address for the user.
- Select Administrator from the Role dropdown menu.
- Do not check the SSO only (no password) box.
- Click Save.
- Click the Edit permissions lock icon next to the agent.
- Grant the necessary access rights to a specific channel for this user.
To learn more about creating an Engage Digital agent and agent permissions, read Creating an agent and Updating agent permissions respectively.
Creating categories for Google Dialogflow
- Navigate to Routing > Categories via the left nav bar.
- Create a category that will be used for initial routing to a bot:
- Click Add.
- Enter a Name. For example, AI_Greeter_bot.
- Leave the default Type as Skill category.
- Choose the Selected channels the categories apply to.
- Click Save.
- Create a category to be used as a fallback:
- Click Add.
- Enter a Name. For example, AI_Greeter_bot_fallback.
- Leave the default Type as Skill category.
- Choose the Selected channels the categories apply to.
- Click Save.
- Repeat steps 2-3 to create additional categories as needed.
Go to Creating categories to learn more about creating categories and their configuration options.
Create an API access token for accessing the Engage Adapter App
- Navigate to Dev Tools > API access tokens via the left nav bar.
- Click Add.
- Leave Enabled checked.
- Enter a Description related to this integration.
- Select the Agent that you previously created.
- Click Save.
- Click the Edit pencil icon on the newly created token.
- Copy the Token string.
See Connecting Engage Digital and Google Dialogflow to learn how this API access token is used.
Setting up the Google Dialogflow chatbot agent
You will configure Google Dialogflow by setting up a new chatbot agent or using an existing chatbot agent. You then define a number of intents – these are topics and the customer questions that fall under each topic – that the chatbot agent will use to categorize messages and handle a complete conversation. You will identify intents where you may want to hand over a conversation to a human agent and enhance them by adding one output context to each.
Google Dialogflow also supports custom business logic. If needed, you can also set up a fulfillment provider for custom business logic using Dialogflow standard practices. For example, see Create fulfillment using webhook in the Google Dialogflow documentation.
Creating the Google Dialogflow chatbot agent
- Access the Google Dialogflow console at https://console.dialogflow.com/api-client/#/login.
- Log in using your generic Google account.
- Click Create Agent.
- Enter an Agent name as a string with no whitespaces.
- Click Create.
Once your first chatbot agent has been created, you can see all the Dialogflow console functions enabled. The primary configuration you will need to perform will be configuring the Intents that help handle a conversation.
Configuring Google Dialogflow intents
- Identify an intent which you want to hand over a conversation to a human agent.
- Click Create intent.
- Enter a descriptive Intent name.
- Expand the Contexts menu.
- Click Add context.
- Add an input context to the intent, if desired.
- Add an output context to the intent using any name.
- Click on the small circle near the output context's label and set a Lifespan of 1.
- Click Save.
- Repeat steps 7-9 to add more output contexts to an intent as needed.
After defining the settings, you can use the console at the far right to test your contexts.
Configuration settings for Google Dialogflow intents
- Intent name: A name used to identify the intent.
- Add input context: If you configure an output context in the Engage Adapter App, enter the value here.
- Add output context: An output context that will be mapped to an Engage Digital category.
- Lifespan: The number of conversational turns for which the context remains active. Must be 1.
Connecting Engage Digital and Google Dialogflow
- Access the Engage Adapter App at https://edf.ringcentral.com.
- Log in using your RingCentral user with administrator credentials.
- Log in with your Google credentials to authorize the integration to use your Google account.
- Enter the URL of your Engage Digital instance and paste your API key.
This completes the basic integration of connecting Engage Digital to Google Dialogflow. See Configuring integration settings.