We finally integrated Dasha with Zapier. This is pretty awesome because now any conversational app you write for Dasha can be used as an input/output function using any other apps on Zapier.

For example - we can input into a Dasha app the user's first name and phone number collected from a lead form on a website using Zapier. Dasha app calls the user and collects data which is then output into Hubspot CRM or Google Calendar or anything else you can think of.

Here is a demo of the result:

I previously wrote a tutorial on how such an app can be built using Dasha. Today we will integrate this app into a workflow, in less than fifteen minutes. For this tutorial we will use the following tools:

1. Dasha
2. Zapier
3. Hubspot

Here is the process at a glance:

1. We create a stand-alone form on Hubspot with the fields "First Name", "Email" and "Phone".
2. We point to this form submission as the action that initiates the Zap in Zapier.
3. We launch a call with the Dasha Zapier integration and pass Name and Phone as input variables.
4. Once the call is complete, we write all the collected information to specially created fields in the Hubspot lead card using another Zapier step.

Now, let's get started.

Setting up your Dasha app

For this tutorial we will reuse code that I wrote previously. It is a conversational AI app that qualifies inbound leads for a company (ACME Software) that sells a software for invoicing automation. At its core, the app checks if now is a good time to talk, asks a few questions and asks when a good time for the user to take a call from an account executive is. Let's get this application opened in your development environment.

If you have never used Dasha before, you need to activate your API key. The API key lets you load your conversational application to the Dasha Cloud Platform, where it is executed. If you have your Dasha API key, ignore this part.

Make sure you have the latest Microsoft Visual Studio Code, Node.js and NPM installed. Dasha Studio is implemented as an extension to VSCode for your convenience. Open Visual Studio Code and install the Dasha Studio extension and Dasha Command Line Interface .

code --install-extension dasha-ai.dashastudio && 
npm i -g "@dasha.ai/cli@latest"

Now, run a command to register your Dasha API key. A browser window will pop up and you will need to sign up for an account.

dasha account login

Afterwards, run to check your API key.

dasha account info

Now, you need to clone the inbound leads Dasha app and open the folder in which it is located. We will be cloning this app.

git clone https://github.com/dasha-samples/inbound-lead-qualification
cd blank-slate-app

In building Dasha apps in VSCode, you will mainly work with three files:

1. main.dsl is the Dasha Scripting Language file. DSL is a domain specific language, derived from TypeScript and used for the exclusive purpose of describing a conversation. You can read more about it in our documentation.
2. data.json is the data set you provide to train the Dasha Cloud neural networks to recognize user intents and identify named entities.
3. index.js is the server-side JavaScript file to which the Dasha SDK is imported and which launches the contents of the /app folder to the Dasha Cloud to be executed.

Note that last bit. "launches the contents of the /app folder to the Dasha Cloud to be executed". This means that when your Dasha application is launched from Zapier, it only functions as the contents of the /app folder.

Take a look at the main.dsl file, namely the context variables, beginning at line 7.

context 
{
    input phone: string;
    input name: string = "";

    output software: string = "";
    output invoices: string = "";
    output lead_source: string = "";
    output calltimeday: string ="";

    calltime: string = "";
    callday: string = "";
    callback: string = "";
    visitedNodeTime: boolean = false;
    visitedNodeQuestion1: boolean = false;
}

Note that you are taking Input variables name and phone and outputting variables software, invoices, lead_source and calltimeday. This is a key ingredient to the Zapier integration. We will input the name and phone from the collected form data and output all of our output variables to be saved to the lead card in Hubspot.

Now, you need to run a sample. It will serve two purposes. You will test the app and secondly, you will register the app in the Dasha Cloud to your account, so that you can refer to it from Zapier in building your integration.

npm i 
npm start 12223334455 

Where 12223334455 is your phone number in the international format.

Setting up Hubspot

Log into your Hubspot account. Everything we will do here today can be done with the free Hubspot package. We will do two things:

1. Create a stand-alone form
2. Add a few custom Contact properties

Creating a form

On the top menu, hit Marketing > Lead capture > Forms.

Now, click Create Form in the upper right corner, select Standalone Page from the Form menu and click Next. Pick Blank Template and click Next again. Name your form (I named mine "Zapier test form") and add the following fields: First Name, Last Name, email, Phone number.

Click Update > Publish. You will get a pop up with the link to access the form. Copy this link and set it aside, we will need it to test the integration.

Create custom fields (properties) in Hubspot

Refer back to the output variables in main.dsl. We need to map fields in Hubspot to four output variables. Here is how I named mine in Hubspot:

1. calltimeday > call_time_day_test
2. invoices > invoices_test
3. lead_source > lead_source_test
4. software > software_test

Click on Settings, then Properties and finally Create Property.

Select
Object Type > Contact
Group: Contact information
Label: your name for the property

Hit Next, and select field type: single line text.

Do the same for the other 3 properties.

Now, let's make these properties clearly visible on the lead card, so that you can easily look at the results of the test. Open any contact by going to Contacts > Contacts and clicking on any one of them. Now, scroll a bit down and click "View all properties".

Now, search for each of your newly added properties by their name and click "Add to your view"

Great, our Hubspot is ready to go. Before moving to the next step, use that link to the form that you copied earlier to open up the form in a browser window, fill it out and submit. Use your real phone number in the international format (12223334455). This will give us some data for Zapier to use in the next step.

Create a custom Zapier Zap integration

Log into your `Zapier account. The Zap we are building is a complex multi step integration. Zapier free users only get to build two step integrations, so you will need to get the 7 day free trial of premium Zapier personal account to build this integration.

Once sorted, click "Create Zap" in the upper left corner. Name the Zap and search for Hubspot as the first kick off event.

Choose "new form submission" for the trigger event and hit "Continue". In the next step you will need to add a hubspot account. If you've never used one, click "+ Connect a new account". Once connected, click "Continue". Now you will be asked to set up the Trigger. Choose your Hubspot form name from the drop-down, click refresh fields and click "Continue". If you have previously filled out the Hubspot form, you should see something like this:

Click "Continue" and search for "Dasha" for Step 2. We will now connect Zapier to Dasha Conversational AI API.

In the Action Event Drop-down, select "Make a Call" and "Continue". In the next "Choose account" drop-down, select your account and click "continue".

On the next screen, choose "Provided by Dasha" for the dropdown "SIP Trunk to use", choose "inbound-leads" for the "Application to use" dropdown and select the upper-most value for "Application to use" dropdown. Once you select the application, two new fields should appear: "Phone" and "Name". These are the input variables required by the Dasha app. Select from the drop down appropriate fields, as collected by the Hubspot form. (Note if the fields "Name" and "Phone" do not appear, hit the "refresh fields" button).

Click "Test & Continue". You should get a call from your Dasha app. You will likely not see proper data appear in Zapier, do not fret, this seems to be the way it works. Once your Zap is complete, it will work as you want it to.

Click the little plus sign below to go to the next step.

In order to write data to Hubspot, we need to have the Contact ID number. Since we do not have it, we have to first make a request to Hubspot API to find the contact's ID using the contact's email (which we do have). Choose Hubspot under "action". For dropdown "Action event" look for "Find Contact". Next, select your Hubspot account. In the Set Up Action menu, select "Contact Information: Email" under "FIrst search property name" and for "First search property value" choose the email field from the first action (Hubspot form submission).

Click "Continue" and then "Test & Continue." Now, click the + sign to create a new action. This final action will let us write the data collected by Dasha to the contact card in Hubspot.

Select Hubspot and "Action event": Update contact. Hit "Continue". Choose your Hubspot account and hit "Continue" again. Under Object ID select the ID value we hav received in the previous step.

Now, scroll down to find all the property field names we have previously added to Hubspot:
call_time_day_test
invoices_test
lead_source_test
software_test

For each, select the appropriate output data type from "Step 2 - Make a Call with Dasha", as such:

Hit "Continue" when you are done and "Turn on Zap".

Testing the Hubspot-Dasha-Hubspot Zapier integration

Now to the fun part. Fill out your form again. Within 30 seconds you should get a call from Dasha. Give it all the information it asks for. Now, go to your lead card in Hubspot, you should see something like this:

In conclusion - you should make changes to the Dasha app, adapt it to the realities of your use case and tell us how it went in the Dasha community.