For the complete documentation index, see llms.txt. This page is also available as Markdown.
new

Онлайн Чаты

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

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

Доступны следующие типы подключения:

  • iEXChat;

  • JivoSite;

  • InterCom;

  • Tawk;

  • Talk-me;

  • Пользовательский код.

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

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

Где находятся настройки

Откройте панель управления и перейдите: «Настройки» — «Общие настройки» — «Дополнительно» — «Онлайн чат»

Права доступа

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

Права группы находятся по пути: «Пользователи» — «Список групп пользователей»

Группы прав пользователей

Для просмотра, изменения и включения собственной HTML- или JavaScript-вставки дополнительно требуется право «Пользовательский код онлайн-чата» из блока «Заявки».

Общее право настроек не заменяет это дополнительное разрешение.

Вкладки раздела

Вкладка
Когда доступна
Назначение

«Онлайн чат»

При доступе к разделу

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

«Чат в заявках»

При доступе к разделу

Настройка встроенной переписки клиента и оператора по конкретной заявке

«Опции для iEXChat»

При выбранном типе «iEXChat»

События, данные клиента, карточка заявки и открытие окна

«Опции для Jivosite»

При включённом онлайн-чате и выбранном типе «JivoSite»

Событие отправки, шаблон сообщения и контактные данные клиента

Настройки общего виджета выполняются во вкладке «Онлайн чат». Переписка внутри заявки настраивается во вкладке «Чат в заявках».


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

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

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

1

Подготовьте подключение в сервисе

В аккаунте сервиса создайте или выберите виджет для клиентского сайта.

Получите его идентификатор. Для iEXChat подготовьте Site Public ID и полный адрес скрипта виджета.

Если сервис ограничивает список сайтов, добавьте разрешённый домен клиентской части, например https://ваш_домен.

Убедитесь, что сотрудники поддержки имеют доступ к нужному проекту или виджету.

2

Включите онлайн-чат и выберите тип

Откройте вкладку «Онлайн чат».

Включите «Включить онлайн чат» и выберите сервис в поле «Тип онлайн чата».

После выбора появятся соответствующие поля подключения.

В этом разделе одновременно используется один выбранный тип.

3

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

Укажите идентификатор выбранного сервиса в поле «App ID» или «Site Public ID».

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

Для iEXChat заполните «Адрес скрипта чата».

Для подключения готовым кодом перейдите к инструкции «Пользовательский код онлайн-чата».

4

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

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

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

У InterCom, Tawk и Talk-me отдельной вкладки автоматических событий заявки в этом разделе нет. Возможности самого виджета настраиваются в аккаунте соответствующего сервиса.

5

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

Нажмите «Сохранить» в верхней части страницы и дождитесь завершения операции.

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

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

Параметры стандартных сервисов

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

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

Выберите «iEXChat» в поле «Тип онлайн чата».

Заполните:

Поле
Что указать

«Site Public ID»

Публичный идентификатор сайта из iEXChat

«Адрес скрипта чата»

Полный HTTPS-адрес скрипта виджета, полученный для вашего подключения

Site Public ID заполняется по языкам. Адрес скрипта указывается один раз для всего сайта.

Обычно адрес скрипта заканчивается на /widget.js. Используйте адрес из настроек вашего проекта iEXChat. Адрес панели управления сервиса для этого поля не подходит.

После выбора типа появится вкладка «Опции для iEXChat».

В интерфейс виджета также передаётся выбранный язык клиентского сайта.

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

Выберите «JivoSite» и заполните «App ID» идентификатором виджета.

Для стандартного подключения идентификатор — это часть адреса скрипта после:

https://code.jivo.ru/widget/

Например, если в коде подключения указан адрес:

https://code.jivo.ru/widget/ВАШ_ID

в поле «App ID» нужно вставить только:

ВАШ_ID

Идентификатор задаётся для нужных языковых версий сайта.

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

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

Выберите «InterCom» и заполните «App ID» идентификатором рабочего пространства Intercom.

В коде подключения сервиса этот идентификатор обозначается как app_id. В стандартном адресе загрузки он находится после:

https://widget.intercom.io/widget/

Вставляйте только идентификатор рабочего пространства.

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

Оформление, приветствия и правила работы Messenger настраиваются в Intercom.

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

Выберите «Tawk».

В поле «App ID» укажите часть адреса подключения после:

https://embed.tawk.to/

Для этого типа подключения значение обычно содержит два идентификатора через /:

Используйте значения выбранного проекта и виджета из аккаунта tawk.to. Одного Property ID для такого адреса недостаточно.

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

Оформление, язык самого виджета и правила его показа настраиваются в tawk.to.

Подключение Talk-me

Выберите «Talk-me» и укажите в поле «App ID» идентификатор подключения, предназначенный для стандартного виджета.

Заполните нужные языковые вкладки.

Если аккаунт Talk-me предоставляет готовую вставку со своим загрузчиком, дополнительными командами или несколькими скриптами, используйте тип «Пользовательский код» и сохраните полный код по отдельной инструкции.

Полную вставку нельзя помещать в поле «App ID».

Оформление, сотрудники поддержки и правила показа виджета управляются в Talk-me.

Автоматическая передача событий обменника предусмотрена для выбранных типов iEXChat и JivoSite. Выбор другого сервиса или пользовательской вставки не подключает к нему эти события автоматически.

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

Языковые вкладки позволяют использовать разные подключения и тексты в разных версиях клиентского сайта.

Настройка
Как задаётся

«App ID» и «Site Public ID»

Отдельно для каждого языка

«Адрес скрипта чата» для iEXChat

Один адрес для всего сайта

Тип сервиса и переключатели автоматических действий

Общие для сайта

«Текст сообщения о новой заявке» для JivoSite

Отдельно для каждого языка

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

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

Что происходит при пустом языковом поле

Для стандартных идентификаторов и текста JivoSite система сначала использует значение текущего языка.

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

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

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

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

Опции для iEXChat

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

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

Передавать события и данные

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

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

При выключении:

  • автоматическая передача прекращается;

  • зависимые переключатели становятся недоступны для изменения;

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

Сам виджет остаётся доступен для ручного общения, если «Включить онлайн чат» включён.

Синхронизация языка виджета также не зависит от разрешения передачи событий.

События

Переключатель
Что передаётся

«Новые заявки»

Событие и сообщение после успешного создания заявки

Клиент нажал «Я оплатил»

Событие и сообщение после успешного выполнения клиентом этого действия

«Статусы заявок»

Текущий статус и его изменения при просмотре клиентом своей заявки

«Выбор направления обмена»

Выбранная пара валют и доступные на момент события суммы

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

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

Особенности передачи статусов

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

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

Для получения обновлений клиентская страница должна быть открыта. Эта опция не выполняет фоновую рассылку всех изменений всех заявок.

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

Особенности передачи направления

Направление может передаваться ещё до создания заявки.

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

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

Имя и email клиента

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

Если эти сведения отсутствуют, настройка не создаёт их автоматически.

При выключении имя и email из профиля исключаются из предусмотренной интеграцией передачи. Состав дополнительных полей заявки контролируется отдельно.

Карточка заявки и реквизиты

Переключатель «Карточка заявки и реквизиты» разрешает передачу расширенного контекста заявки.

В него могут входить:

  • идентификаторы и время создания заявки;

  • направление, валюты и суммы;

  • текущий статус;

  • счета сторон обмена;

  • текстовые дополнительные поля;

  • город, если он указан;

  • адрес текущей страницы.

Файлы не прикрепляются к передаваемой карточке. Адрес страницы передаётся без параметров запроса и фрагмента.

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

«Имя и email клиента» и «Карточка заявки и реквизиты» работают отдельно. Чтобы ограничить оба вида данных, выключите оба переключателя.

Изменение разрешений ограничивает последующую передачу. Уже отправленные сведения остаются в сервисе поддержки согласно его правилам хранения.

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

Переключатель «Автоматически открывать чат» разрешает обменнику открывать окно после включённых событий:

  • создания заявки;

  • нажатия «Я оплатил».

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

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

Обновление статуса и выбор направления сами по себе эту команду не запускают.

Примеры настройки

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

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

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

После изменения параметров нажмите «Сохранить» и полностью обновите клиентскую страницу.

Опции для JivoSite

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

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

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

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

Значение
Поведение

«Нет»

Автоматическая отправка выключена

«Да, при создании заявки»

Сообщение отправляется после успешного создания заявки

«Да, при нажатии кнопки "Я оплатил"»

Сообщение отправляется после успешного выполнения клиентом этого действия

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

При выборе автоматической отправки появляются поле текста сообщения и настройка передачи информации о клиенте.

После обработки выбранного события интеграция также отправляет команду открытия окна JivoSite.

Режим «Нет» отключает предусмотренные этим разделом автоматические действия. Ручное общение через подключённый виджет остаётся доступным.

Текст сообщения о новой заявке

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

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

Сообщение передаётся как обычный текст. HTML-разметка не используется для оформления.

Итоговая длина ограничивается 2 000 символами после подстановки данных. Длинные дополнительные поля могут занять значительную часть сообщения.

Пример сообщения

Этот пример содержит основные сведения об обмене. Добавьте счета или дополнительные поля только при необходимости.

Доступные теги

Тег
Подставляемое значение

[id]

Номер заявки в системе

[publicId]

Публичный номер заявки

[currencyIn]

Название валюты «Отдаю»

[currencyOut]

Название валюты «Получаю»

[amountIn]

Сумма «Отдаю»

[amountOut]

Сумма «Получаю»

[codeIn]

Код валюты «Отдаю»

[codeOut]

Код валюты «Получаю»

[shotIn]

Номер счёта «Отдаю»

[shotOut]

Номер счёта «Получаю»

[fieldsIn]

Дополнительные поля «Отдаю»

[fieldsOut]

Дополнительные поля «Получаю»

Теги [shotIn] и [shotOut] записываются именно в таком виде.

Если соответствующие данные отсутствуют в заявке, тег не создаёт их автоматически.

Дополнительные поля передаются как заполненные пары «название поля: значение».

Вставка через панель тегов

  1. Выберите языковую вкладку сообщения.

  2. Установите курсор в место вставки.

  3. Откройте «Доступные теги».

  4. Найдите тег по обозначению или описанию.

  5. Нажмите на тег для вставки.

Если в сообщении выделен фрагмент, вставленный тег заменит выделение.

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

При ручном вводе сохраняйте квадратные скобки и регистр букв.

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

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

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

Перед сохранением проверьте, какие данные включены в шаблон.

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

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

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

1

Подготовьте исходный текст

Выберите язык, на котором будете составлять сообщение.

Заполните текст и вставьте необходимые теги.

2

Запустите автоперевод

Нажмите «Автоперевод на другие языки» и дождитесь завершения.

Состав переводимых языков определяется языками, доступными в системе.

3

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

Откройте переведённые вкладки.

Проверьте смысл сообщения и убедитесь, что обозначения тегов сохранились без изменений.

4

Сохраните сообщения

Нажмите «Сохранить» на странице настроек.

До сохранения переводы остаются изменениями формы.

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

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

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

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

Для управления этим типом требуется отдельное право «Пользовательский код онлайн-чата».

Чат в заявках

Вкладка «Чат в заявках» относится к встроенной переписке по конкретному обмену.

Клиент общается на странице своей заявки. Оператор работает с перепиской из карточки заявки или через «Центр чатов».

На этой вкладке настраиваются:

  • включение чата;

  • статусы заявок, в которых он доступен;

  • разрешение клиентских вложений, их расширения и размер;

  • быстрые ответы оператора;

  • индикаторы переписки;

  • уведомления операторов в Telegram;

  • письма клиенту при ответе оператора.

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

Полный порядок настройки приведён в отдельной инструкции:

Онлайн чат в заявке

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

Проверяйте виджет на клиентском сайте, например https://ваш_домен.

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

1

Проверьте ручное общение

Полностью обновите клиентскую страницу.

Убедитесь, что виджет появился и открывается. Отправьте тестовое сообщение.

Проверьте, что оператор получил его в нужном проекте или аккаунте сервиса, и ответьте клиенту.

Повторите проверку для используемых языков.

2

Проверьте настроенные события

Для iEXChat проверьте включённые события:

  • выбор направления;

  • создание тестовой заявки;

  • нажатие «Я оплатил»;

  • изменение статуса при открытой клиентской странице заявки.

Для JivoSite выполните именно то действие, которое выбрано в настройках автоматической отправки.

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

3

Проверьте состав данных и открытие окна

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

Проверьте, что окно открывается согласно параметру «Автоматически открывать чат».

Для JivoSite проверьте текст сообщения, подстановку тегов и передачу контактных данных, если она включена.

4

Проверьте итоговую конфигурацию

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

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

Пользовательский код проверяйте по его отдельной инструкции.

Если что-то не работает

Раздел или пользовательский код недоступен сотруднику

Проверьте права группы пользователя.

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

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

Права находятся по пути «Пользователи» — «Список групп пользователей».

Подробности доступа к пользовательской вставке приведены в её отдельной инструкции.

Настройки не загружаются или не сохраняются

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

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

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

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

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

Виджет не появился на клиентском сайте

Проверьте:

  1. Настройки успешно сохранены.

  2. Клиентская страница полностью обновлена.

  3. «Включить онлайн чат» включён.

  4. Выбран нужный тип подключения.

  5. Идентификатор текущего языка относится к выбранному сервису.

  6. Для iEXChat указан корректный адрес скрипта и разрешён домен клиентского сайта.

  7. В аккаунте сервиса виджет включён и его правила допускают показ на этой странице.

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

Для типа «Пользовательский код» используйте диагностику из отдельной инструкции.

Используется другой виджет или неправильный язык

Проверьте идентификатор соответствующей языковой вкладки.

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

Для iEXChat язык интерфейса передаётся из клиентского сайта. У остальных сервисов проверьте настройки языка самого виджета в аккаунте сервиса.

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

iEXChat работает вручную, но события или карточка не передаются

Откройте «Опции для iEXChat».

Проверьте «Передавать события и данные» и переключатель нужного события.

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

Статусы проверяйте при открытой странице текущей заявки с подтверждённым доступом клиента к ней.

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

После сохранения полностью обновите клиентскую страницу и повторите тест.

JivoSite не отправляет сообщение или вместо текста приходит empty

Проверьте, что онлайн-чат включён и выбран тип «JivoSite».

Во вкладке «Опции для Jivosite» проверьте выбранное событие. Тестовое действие должно совпадать с ним.

Заполните «Текст сообщения о новой заявке» в используемых языках. Значение empty означает, что интеграция использовала служебный текст вместо заполненного шаблона.

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

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

В сообщении остались теги или отсутствует часть данных

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

Особенно проверьте [publicId], [shotIn] и [shotOut].

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

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

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

Последнее обновление

Это было полезно?