# Intercom

## General information

The integration allows to process messages from messaging apps and social networks directly in Intercom interface. Each message request gets converted into a "Conversation". 

{% hint style="info" %}
Blinger.io acts solely as "transport" role, which delivers messages from users to Intercom interface. The set up of message processing is performed in Intercom interface, Blinger.io doesn't influence the standard business process of the helpdesk in any way.
{% endhint %}

## How to set up the integration with Intercom?

### Step 1. Browse to Integrations tab and click on "Add Integration" in front of Intercom

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-Lcf3eWlo2mUAaQZzbci%2Fic_step_011_new.png?alt=media\&token=8bb0c4a5-1c24-428f-80f4-0811458bbe20)

### Step 2. Open Intercom account and browse to "Settings"

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-LcezgT03hlIBb5X0KvD%2Fic_step_1_new.png?alt=media\&token=a2c573e0-6db0-48f6-8560-23236abeb4fa)

### Step 3. In "Developers" section select "Developer tools"

{% hint style="info" %}
After clicking on "Developers tools" a redirect to Intercom Developer Hub will happen
{% endhint %}

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-LcewMu1o3jXba7H3DbW%2Fic_step_31_new.png?alt=media\&token=29f630e2-960e-4bbf-a1fe-c0d6d88a546d)

### Step 4. Click on "New app" and define any name for the application being created

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-LcewgCST2hqysSGdEJP%2Fic_step_4_new.png?alt=media\&token=40893503-f6d3-4157-a61d-c259a5bef73b)

### Step 5. Copy the "Access token" value

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-LcexmNFHhNPlZmLNTUO%2Fic_step_5_new.png?alt=media\&token=98240a37-ed2d-4ca4-b39f-501ed46bcae0)

### Step 6. Go to Blinger.io, paste "Access token" in the field of the same name

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-Lm9yzjJRWAOX4MoEbXx%2F-LmA-S-ZnnpsvVgH_Z79%2Fimage.png?alt=media\&token=47d6f5ef-7f66-498c-877e-4211ae112e3b)

### Step 7. Go back to Intercom and copy the value of App id

App id is specified in address bar between `app/../`, as shown in the example in the image below

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-Lcf-S4uBi187xVhJdoq%2Fic_step_6_new.png?alt=media\&token=edca2fe8-db36-49bd-8a79-b9bd52f90baf)

### Step 8. Go to Blinger.io, paste "App id" in the field of the same name and click on "Add Intercom integration"

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LmiOLaXBB2XruiRObVq%2F-LmiRBQU1aFa6gvYI6V0%2F2019-08-20%2012.51.41.jpg?alt=media\&token=cca480d3-4707-40d9-8f66-787475094938)

### Step 9. After adding the integration, click on "Edit" in the block with Intercom integration and copy the value "Webhook URL"

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-Lcf1PvnoAL_LfiD9b3L%2Fic_step_7_new.png?alt=media\&token=86e9c134-1021-461f-b737-60561fb71ca3)

### Step 10. Set up in Intercom Developers Hub "Webhook URL"

On the page Intercom Developers Hub in the section Configure select Webhooks. Paste "Webhook URL" in the field "Your request endpoint URL", in the section Webhook Topics select **`conversation.admin.replied`** and click on "Save".

![](https://2982933755-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LcevuChAN-FQUSSqCbd%2F-Lcf2ClzYAH81MZTQBVK%2Fic_step_8_new.png?alt=media\&token=c4b11724-ae89-4961-a7bd-5d7b5a39f907)

{% hint style="warning" %}
Choose API version 2.2 in section "Basic information"
{% endhint %}

{% hint style="success" %}

### **The integration is completed!**

{% endhint %}