Add data from URL parameters inside a conversation

To add data from URL parameters to a form conversation, follow these steps:

Add URL parameters in Settings

Let's say your URL is

https://yourwebsite.com/?name=amy&location=newyork

Go to Settings of your form, then click on Data Collection. Click on add custom field button to collect custom data.

In this example, you will be adding two keys as per custom field; name and location.

Once these keys are defined in the custom fields, the form will be able to pick them up. You will be able to see these URL parameters in the Response section as well as in the email notifications and in the webhook.

Add URL parameters as variables

Once you add these URL parameters as custom fields, the form will be able to use them as variables.

Go to Questions and use the @ symbol to add them at the respective places.

Once the parameters are added as variables, you will easily identify them highlighted in green.

And your form will replace the variables with the data present in the URL.

Tip

In the case that a parameter is missing, the variable will become NULL and the form will not display anything else in its place. Therefore we recommend to structure your sentence in a way that the variable appears at the end of a sentence.

Test the Form

Have a test conversation with your form on your website to see how variables align with the sentence structure. Make sure to pass the necessary parameters in the URL while doing so.

Note

This method will work when the form is used in widget mode and when used as a a Link. If you are embedding the form as an iframe, the form will not be able to read the URL parameters; therefore it will not work in embed mode.