Data Bucket Help: Dialogflow Connector Type

GCP service account settings

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.

Refer to Basic Guide > Creating a Google Cloud Platform service account key for detailed instructions on creating a GCP service account.

Enable APIs

Do the following if there are any APIs that do not have a checkmark () next to their Check button:

  1. Click Enable All APIs.
  2. The GCP console will open.
  3. Click Continue in the GCP console.
  4. Once the message The APIs are enabled appears, close the GCP console and return to BLOCKS.

Click Check for any API that does not have a checkmark (). Confirm that a checkmark appears for the API. Repeat this process for any APIs without a checkmark.

If the checkmark does not appear, try clicking Check again and waiting for a moment. This can sometimes take a bit of time. If the checkmark still does not appear, repeat the following:

  1. Wait a moment.
  2. Click Check.

If you still see a , the issue could be one of the following:

  • You GCP service account is not set to the Editor role:

    Open the menu () in the upper-left corner of the GCP console. Hover your cursor over IAM and admin and click IAM. Confirm that your service account’s role is set to Editor. If not, change it to editor.

  • Billing is not enabled for your GCP project:

    Open the menu () in the upper-left corner of the GCP console. Click Billing. If you haven’t already done so, enable billing for your project.

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.

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 .

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

With the release of the Dialogflow V2 API, you must also do the following:

API Version setting
  • 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

Connection information

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.

How to enter the webhook URL and API token into Dialogflow Fulfillment

Settings

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.

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.