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

Настройка Intercom Messenger, Workspace ID, доверенных доменов и подключения к iEXExchanger

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

Точка входа в iEXExchanger: «Настройки» — «Общие настройки» — «Дополнительно» — «Онлайн чат». Для страницы требуется право «Разрешить управление онлайн чатом для заявок в админпанели» из блока «Заявки»; оно находится по пути «Пользователи» — «Список групп пользователей». Откройте нужную группу.

Подготовка workspace

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

Обзор Messenger и работы через Inbox приведён в официальной справке Intercom.

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

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

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

Скопируйте только строку идентификатора. Intercom описывает оба способа в Getting started FAQs.

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

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

В настройках Messenger откройте «General» — «Keep your Messenger secure» и добавьте точные домены, на которых должен работать виджет. Пустой список позволяет разместить Messenger на любом домене. Правила и wildcard описаны в официальной инструкции Intercom.

Для обычного клиентского сайта укажите точное имя без протокола и пути. Добавляйте 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.

Проверка

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

При ошибке 403 проверьте trusted domains и наличие данных для включённой проверки идентичности. Затем проверьте App ID, блокировщик, CSP и браузерную консоль. Официальный разбор находится в инструкции Intercom по отсутствующему Messenger.