Skip to main content
The Help Scout Cometly integration sends new leads from your Help Scout 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.
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.

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
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

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.