# 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".&#x20;

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

![](/files/-Lcf3eWlo2mUAaQZzbci)

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

![](/files/-LcezgT03hlIBb5X0KvD)

### 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 %}

![](/files/-LcewMu1o3jXba7H3DbW)

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

![](/files/-LcewgCST2hqysSGdEJP)

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

![](/files/-LcexmNFHhNPlZmLNTUO)

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

![](/files/-LmA-S-ZnnpsvVgH_Z79)

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

![](/files/-Lcf-S4uBi187xVhJdoq)

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

![](/files/-LmiRBQU1aFa6gvYI6V0)

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

![](/files/-Lcf1PvnoAL_LfiD9b3L)

### 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".

![](/files/-Lcf2ClzYAH81MZTQBVK)

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

{% hint style="success" %}

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

{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blinger.io/documentation/integrations/intercom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
