Add custom parameters to your chatbot script

Last updated: 25 January 2023

To set up a chatbot on your website, all you need to do is copy its script and paste it into your page's code. Simple enough. If you need a refresher on this, read the following docs:

But did you know you can do more than 'just' copy-pasting this code? In this doc, explore how you can append up to ten custom parameters to your script and use them to make your chatbot even more powerful.

Step 1: Find your script

Go to Engage → Channels.

Pick one of the web-based channels: Converse, Embedded, or Full page.

Find the chatbot script at the top of the page.

Step 2: Create a custom parameter

Before we append the parameter, we need to come up with one. The good news is: this is totally up to you.

There are no limitations in what you'd like to call the parameter or its value.

For the purpose of this doc, we're going to assume we are going to use this extra parameter to store a token of a logged-in customer. Here's a parameter we could use: token=my-token

Step 3: Append the parameter to the chatbot URL

Grab your chatbot script and find the chatbot URL. Regardless of which of the three channels you picked, the URL will look similar.

It has

a long URL,
a c= parameter, and,
an i= parameter.

At the end of the URL, append your new parameter.

https://aposdkawpdko1.cloudfront.net/widget/widget.js?c=chatbot-demo&i=waopdwkdkow&token=my-token

You may add up to ten parameters to your script.

Step 4: Add your new script to your site

Follow the simple steps to add your script to your website.

Step 5: Use your new parameter

Having the ability to append a custom parameter directly into the chatbot script opens up many opportunities.

You can use this parameter to store a unique identifier, such as a logged-in token.

You can also use this parameter and display it inside your chatbot, if you wanted to. To do so, use the following variable:

{{account.extra_variables.[parameter name]}}.

In our example, it would look like this: