Перейти к основному контенту

Инструкция по установке чат-виджета на веб-сайт

1. Добавить код перед закрывающим тегом </head>:

<script src="https://{{код-скрипта}}.js" async></script> 

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

2. Добавить код инициализации чат-виджета:

Место в коде, в которое необходимо добавить методы инициализации зависит от "движка" вашего фронтенда.

Если у вас SPA (Single Page Application), то виджет должен инициализироваться не в момент готовности DOM модели, а после того как сайт «отрисован».

Существует два режима работы с чат-виджетом.

  • С передачей роли пользователя — это необходимо, когда вы хотите для каждой роли показывать разные стартовые меню и сценарии чат-бота;
  • Без передачи роли пользователя — используйте этот режим, когда вам не важно разделение на роли на старте чат-бота.

3. Добавьте код установки роли пользователя:

setWidgetRole("<<Код роли>>")

Примеры:

setWidgetRole("admin"); // Устанавливает роль администратора
setWidgetRole("dealer"); // Устанавливает роль дилера
setWidgetRole("employee"); // Устанавливает роль сотрудника

4. Добавьте код сброса роли:

setWidgetRole();

5. Инициализируйте виджет:

initMetabotWidget()

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

Описание методов

Метод Описание Примеры
setWidgetRole() 

Метод для передачи кода роли пользователя.


Передача кода происходит путем вызова функции с соответствующим параметром.  


Роль передается на платформу и фиксируется в атрибут лида "название" (на примере, атрибут/персона = "роль")

setWidgetRole(«Код роли»)


Где код роли может принимать строковое значение, например:

  • ‘admin’ — администратор;
  • ‘dealer’ — дилер;
  • ‘employee’ — сотрудник.
initMetabotWidget() Функция инициализации виджета. Выполняется в самом конце.