> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/platezhi-integracii-i-uvedomleniya/integrations/online-chat/intercom.md).

# Подключение Intercom

iEXExchanger подключает Intercom Messenger по Workspace ID, который в коде Intercom называется `app_id`. Стандартное подключение показывает публичный виджет посетителю; оно не передаёт автоматически заявку, профиль клиента или секретные данные.

## Подготовка workspace

1. Создайте workspace Intercom на аккаунт организации.
2. Настройте название для клиентов, часовой пояс и поддерживаемые языки.
3. Пригласите сотрудников отдельными учётными записями и минимальными ролями.
4. Настройте Inbox, распределение, рабочее время и ожидаемое время ответа.
5. Оформите Messenger и добавьте ссылку на политику конфиденциальности.
6. Определите, могут ли писать все посетители или только выбранные аудитории.
7. Настройте уведомления и резервный канал поддержки.

Обзор Messenger и работы через Inbox приведён в [официальной справке Intercom](https://www.intercom.com/help/en/articles/316-the-intercom-messenger-in-your-product-and-on-your-website).

## Как получить App ID

Откройте нужный workspace. App ID находится:

* в адресе workspace сразу после `/a/apps/`;
* в **Settings — Workspace — General** в сведениях workspace.

Скопируйте только строку идентификатора. Intercom описывает оба способа в [Getting started FAQs](https://www.intercom.com/help/en/articles/8771110-getting-started-faqs).

Не используйте ID тестового workspace на рабочем домене. Один App ID можно загрузить на нескольких доменах, но история посетителя на разных доменах может не объединяться из-за доменных cookies.

## Доверенные домены

В настройках Messenger откройте **General — Keep your Messenger secure** и добавьте точные домены, на которых должен работать виджет. Пустой список позволяет разместить Messenger на любом домене. Правила и wildcard описаны в [официальной инструкции Intercom](https://www.intercom.com/help/en/articles/4418-list-trusted-domains-you-use-with-your-messenger).

Для обычного клиентского сайта укажите точное имя без протокола и пути. Добавляйте wildcard только при необходимости всех поддоменов. Не включайте `app.ваш_домен`, если чат не должен появляться в панели управления.

## Настройка в iEXExchanger

Откройте:

**«Настройки» — «Общие настройки» — «Дополнительно» — «Онлайн чат»**

1. Включите онлайн-чат.
2. Выберите тип «InterCom».
3. Вставьте App ID в поле каждой используемой локали.
4. Не вставляйте JavaScript snippet или URL loader.
5. Сохраните настройку.

Клиентский сайт загрузит Messenger как виджет для посетителя. Если требуется надёжно связывать авторизованного клиента iEXExchanger с пользователем Intercom, передавать атрибуты или применять JWT-защиту, это отдельная разработка клиентской и серверной частей. Одного App ID для такой идентификации недостаточно.

## Конфиденциальность и cookies

Intercom создаёт cookies на домене клиентского сайта и обрабатывает содержание диалога. Согласуйте загрузку виджета с политикой cookies, требованиями региона и договором с поставщиком. Не передавайте через чат реквизиты, ключи, документы или полные данные заявки без утверждённого процесса.

Официальное описание cookies Messenger находится в [справке Intercom](https://www.intercom.com/help/en/articles/2361922-intercom-messenger-cookies).

## Проверка

1. Откройте каждую локаль в приватном окне.
2. Проверьте загрузку Messenger на разрешённом домене.
3. Отправьте сообщение и ответьте из нужного Inbox.
4. Проверьте рабочее время и офлайн-сценарий.
5. Проверьте виджет с разрешёнными cookies и без согласия по вашей политике.
6. Убедитесь, что виджет не появляется на постороннем домене.
7. Проверьте мобильный экран и отсутствие перекрытия кнопок заявки.

Ошибка 403 обычно связана с trusted domains или включённой проверкой идентичности без требуемых данных. Также проверьте App ID, блокировщик, CSP и браузерную консоль. Официальный разбор находится в [инструкции Intercom по отсутствующему Messenger](https://www.intercom.com/help/en/articles/2546256-troubleshooting-when-the-messenger-doesn-t-appear).


---

# 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://docs.iexexchanger.com/learn/platezhi-integracii-i-uvedomleniya/integrations/online-chat/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.
