GCP service account settings
info_outline This step only appears for Self-Service Plan users. It will not appear for Full Service Plan users.
In this step, you will select your Google Cloud Platform (GCP) service account and enable the Google APIs required by the Data Bucket.
Select a GCP service account
When you create a Data Bucket: Dialogflow Connector Type, BLOCKS constructs and operates an environment in your GCP project. In order for BLOCKS to do this, it must have a GCP service account with editor permission to your GCP project.
Select a GCP service account with editor permission for your GCP project for this step.
info_outline Refer to Basic Guide > Creating a Google Cloud Platform service account key for detailed instructions on creating a GCP service account.
Do the following if there are any API that do not have a checkmark (check_circle) next to their loop Check button:
- Click open_in_new for the API that doesn’t have a check_circle.
- The GCP console will open in a new tab.
- Click Enable in the GCP console.
- Once the API is enabled, close the GCP console and return to BLOCKS.
After completing the above steps for all APIs, click loop Check and confirm that a check_circle appears for each API.
If a check_circle does not appear, try waiting a bit and clicking loop Check again. Depending on the circumstances, the check_circle may not appear right away. If this occurs, try repeating the following steps until it appears:
- Wait a bit of time
- Click loop Check
If error_outline continues to display, one of the following could be the cause, aside from the API not being enabled:
The GCP service account’s role has not been given Editor permission.
Open the menu (menu) from the upper-left of the GCP console and select IAM & admin. From the IAM menu, confirm that your service account has its role set to Editor. If not, change it to Editor.
Billing is not enabled for your GCP project.
Open the menu (menu) from the upper-left of the GCP console and select Billing. Enable billing for your project if you have not already done so.
Webhook entry point settings
Designate the URL (webhook) that will be used to call BLOCKS from Dialogflow.
You will enter this URL in the Fulfillment section of Dialogflow later.
info_outline You can view this URL again after creating your Data Bucket from the Data Bucket details screen. Refer to Board details > Connection information for instructions on how to enter the Dialogflow Fulfillment.
Webhook entry point
The Webhook URL is formatted as follows. You can only edit the
＜Customizable Identifier＞ portion.
https://magellan-dialogflow-＜Customizable Identifier＞-dot-＜Project ID＞.appspot.com
The customizable identifier must follow these rules:
- Use only lowercase letters, numbers, or hyphens (-)
- Can only end with a letter or number, not a hyphen.
- The number of characters that can be used depends on the length of the project ID and ranges from 15 to 20 characters.
Flow Designer connection settings
Select the Flow Designer that contains the Flows you want to connect with Dialogflow open_in_new.
info_outline You need to designate a Flow Designer in this step, but it doesn’t matter if it doesn’t contain any Flows yet.
You need to follow the rules below to connect Dialogflow with a Flow Designer:
- The Dialogflow Intent name must match a Flow Designer’s Flow ID
- In Dialogflow: You must check Use webhook from Intent > Fulfillment
- On the Flow Designer: Use the Dialogflow response BLOCK for sending a response to Dialogflow
- On the Flow Designer: A response must be sent to Dialogflow within 5 seconds
error_outline With the release of the Dialogflow V2 API, you must also do the following:
- Under API Version, check V1 API.
Select a Flow Designer
Select a Flow Designer from the list.
Click Reload to refresh the list with any new Flow Designers that have been created.
Google Cloud Platform usage fees
The Data Bucket creates an environment in your GCP project that uses certain GCP services.
As such, GCP service charges will apply separately from MAGELLAN BLOCKS fees. These charges vary depending on the service. For details, refer to the pricing page for each service used by Data Buckets. The Dialogflow connector type uses the following service:
Data Bucket details
You can view the webhook entry point URL, API token, and connected Flow Designer from the Data Bucket details screen.
Use the webhook entry point URL in the Fulfillment section of Dialogflow.
In this section, you can view information for the settings you configured when making the Data Bucket.
Click Change service name to rename the Data Bucket.
Resources used by this Data Bucket
You can view the GCP resources used by a Data Bucket in this section.
The resources shown here have been created in your GCP project.
error_outline Do not delete these resources. If deleted, the Data Bucket will no longer function.
Delete this Data Bucket
Click Delete and confirm your decision to delete the Data Bucket and its related resources immediately. This action cannot be reversed.
info_outline It takes a bit of time for a Data Bucket to be deleted. You will not be able to use BLOCKS while the Data Bucket is being deleted. Please wait until the processing completes.