Last updated: 04 May 2021 

Integrations allow you to connect your chatbot with other services and software. This opens up the opportunity to send and receive data from other services as part of your conversation flow.

Below are a couple of examples of how powerful integrations can be:

  • When a user falls back to human, create a support ticket in Zendesk.

  • When a user leaves their email address, create them as a lead in your custom CRM.

  • When a user asks about a particular product, look up the description using the Shopify API and send it back to them.

To create an integration, head to IntegrationsIntegrations.

Step 1: Create your new integration

Click Add new.

Give your integration a name.

Give your integration a descriptive name. This will make it easier to manage, edit, or remove later on.

Enter your integration's base URL. This URL will be consistent across all your endpoints.

Select your authorization method. There are four available:

  • API key -- requires a key, value, and header / body.

  • Basic auth -- requires a user name and password.

  • Bearer token -- requires a bearer token.

  • No auth -- does not require any credentials.

If your integration requires it, add global HTTP headers and their corresponding values. There are seven headers available: 

  • Cache-control

  • Host

  • User-agent

  • Accept

  • Accept-encoding

  • Connection

  • Content-type

Hit Save.

Your integration is now available. 

Step 2: Create your endpoint(s)

Now that you've created the connection between the chatbot platform and your external piece of software, it is time to create your endpoints.

Endpoints send and receive the data you need from the integration. You can create as many endpoints as you need per integration.

Click Endpoints on the integration you need and open the Add a new endpoint dropdown.

Give your endpoint a name. A single integration may have several endpoints, so it’s important to be specific. Avoid ‘Integration #1’, for example. Instead, try to write exactly what this endpoint will do (e.g. 'Submit a lead to HubSpot'.

Select the type of request you would like to make with this endpoint: GET, PUT, POST, or DELETE.

If needed, enter the folder you will send the request to. This folder will be appended to the integration's base URL.

There are two methods to send data with the request: 

  1. Params: perfect to send form data or simple, single-level JSON object data. You can use this method to send key => value parameters with the request.

  2. JSON: ideal for more complex requests

Once you’ve entered all the data you need to capture or send, hit Save

Using variables in integrations

Both methods enable you to send data using variables. To enter a variable, simply start typing {{. Using the popup up to find and choose the variable you'd like to use.