Setup Webhooks
Webhooks allow you to subscribe to real-time notifications of events happening in Intercom.
Webhooks Subscriptions are associated with your App and not a single Workspace. You will receive notifications of events from all Workspaces where you install your App.
For more information, see the official Webhook Intercom documentation.
Configuring the Endpoint URL
This tells Intercom where to send notifications and should be set to your Cyclr Console-level Webhook URL for Intercom, located here:
- Within your Cyclr console, go to Connectors > Application Connector Library and locate the entry for Intercom.
- Select the Installation User Experience button.
- Select the Settings tab.
- Make a note of the Webhook URL shown there:
Within Intercom, configure your Webhook subscriptions:
- Navigate to your App in the Intercom Developer Hub.
- Under the Configure menu, select Webhooks to set up a Webhook subscription.
Set the Endpoint URL to have Intercom send notifications to your Cyclr Console:
That URL will receive the HTTP POST notification requests for every topic you have subscribed to.
Subscribe to a Webhook Topic
Within Intercom, you’ll need to select the topics you want to receive notification requests for.
Click on the Webhook topics dropdown to see all available topics – more information on each topic is available the Webhook models reference page.
To use the Webhooks in the Intercom Connector, the following topics must be added to your app:
- company.created
- contact.email.updated
- contact.lead.added_email
- contact.user.created
- contact.user.tag.created
- contact.user.tag.deleted
- conversation.admin.closed
- conversation.admin.noted
- conversation.user.created
- conversation.user.replied
- event.created
- help_center.domain_changed
Receiving Notifications in Cyclr
Having performed the above setup, Intercom will begin sending notifications to your Cyclr Console-level Webhook URL
Cyclr will then route them to Cycles installed within your Cyclr Accounts according to which of your customers they relate to, and the Connector Methods present in your running Cycles.
For example, to receive notifications when a company is created, you would use the Intercom Connector’s “Notifications > Company Created” Method within a Cycle.