> 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/guide/sait/onlain-chaty.md).

# Онлайн Чаты

Раздел **«Настройки онлайн-чата»** позволяет подключить виджет поддержки на клиентском сайте, выбрать сервис и настроить автоматическую передачу событий и данных заявки в iEXChat или JivoSite.

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

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2FfxAGCRyy50ZTvALXTMMl%2Fimage.png?alt=media&amp;token=a354b4a0-0e20-4191-a938-fff91aa1006d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Встроенная переписка внутри заявки настраивается отдельно. Для её подключения используйте инструкцию
{% endhint %}

{% content-ref url="/pages/lMIehRnAnYlIjzvcS3x0" %}
[Онлайн чат в заявке](/guide/sait/onlain-chaty/onlain-chat-v-zayavke.md)
{% endcontent-ref %}

### Доступ к настройкам

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

Для просмотра, изменения и включения HTML или JavaScript дополнительно требуется разрешение **«Пользовательский код онлайн-чата»**. Без него редактор вставки недоступен и включить сохранённый пользовательский код нельзя.

Сотрудник с общим разрешением может выключить виджет, даже если у него нет права на пользовательский код.

***

## Подключение онлайн-чата на сайте

На вкладке **«Онлайн чат»** выберите сервис, через который посетители будут обращаться в поддержку.

Для подключения понадобятся данные из этого сервиса: идентификатор виджета либо готовый HTML или JavaScript. В разделе одновременно используется один выбранный тип подключения.

### Порядок подключения

{% stepper %}
{% step %}

#### Включите виджет и выберите сервис

Включите **«Включить онлайн чат»**.

В поле **«Тип онлайн чата»** выберите способ подключения. После выбора появятся соответствующие поля.

Если меняете ранее подключённый сервис, проверьте идентификаторы во всех используемых языках: они должны относиться к новому подключению.
{% endstep %}

{% step %}

#### Заполните параметры подключения

Укажите идентификатор или код выбранного сервиса. Требования к каждому варианту приведены ниже.

Для iEXChat дополнительно потребуется полный адрес скрипта виджета.
{% endstep %}

{% step %}

#### Настройте автоматические действия

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

Для JivoSite откройте **«Опции для Jivosite»**, выберите момент отправки сообщения и заполните его текст.

Эти настройки подробно описаны в соответствующих частях инструкции.
{% endstep %}

{% step %}

#### Сохраните подключение

Нажмите **«Сохранить»** и дождитесь завершения.

Обновите клиентскую страницу и проверьте, что виджет появился и открывается. Повторите проверку для используемых языковых версий сайта.
{% endstep %}
{% endstepper %}

### Параметры выбранного сервиса

{% tabs %}
{% tab title="iEXChat" %}
Выберите **«iEXChat»**.

В поле **«Site Public ID»** укажите публичный идентификатор сайта, полученный в iEXChat.

В поле **«Адрес скрипта чата»** укажите полный адрес загрузчика вашего виджета. Он должен вести на скрипт `widget.js`. Адрес административной панели сервиса для этого поля не подходит.

Передачей событий и данных управляет вкладка **«Опции для iEXChat»**. В виджет также передаётся текущий язык клиентского сайта.
{% endtab %}

{% tab title="JivoSite" %}
Выберите **«JivoSite»** и заполните **«App ID»** идентификатором виджета.

Для стандартного подключения это часть адреса скрипта после `https://code.jivo.ru/widget/`. Полный адрес и тег `<script>` в поле вставлять не нужно.

Автоматическое сообщение о заявке настраивается во вкладке **«Опции для Jivosite»**.
{% endtab %}

{% tab title="Пользовательский код" %}
Выберите **«Пользовательский код»**, чтобы подключить виджет готовой HTML- или JavaScript-вставкой.

Вместо поля идентификатора появится редактор. Код и формат можно задать отдельно для каждого языка.

Подробный порядок работы описан в части **«Пользовательский код онлайн-чата»**.
{% endtab %}
{% endtabs %}

### Языковые версии подключения

Поля **«App ID»** и **«Site Public ID»** заполняются по языкам. Переключайте языковые вкладки и указывайте идентификаторы для соответствующих версий сайта.

Если используется одно подключение, укажите один и тот же идентификатор в нужных языках.

{% hint style="warning" %}
Идентификаторы копируются без перевода и произвольных изменений. Не применяйте к ним автоперевод и не вставляйте вместо них пароль, секретный API-ключ или полный HTML-код виджета.
{% endhint %}

Настройки сотрудников, оформление виджета и другие возможности самого сервиса управляются в его интерфейсе. На этой странице настраивается подключение и предусмотренная интеграцией передача данных.

## Опции для iEXChat

Вкладка **«Опции для iEXChat»** появляется при выборе iEXChat и управляет автоматической передачей информации из обменника.

Для работы интеграции должны быть включены онлайн-чат, выбран тип **«iEXChat»** и заполнены параметры подключения.

### Разрешение передачи

Главный переключатель — **«Передавать события и данные»**.

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

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

### События заявки и выбор направления

Включите события, которые нужны поддержке:

* **«Новые заявки»** — отправляет событие и сообщение после успешного создания заявки.
* **«Клиент нажал «Я оплатил»»** — отправляет событие и сообщение после успешного выполнения клиентом этого действия.
* **«Статусы заявок»** — передаёт текущий статус и его изменения при просмотре доступной клиенту заявки на сайте.
* **«Выбор направления обмена»** — передаёт выбранную пару валют и доступные суммы из формы обмена.

{% hint style="warning" %}
Событие **«Клиент нажал «Я оплатил»»** отражает действие клиента. Оно не подтверждает проверку платежа или фактическое поступление денег.
{% endhint %}

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

Статусы обновляются при просмотре заявки на клиентском сайте. Эта настройка не является фоновой рассылкой всех изменений всех заявок.

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

### Сведения о клиенте и реквизиты

Параметр **«Имя и email клиента»** добавляет сведения из профиля клиента к передаваемым данным и сообщениям заявки.

Параметр **«Карточка заявки и реквизиты»** разрешает передачу расширенной карточки: идентификаторов и даты создания заявки, сведений об обмене, счетов, дополнительных полей и города при его наличии.

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

Настройки действуют отдельно. Чтобы ограничить и профильные данные, и реквизиты, выключите оба соответствующих параметра.

{% hint style="info" %}
Выключение передачи не удаляет сведения, уже отправленные в iEXChat. Оно также не запрещает клиенту самостоятельно написать эти данные в сообщении.
{% endhint %}

### Автоматическое открытие чата

Параметр **«Автоматически открывать чат»** открывает окно после разрешённых событий создания заявки и нажатия **«Я оплатил»**.

Он работает вместе с настройками событий. Если соответствующее событие выключено, автоматическое открытие его не запускает.

Если событие включено, а автоматическое открытие выключено, данные и сообщение передаются без команды открытия окна.

## Опции для Jivosite

Вкладка **«Опции для Jivosite»** доступна при включённом онлайн-чате и выбранном типе **«JivoSite»**.

Здесь определяется, когда отправлять сообщение о заявке, какой текст использовать и нужно ли передавать сведения о клиенте.

### Когда отправлять сообщение

В поле **«Разрешить отправить сообщение в чат о новой заявке»** выберите один вариант:

* **«Нет»** — автоматическая отправка выключена.
* **«Да, при создании заявки»** — сообщение отправляется после успешного создания заявки.
* **«Да, при нажатии кнопки "Я оплатил"»** — сообщение отправляется после успешного выполнения клиентом этого действия.

Одновременно выбрать оба события нельзя.

При разрешённой отправке появляются поле шаблона и настройка передачи данных клиента. После обработки выбранного события интеграция также открывает окно JivoSite.

### Текст сообщения и языки

В поле **«Текст сообщения о новой заявке»** подготовьте текст для каждого используемого языка сайта.

Сообщение может содержать обычный текст и теги. Перед отправкой теги заменяются данными соответствующей заявки.

Не оставляйте шаблон пустым: в таком случае используется служебный текст `empty`.

Итоговое сообщение отправляется как обычный текст и ограничивается **2 000 символами после подстановки данных**. Учитывайте длину дополнительных полей, чтобы важная информация не оказалась в обрезанной части.

#### Вставка тегов

Установите курсор в нужное место сообщения и откройте **«Доступные теги»**.

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

Панель также показывает количество найденных и использованных тегов.

<table><thead><tr><th width="235.6953125">Тег</th><th>Подставляемое значение</th></tr></thead><tbody><tr><td><code>[id]</code></td><td>Номер заявки в системе</td></tr><tr><td><code>[publicId]</code></td><td>Публичный номер заявки</td></tr><tr><td><code>[currencyIn]</code></td><td>Название валюты «Отдаю»</td></tr><tr><td><code>[currencyOut]</code></td><td>Название валюты «Получаю»</td></tr><tr><td><code>[amountIn]</code></td><td>Сумма «Отдаю»</td></tr><tr><td><code>[amountOut]</code></td><td>Сумма «Получаю»</td></tr><tr><td><code>[codeIn]</code></td><td>Код валюты «Отдаю»</td></tr><tr><td><code>[codeOut]</code></td><td>Код валюты «Получаю»</td></tr><tr><td><code>[shotIn]</code></td><td>Номер счёта «Отдаю»</td></tr><tr><td><code>[shotOut]</code></td><td>Номер счёта «Получаю»</td></tr><tr><td><code>[fieldsIn]</code></td><td>Дополнительные поля «Отдаю»</td></tr><tr><td><code>[fieldsOut]</code></td><td>Дополнительные поля «Получаю»</td></tr></tbody></table>

При ручном вводе сохраняйте квадратные скобки и регистр букв. Теги `[shotIn]` и `[shotOut]` записываются именно в таком виде.

Если данные отсутствуют в заявке, тег не создаёт их автоматически. Дополнительные поля передаются как заполненные пары «название поля: значение».

#### Автоперевод сообщения

Если в системе включён автоперевод редакторов и доступны другие языки, можно использовать **«Автоперевод на другие языки»**.

Исходным становится текст выбранной языковой вкладки. Перед запуском заполните его и проверьте теги.

{% hint style="warning" %}
Если в настройках AI разрешена перезапись переводов, автоперевод может заменить уже заполненные тексты других языков. После завершения проверьте переводы и написание тегов перед сохранением.
{% endhint %}

Результат перевода остаётся в форме до нажатия **«Сохранить»**.

### Информация о клиенте

Настройка **«Разрешить отправить информацию о клиенте в чат»** передаёт в контакт JivoSite имя и email из профиля, если эти сведения доступны.

Она действует отдельно от содержимого сообщения.

{% hint style="warning" %}
Теги счетов и дополнительных полей передают соответствующие данные в JivoSite независимо от переключателя передачи имени и email. Перед включением автоматической отправки проверьте состав шаблона.
{% endhint %}

***

## Пользовательский код онлайн-чата

Тип **«Пользовательский код»** предназначен для подключения виджета готовой HTML- или JavaScript-вставкой из сервиса поддержки.

Для каждого языка отдельно сохраняются код, формат и предыдущая сохранённая версия. В административном редакторе код не выполняется.

{% hint style="warning" %}
Пользовательский код запускается на клиентском сайте и может обращаться к содержимому его страниц. Используйте вставку доверенного сервиса. Не размещайте в ней пароли, секретные API-ключи и другие сведения, которые не должны быть доступны посетителям.
{% endhint %}

### Добавление кода

На вкладке **«Онлайн чат»** выберите **«Пользовательский код»**.

В блоке **«Код виджета»** откройте нужную языковую вкладку. В поле **«Формат вставки»** укажите формат полученного кода:

* **HTML** — готовая вставка с тегами `<script>`, HTML-разметкой и стилями.
* **JavaScript** — исполняемый JavaScript без внешних тегов `<script>` и `</script>`.

Сохраните весь необходимый комплект кода: отдельные скрипты, разметка и стили могут зависеть друг от друга.

Вставьте текст в редактор или воспользуйтесь **«Загрузить из файла»**. Затем заполните другие языковые версии, если для них нужны отдельные подключения.

Для применения включите **«Включить онлайн чат»** и нажмите **«Сохранить»**.

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

### Загрузка из файла

Кнопка **«Загрузить из файла»** читает содержимое в редактор выбранного языка.

Поддерживаются текстовые файлы:

* `.html` и `.htm` — выбирается HTML;
* `.js` — выбирается JavaScript;
* `.txt` — формат определяется по началу содержимого.

Используйте кодировку **UTF-8**.

Чтение файла заменяет текущий код выбранной языковой вкладки в черновике. Во время чтения редактор и сохранение временно недоступны.

На сайт изменение попадёт только после сохранения всей формы.

{% hint style="info" %}
Сохраняется содержимое файла, а не ссылка на него. Последующие изменения файла на компьютере не обновляют виджет: изменённый текст нужно прочитать и сохранить повторно.
{% endhint %}

### Размер и обработка вставки

Максимальный размер кода — **256 КБ для одной языковой версии**. Размер рассчитывается по объёму текста в UTF-8 и отображается под редактором.

Для файла лимит также проверяется до чтения. При превышении появляется сообщение **«Код чата не должен превышать 256 КБ.»**.

При вставке в пустое поле или замене всего содержимого редактор определяет формат и может удалить внешнее оформление сообщения, например ограждения блока кода Markdown.

Для распознанной повреждённой HTML-вставки также могут исправляться лишние экранирования и Markdown-оформление адресов. После обработки появляется уведомление **«Удалено форматирование сообщения»**.

Кнопка **«Отменить обработку»** возвращает исходный текст до преобразования. При частичной вставке внутрь заполненного поля обработка всего кода не выполняется.

Автоматическая обработка не проверяет работоспособность виджета и не исправляет произвольные ошибки JavaScript. Перед сохранением сравните результат с исходной вставкой сервиса.

### Языковые версии

Посетитель получает код текущего языка сайта. Если соответствующая вкладка пустая, используется код основного языка.

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

{% hint style="info" %}
Пустая языковая вкладка не отключает чат для этого языка, если заполнен основной язык сайта.
{% endhint %}

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

Формат также относится к выбранной языковой вкладке: HTML одного языка не требует такого же формата в остальных.

Языки редактора соответствуют языкам клиентского сайта. Смена языка административного интерфейса сама по себе не определяет, какую вставку получит посетитель.

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

### Применение изменений

Код подключается при загрузке клиентской страницы. Переходы внутри сайта не предназначены для повторного запуска той же вставки.

После изменения, восстановления или отключения кода полностью обновите страницу.

{% hint style="warning" %}
Отключение настройки не останавливает код, который уже запущен в открытой вкладке посетителя. Для проверки отключения нужна перезагрузка страницы.
{% endhint %}

Пользовательская вставка не включает автоматически события из вкладок iEXChat или JivoSite. Эти настройки работают со своими выбранными типами интеграции.

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

Кнопка **«Сохранить»** в верхней части страницы применяет изменения формы. До сохранения изменения полей, переключателей и языковых версий остаются в редакторе.

После успешного завершения обновите клиентскую страницу. Это необходимо для проверки нового сервиса, идентификатора, пользовательского кода и параметров передачи данных.

### Проверка результата

Проверьте настроенные возможности:

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

Проверку создания заявки и действия **«Я оплатил»** проводите в тестовом сценарии. Не меняйте состояние рабочей заявки только ради проверки интеграции.

<details>

<summary>Если настройки не загружаются или не сохраняются</summary>

При сообщении **«Не удалось загрузить настройки чата. Повторите попытку.»** нажмите **«Повторить загрузку»**.

Кнопка сохранения временно недоступна во время первоначальной загрузки, чтения файла или предыдущего сохранения. Дождитесь завершения операции.

Если сохранение завершилось ошибкой, прочитайте сообщение у поля или уведомление об ошибке. Исправьте указанное значение и повторите сохранение. Наличие изменений в редакторе само по себе не подтверждает, что они применены.

Для пользовательского кода проверьте отдельное разрешение, размер вставки и наличие кода активного языка. Если не читается файл, используйте текстовый файл в UTF-8.

</details>

<details>

<summary>Если виджет не появился</summary>

Сначала убедитесь, что настройки сохранены и клиентская страница полностью обновлена.

Проверьте включение онлайн-чата, выбранный сервис и идентификатор нужного языка. Для iEXChat дополнительно проверьте адрес скрипта.

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

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

</details>

<details>

<summary>Если автоматические события не передаются</summary>

Если сам виджет работает, проверьте параметры соответствующей интеграции.

В iEXChat должны быть включены **«Передавать события и данные»** и нужное событие. Для открытия окна требуется также **«Автоматически открывать чат»**. Передачу статусов проверяйте при просмотре доступной клиенту заявки на сайте.

В JivoSite должен быть выбран нужный момент отправки и заполнен текст сообщения соответствующего языка. Если вместо описания заявки приходит `empty`, заполните **«Текст сообщения о новой заявке»**.

</details>


---

# 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/guide/sait/onlain-chaty.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.