> For the complete documentation index, see [llms.txt](https://help.blinger.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blinger.io/documentation/integrations/intercom.md).

# 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

![](/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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.