> 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/knowledge-base/uvedomleniya-i-integracii/integrations/online-chat/iexchat.md).

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

Подключение iEXChat и точная настройка передаваемых событий и данных заявки

iEXChat — готовый тип публичного онлайн-чата. После подключения виджет получает выбранный язык сайта, направление обмена и разрешённый контекст текущей заявки, чтобы оператору не приходилось искать её вручную.

## Где находится

Откройте:

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

Основное подключение находится во вкладке «Онлайн чат». После выбора типа «iEXChat» рядом появляется отдельная вкладка «Опции для iEXChat».

Для раздела требуется право «Разрешить управление онлайн чатом для заявок в админпанели» из блока «Заявки». Право выдаётся по пути **«Пользователи» — «Список групп пользователей»**.

## Какие данные нужны

| Поле                 | Что указать                                                          |
| -------------------- | -------------------------------------------------------------------- |
| «Тип онлайн чата»    | «iEXChat»                                                            |
| «Site Public ID»     | Публичный идентификатор сайта из iEXChat; поле заполняется по языкам |
| «Адрес скрипта чата» | Полный HTTPS-адрес loader-скрипта iEXChat, выданный для вашего сайта |

Site Public ID не является секретным API-ключом, но он должен принадлежать именно вашему проекту. Не вставляйте в это поле полный код `<script>`. Адрес скрипта указывается один раз для всего сайта; языковые различия задаются значениями Site Public ID.

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

{% stepper %}
{% step %}

### Подготовьте сайт в iEXChat

Создайте проект, добавьте разрешённые домены клиентского сайта и получите Site Public ID и адрес loader-скрипта.
{% endstep %}

{% step %}

### Заполните панель

Включите «Включить онлайн чат», выберите «iEXChat», внесите Site Public ID для активных языков и укажите «Адрес скрипта чата».
{% endstep %}

{% step %}

### Выберите передаваемые данные

Откройте вкладку «Опции для iEXChat». Оставьте включёнными только те события и данные, которые нужны операторам и разрешены вашей политикой конфиденциальности.
{% endstep %}

{% step %}

### Сохраните настройки

Нажмите «Сохранить» и полностью обновите клиентский сайт. Не проверяйте подключение внутри панели: виджет загружается только на клиентской стороне.
{% endstep %}

{% step %}

### Проведите сквозной тест

Выберите направление, создайте тестовую заявку, нажмите «Я оплатил» и измените её статус предусмотренным способом. Сверьте карточку и ленту событий у оператора iEXChat.
{% endstep %}
{% endstepper %}

## Вкладка «Опции для iEXChat»

Все переключатели относятся только к автоматической передаче из обменника в iEXChat. Они не закрывают сам виджет и не запрещают клиенту написать оператору вручную.

| Переключатель                 | Что разрешает                                                                                                                                                   |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| «Передавать события и данные» | Главный выключатель всех автоматических событий и данных. При отключении зависимые переключатели становятся недоступными, но их выбранные значения сохраняются. |
| «Новые заявки»                | Передавать событие после успешного создания заявки.                                                                                                             |
| «Клиент нажал „Я оплатил“»    | Передавать событие после успешного подтверждения клиентом действия «Я оплатил».                                                                                 |
| «Статусы заявок»              | Передавать текущий статус и его изменение, когда клиент открывает доступную ему страницу заявки.                                                                |
| «Выбор направления обмена»    | Передавать выбранную посетителем пару валют ещё до создания заявки.                                                                                             |
| «Имя и email клиента»         | Добавлять имя и email в идентификацию клиента, карточку и текст события.                                                                                        |
| «Карточка заявки и реквизиты» | Добавлять суммы, валюты, платёжные реквизиты, дополнительные поля, город и другие данные карточки.                                                              |
| «Автоматически открывать чат» | Открывать окно чата после создания заявки и после подтверждения «Я оплатил».                                                                                    |

При отключённой опции «Карточка заявки и реквизиты» само разрешённое событие продолжает содержать минимальные сведения, необходимые для его распознавания: номер заявки, направление, суммы и статус. Опция «Имя и email клиента» управляет персональными данными отдельно.

Выбор сохраняется при временной смене типа онлайн-чата и повторном включении iEXChat. После возврата к iEXChat всё равно откройте вкладку и проверьте фактические значения: смена провайдера не является способом сбросить разрешения.

{% hint style="warning" %}
Изменение статуса передаётся при просмотре клиентом страницы заявки, а не отдельным серверным уведомлением при закрытой странице. Для фоновых уведомлений сотрудников используйте [центр уведомлений](/knowledge-base/uvedomleniya-i-integracii/notification-center.md).
{% endhint %}

## Какие события синхронизируются

При включённых соответствующих опциях клиентский сайт может передавать:

* выбранное направление обмена без персональных данных;
* создание заявки;
* нажатие клиентом «Я оплатил»;
* изменение состояния текущей заявки;
* переключение языка сайта для интерфейса виджета.

До загрузки самого виджета события могут ожидать во внутренней очереди. Одинаковое направление, тот же снимок заявки и уже переданное состояние не должны бесконечно добавляться повторно.

## Какие данные заявки видит оператор

Контекст заявки передаётся только для страницы, где система подтвердила право клиента изменять эту заявку. Одного знания публичной ссылки недостаточно. При включённых «Имя и email клиента» и «Карточка заявки и реквизиты» в разрешённый контекст могут входить:

* номер и состояние заявки;
* направление, валюты и суммы;
* имя и e-mail клиента, если они доступны в заявке;
* счета «Отдаёт» и «Получает»;
* текстовые дополнительные поля сторон обмена;
* город и время создания;
* адрес текущей страницы без параметров запроса и фрагмента.

Файлы и произвольные вложенные объекты в такой контекст не добавляются. Тем не менее подключение является передачей данных внешнему сервису: согласуйте состав полей, сроки хранения и уведомление клиента с вашей политикой конфиденциальности.

## Что проверить у оператора

1. Сообщение относится к правильному номеру заявки.
2. Направление и обе суммы совпадают с карточкой панели.
3. Событие «Я оплатил» не создаётся при обычном обновлении страницы.
4. Изменение состояния появляется один раз и относится к текущей заявке.
5. После переключения локали интерфейс виджета использует нужный язык.
6. Оператор видит только данные, согласованные вашей политикой.

## Если iEXChat недоступен

Ошибка внешнего виджета не должна прерывать выбор направления, создание заявки или подтверждение оплаты. Проверьте Site Public ID, HTTPS-адрес скрипта, разрешённые домены и блокировку браузером. Затем повторите тест в приватном окне без расширений.

Если виджет открылся, но карточка заявки пустая, проверьте «Передавать события и данные», «Карточка заявки и реквизиты» и «Имя и email клиента», затем убедитесь, что тест выполняется владельцем текущей заявки, а не только по старой публичной ссылке. После сохранения полностью обновите клиентский сайт.

Если автоматические события пропали, а ручной чат работает, это обычно означает, что главный переключатель или отдельное событие отключено. Если сообщения копятся дублями, зафиксируйте последовательность действий, номер заявки и время, не отправляя в поддержку секреты или платёжные реквизиты.