Skip links

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: 


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,
  • c=

     parameter, and,

  • an 


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

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:

Powered by BetterDocs

Leave a comment

🍪 This website uses cookies to improve your web experience.