2 Dialogflow – Existing GCP Project

How to Create a Bot Project in Robolabs

To create a bot project in Robolabs, you will need to integrate the bot in Robolabs with the Dialogflow project. Dialogflow is a bot engine owned by Google. Users can create chatbots according to their business’ needs, starting from creating agents, intents (representing a mapping between what the user says and the action the user must take), and training phrases.

The steps to create a bot project in Robolabs

• Go to Robolabs on the sidebar in your Multichannel account menu

• Select the Bot Integration button located at the top right corner of the Robolabs page.

• Next, select Add Project from Dialogflow to integrate with Dialogflow

• After selecting the integration with Dialogflow, you will set up the bot to be used. The steps are as follows:
  • Write the name of the bot to identify the project. Enter the name of the bot in the Bot Name. column, then select Next

• Next, click Integrate Bot. Here, you will have to integrate with Dialogflow according to the instructions on the page. You are also expected to include some credential items contained in Dialogflow to be included in Robolabs, including:
  • Service account private key, in the form of .json file which you must upload here
  • Default bot language, the language used to correspond with the bot project in Dialogflow
  • Google Project ID according to the bot project in Dialogflow

To source for these items, you must go to the Dialogflow ES page via the following page.

How to Integrate Project Bot in Robolabs with Dialogflow

• Go to the Dialogflow ES page, then click Sign-in with Google

• After entering your Dialogflow ES, the first step is to create a new agent. You can do this by clicking Create Agent on the page.

• Next, fill in the Agent Name. You will then need to select the Default Language and Default Time Zone. For example, select the city where the agent “qiscusbot“ is located and select Default Language Indonesian -id. Click Create to create the profile.

• The bot project has been successfully created in Dialogflow. The next step is to search for the Google Project ID of the project by clicking the Settings button or the ️⚙️ icon on the left sidebar, next to the agent name qiscusbot. Click the icon and you will enter the Settings page. A Google Project ID can be located on that page to be copied and pasted into Qiscus Robolabs. In this example, the Google Project ID is qiscusbot-osof. After that, click the Google Project to receive the Service Account Private Key via the Dialogflow ES console page

• After entering the Dialogflow ES console page of the Project ID, go to the sidebar. Select IAM & Admin, then select Service Accounts

• After that, select + CREATE SERVICE ACCOUNT on the page

• After entering the Create Service Account page, enter the Service Account Name according to the project name. Here is an example: we enter the name Qiscus Bot. Then, click CREATE AND CONTINUE

• In the second step, click on Select a role, then click Search or select Owner to determine the role access to the project**.** Click, then set the task as Done

• In the last step for this service account, leave the user role blank (optional), then click Done

• In this step, the service account has been created in the qiscusbot-osof project. The next step is to download the JSON file in the project
• Select the email address for the project whose service key has been created on this page. In the example here, click email qiscus-bot@qiscusbot-osof.iam.gserviceaccount.com to go to the service account page

• On that page, select the KEYS menu. Then click ADD KEY, and select Create New Key

• A pop-up will appear like this, then select key type in the form of JSON. Click Create for the service key to be downloaded to your computer. Once the service key has been downloaded successfully, the last step is to enter the file into Qiscus Robolabs

This service key can only be downloaded once. Make sure the JSON file is not lost. If it is missing, then you will have to create a new service key.

How to Enter Dialogflow Account Credentials to Qiscus Robolabs

After obtaining the Google Project ID, Default Bot Language, and Service Account Key in Dialogflow, you can return to the Integrate Bot page on Qiscus Robolabs. Enter the item in Robolabs according to the project that has been created in Dialogflow. In this example, we have implemented the project ID qiscusbot-osof in Qiscus Robolabs. Then, click Next

After that, you will return to the third page to Integrate Multichannel. Here, you do not need to change the settings contained in Multichannel because it is automatically integrated. Also, if you want to activate the Handover to Agent feature, you must change the position of the toggle contained in the feature on this page to activate it. Then, click Finish

Next, you will enter the Manage Project page. To ensure that the bot has been successfully integrated with Dialogflow, you should see the bot name on this page.

Your bot is now successfully created. The next step is for you to assign the project bot to a channel it will enter. Click the bot name in the project to enter the Bot Information page**.**

In the Bot Information page, select the Assigned Bot to to select the channel set in your Multichannel account.

Next, select Save Changes.

After that, return to the Manage Project page to activate the project bot by activating the toggle located next to the bot name in the Status column.

Congratulations! Your bot has been successfully created and integrated with the Dialogflow and your Multichannel account.