How to Install Custom Parameters in ChatFlow #

This guide walks you through how to enable advanced user tracking in ChatFlow using custom parameters, and how to install the required JavaScript code on platforms like WordPress, Wix, and Shopify.

Step 1: Open the Install Section in ChatFlow #

1. Log in to your ChatFlow Dashboard.

2. Select your Workspace from the left menu.

3. Click the “Install” tab at the top.

4. Select “Configure your script” to begin setup.

Step 2: Choose the Right Script Type #

• Select “For visitors without logins” if you want to track anonymous users.

• Select “For users with logins” to track known users (e.g., logged-in customers).

Step 3: Copy the Script Provided #

You’ll see a script box that contains a code snippet. Copy this code. It will look similar to the following:

<script defer 
src="https://sdk.chatflowapp.com/scripts/v1/pixel/NGOeRvh4ATIkGL06" 
data-custom-parameters='{
  "email": "YOUR_USER_EMAIL_VARIABLE",
  "name": "YOUR_USER_NAME_VARIABLE",
  "image": "YOUR_USER_AVATAR_URL",
  "location": "YOUR_USER_LOCATION_VARIABLE",
  "phone": "YOUR_USER_PHONE_VARIABLE"
}'></script>

Step 4: Replace the Placeholder Variables #

Update the values in the script with dynamic user data from your platform. For example:

"email": "{{user.email}}",
"name": "{{user.name}}"

You can include as many or as few parameters as your platform supports. Any parameters you don’t use can be removed.

Platform-Specific Installation Instructions #

Installing on WordPress #

Using a Plugin (Recommended)

1. Install a plugin such as Insert Headers and Footers.

2. In your WordPress dashboard, go to Settings > Insert Headers and Footers.

3. Paste the entire ChatFlow script into the Header section.

4. Click Save.

Manual Installation (Advanced)

1. Go to Appearance > Theme File Editor.

2. Select your theme’s header.php file.

3. Paste the script right before the </head> tag.

4. Save the file.

Installing on Wix #

1. In your Wix dashboard, go to Settings > Custom Code.

2. Click Add Custom Code.

3. Paste the ChatFlow script into the code box.

4. Select to add the code on All Pages and choose Load Code on Each Page.

5. Set the placement to Head.

6. Click Apply.

Installing on Shopify #

1. From your Shopify admin, go to Online Store > Themes.

2. Click Actions > Edit Code.

3. Open your theme’s theme.liquid file.

4. Scroll to the </head> tag.

5. Paste the ChatFlow script just above this tag.

6. Save your changes.

Final Step: Verify Installation #

Once installed, return to your ChatFlow install dashboard. You can then test to ensure the script is installed correctly on your website.

You should begin to see real-time data populate in your Community and Analytics sections as users interact with your site.