Перейти к основному содержимому
Версия: 4.8

Установка кода виджета IQChannels на сайте

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

Принцип работы

Виджет состоит из двух частей:

  • Подключаемый JavaScript с API для работы с виджетом.
  • Виджет, который открывается в скрытом айфрейме поверх сайта.

На сайт устанавливается скрипт API, который после инициализации добавляет скрытый iFrame c виджетом. API предоставляет простой интерфейс по управлению виджетом, открыть, закрыть и т.д.

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

1. Устоновка IQChannels* Предположим, IQChannels установлен и доступен по адресу http://localhost:3001/ * Пример виджета можно посмотреть по адресу http://localhost:3001/widget/example.html
2. Размещение скрипта на сайте2.1. Загрузка API виджета Для этого в тег HEAD добавляем: <script type="text/javascript" src="http://localhost:3001/widget/widget.min.js"></script> 2.2. Инициализация виджета Виджет может быть инициализирован как анонимный (для размещения на любом сайте без авторизации), либо в защищенном режиме, если он встраивается личный кабинет, защищенный паролем (интернет-банк). 2.2.1. Защищенная зона (интернет-банк) Для инициализации виджета необходимо знать название канала для подключения и авторизационные данные клиента. Далее в любом месте тега BODY вставляем скрипт: <script type="text/javascript"> var widget = new IQChannelsWidget({ channel: 'support', credentials: 'user-token', mode: 'web' }); </script> Где: * channel — имя канала для подключения (тип канала в IQChannels должен быть Веб / мобильный). * credentials — авторизационные данные для авторизации клиента в iSimpleBank. После этого виджет полностью готов к работе. Важно При вызоде клиента из защищенной зоны (разлогинивание), важно вызвать метод logout() у виджета, подробнее ниже. 2.2.2. Анонимная версия (сайт) Инициализация полностью идентична, за исключением: * Параметр credentials необходимо оставить пустым, либо не передавать вообще. * Тип канала в IQChannels должен быть Веб — анонимный. * Вызывать метод logout() виджета не нужно. Анонимные клиенты имеют возможность самостоятельно разлогиниться и удалить историю перепискииз их браузера. Например: <script type="text/javascript"> var widget = new IQChannelsWidget({ channel: 'support' }); </script>
3. Запрашиваем разрешение у сисадминовЧтобы они внесли URL сайта в файл config – после этого чат отобразится на вашем сайте. Можно уже пользоваться.
4. Проверка работы
5. Настройка и стилизация виджетаПодробнее
6. Настройка пушей для Android и iOSПодробнее