> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Help Scout integration

> Set up the Help Scout Cometly integration to send new Beacon chat leads to Cometly, so you can see which ad or channel produced each one.

The Help Scout Cometly integration sends new leads from your [Help Scout](https://www.helpscout.com/) Beacon chat widget to Cometly. A lead here is a new Help Scout customer with an email address. You map those leads to the event of your choice (an event is an action Cometly records for a contact, such as a lead or a purchase).

This matters because chat leads usually sit in Help Scout with no link to your ads. Once they reach Cometly, each one is tied to the visitor's journey, so you can see which ad or channel started the conversation and count chat leads next to your other conversions.

## How it works

When you connect Help Scout, Cometly creates a customer property in your Help Scout account called `cometly_tracking_token`. A small snippet on your website fills in that property when a visitor chats in through the Beacon widget. When Help Scout creates the new customer, it sends the customer to Cometly, and Cometly uses the tracking token to tie the lead back to the visitor's original journey.

> [!NOTE]
>
> Only customers that carry a Cometly tracking token are recorded. A customer created in Help Scout without one is not recorded as an event in Cometly.

## Before you start

* Install the Cometly pixel (the tracking script that identifies visitors on your website) on every page where your Beacon chat widget appears. The snippet in step 2 reads the visitor's tracking token from the pixel. See [Install the Cometly pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Set up the Help Scout integration in Cometly

**1. Connect your Help Scout account**

In Cometly, click **Integrations** in the left sidebar, find the **Help Scout** card (category **Chat**) and click **Connect**.

![Cometly Apps and Integrations page on the Chat category, with an arrow pointing at the Connect button on the Help Scout card](https://mintcdn.com/cometly/gJhojf-axy7BVk83/images/integrations/platforms/help-scout/01.webp?fit=max\&auto=format\&n=gJhojf-axy7BVk83\&q=85\&s=658174dcc5a79f3492b885f7647773ef)

You can also start from **Events Manager**: click **Create Event**, choose **Help Scout** under **App / Integration** and click **Integrate**.

On the Help Scout page:

1. Click **Sign in with Help Scout**. This activates the integration in Cometly, and the page changes to **Help Scout connected**.
2. Click **Re-sync Help Scout** and authorize Cometly in Help Scout. This is the step that creates the `cometly_tracking_token` property and the webhook in your Help Scout account, so do not skip it. When you are sent back to Cometly, a message confirms that the synchronization succeeded.

**2. Add the tracking snippet to your website**

The snippet updates the `cometly_tracking_token` property in Help Scout when a new lead chats in through the Beacon widget.

On the Help Scout page in Cometly, under **Add the tracking snippet to your website**, click **Copy snippet to clipboard**. Paste the snippet right below `Beacon('init')` on every page of your website where the Beacon chat widget is installed.

**3. Map new Help Scout leads to a Cometly event**

Under **Map Help Scout events to Cometly**, choose which Cometly event the Help Scout **Customer Created** event should be recorded as (the default is **Lead**) and click **Save**.

## Choosing the right event

When you send **Lead** events to Cometly from Help Scout and from other platforms, consider the following:

* **If Help Scout leads are already in your CRM**: if your CRM (for example HubSpot) already sends Help Scout leads as part of its **Lead** events, map Help Scout to a separate event in Cometly, such as a custom event named "Chat Lead". You will see both **Lead** (from your CRM) and **Chat Lead** (from Help Scout) on the contact's timeline, without duplicates.
* **If leads are sent from multiple sources**: if you send **Lead** events from different sources (for example forms, Help Scout and a CRM), you can include Help Scout leads in the general **Lead** event.

Choose the setup that best fits your workflow to keep your tracking clear and accurate.

## Check it worked

The Help Scout page in Cometly shows **Help Scout connected**, and the re-sync ends with a message that the synchronization succeeded. To test the full flow, start a chat through the Beacon widget on your website with an email address that is not already a customer in Help Scout. Then click **Events Manager** in the sidebar and open the **Events Log** tab: the new lead appears in the list.

## Frequently asked questions

### What data does Help Scout send to Cometly?

For each new customer, Cometly records the email address, first name, last name and the time the customer was created in Help Scout. It also reads the `cometly_tracking_token` property, which is what links the lead to the visitor's journey.

### Why are my Help Scout leads not showing up in Cometly?

The most common cause is a customer that reaches Cometly without a tracking token. Check that the Cometly pixel is on the page with the Beacon widget, that the snippet sits right below `Beacon('init')`, and that you completed the **Re-sync Help Scout** step. Open the Events Log to see whether Cometly received the customer at all.

### Does Cometly import my existing Help Scout customers?

No. Help Scout notifies Cometly only when a new customer is created, so customers that existed before you connected are not sent. Leads start to appear from the first new Beacon chat after setup.

## Next steps

* [Check incoming events in the Events Log](https://docs.cometly.com/support/troubleshooting/general/event-log.md)
* [Create a custom event, such as "Chat Lead"](https://docs.cometly.com/guides/events/custom-events.md)
* [Learn how events work in Cometly](https://docs.cometly.com/guides/events/how-events-work.md)
* [Browse all integrations](https://docs.cometly.com/integrations/overview.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.