Steps to Install the Extension:
Intercom Access Token Setup:
Log in to Intercom:
Visit the Intercom website and log in with your credentials.
Access the Developer Hub:
After logging in, click on Settings, then go to Integrations. From there, navigate to the
Developer Hub, where you can manage your Intercom apps.
Create or Select an App:
If you don’t already have an app, click on Create App, give it a name, and either create
a new workspace or select an existing one. Then, click Create App to finalize the
process.
If you already have an app, find your app in the list and click on it to proceed.
Locate the Test and Publish Option:
1.After creating the app or selecting an existing one, the system will usually redirect
you to the app's page.
2.If the redirect doesn’t happen, simply find your app in the list and click on it to open
the app’s settings page.
3.Once you're on the app’s page, look at the left-hand menu for the Test and Publish
option.
Copy the Access Token:
In the Test and Publish section, you’ll find your workspace details, including the Access
Token. Copy the token for use in your integration.
Access Token Not Visible:
If the token is not visible, look for the Install App option next to the workspace name.
Click on Install App, and once the app is installed, you will be able to see the
workspace's Access Token. Copy this token for your integration.
Installation:
1. Log in to your Freshsales account, then go to the Freshsales Marketplace, find the
Intercom Integration app, and click Install.
2. The app will ask for your Freshsales API key, Freshsales URL, and Intercom access
token.Enter the credentials and click Verify Your Account. Your credentials will be
secured.
3. Once you verify your account, the app will prompt you to map the fields between
Freshsales and Intercom. Ensure that the Freshsales email is mapped to the Intercom
email field, as this is mandatory.
4. Additionally, map fields such as phone, name, and company. After mapping the fields,
click Install, and the app will be successfully installed in your Freshsales application.
Now, click on App Settings and then Edit Settings. The field mapping page will be
displayed with the correct mapped values populated.
5. You will see an option to Click to Copy the Webhook near the Edit Credentials button
at the top of the field mapping. Click on it to copy the webhook. After that, make sure
to click Save, otherwise, your app will not work.
Webhook Setup:
Once you copy the webhook, go to Intercom, find your app, and open it. On the left side
of the app, you will see the Configure option. Click on it, then click the Webhook button.
Paste the copied webhook into the Endpoint URL field. This webhook will be used to
trigger events whenever you create, edit, update, or attach a company.
After pasting the webhook, you can assign permissions to the app, such as:
company.contact.attached, company.contact.detached, company.created, company.deleted, contact.deleted, contact.email.updated, contact.lead.added_email, contact.lead.created, contact.lead.updated, contact.lead.tag.deleted, contact.user.tag.created, contact.user.created, contact.user.updated, contact.user.tag.deleted.
Once you select the topics, click Save. Now, your app is ready for contact sync.
Contact Sync Functionality:
1.Once all the setup is complete, go to the Developer Hub in Intercom, click on your
correct webhook-attached app, then on the left side, click Test and Publish, and select
your app. This will navigate you to the contact creation page. When you create a user or
lead, it will reflect in Freshsales.
2.Similarly, when you create a contact in Freshsales, it will be reflected in Intercom under
your newly created app. You can edit or delete the contact on both sides.
Please note:
i) Intercom does not have a specific event topic for creating notes. If you create a note
for a contact, it will not be reflected immediately until there is an update on the
contact (not the company). After the note is created, it will appear in Freshsales once
any update
occurs on the contact.
ii) You cannot delete a note from the Intercom contact.
iii) No changes will occur unless there is an update in the mapped fields. Only the fields
you have mapped and that have been updated will trigger synchronization between
Freshsales and Intercom.
CRM & SalesData management & Analytics