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

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

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

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

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

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

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

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

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

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

 

initMetabotWidget({ name: "<<Имя пользователя>>", email: "<<Email пользователя>>", company: "<<Название компании>>" })

Пример:

 

initMetabotWidget({ name: "Иван Иванов", email: "ivan.ivanov@company.ru", company: "ООО \"Деметра\"" })

Пример с динамическими данными пользователя:

setWidgetRole("<<КодinitMetabotWidget({ роли>>"name: user.fullName, email: user.email, company: user.companyName })

Примеры:

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

4. ДобавьтеПосле кодвыполнения сбросакода роли:

на

setWidgetRole();

странице

5.появится Инициализируйтеиконка виджет:

чата.

initMetabotWidget()

При

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

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

Метод

Описание

ПримерыПример

setWidgetRole() 

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

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

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

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

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

‘admin’ — администратор; ‘dealer’ — дилер; ‘employee’ — сотрудник.
initMetabotWidget()

Функция инициализации чат-виджета.

Выполняется

При взапуске самомметода:

конце.

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

initMetabotWidget({ name: user.fullName, email: user.email, company: user.companyName })

 

Формат передаваемых данных

   Поле Описание Тип   name Имя пользователя string   email Email пользователя string   company Название компании string  

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

 

function onUserLogin(user){ initMetabotWidget({ name: user.fullName, email: user.email, company: user.companyName }) }