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

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

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

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

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

<p class="callout info">Место в коде, в которое необходимо добавить методы инициализации зависит от "движка" вашего фронтенда.</p>

<p class="callout warning">Если у вас SPA (Single Page Application), то виджет должен инициализироваться не в момент готовности DOM модели, а после того как сайт «отрисован».</p>

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

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

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

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

**Примеры:**

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

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

```JavaScript
setWidgetRole();
```

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

```JavaScript
initMetabotWidget()
```

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

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

<table border="1" id="bkmrk-%D0%9C%D0%B5%D1%82%D0%BE%D0%B4-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-%D0%9F%D1%80%D0%B8%D0%BC%D0%B5" style="border-collapse: collapse; width: 100%; height: 151.417px;"><tbody><tr style="height: 29.4583px;"><td style="width: 33.3051%; height: 29.4583px;">**Метод**</td><td style="width: 33.3051%; height: 29.4583px;">**Описание**</td><td style="width: 33.3077%; height: 29.4583px;">**Примеры**</td></tr><tr><td style="width: 33.3051%;">setWidgetRole() </td><td style="width: 33.3051%;">Метод для передачи кода роли пользователя.

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

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

</td><td style="width: 33.3077%;">setWidgetRole(«Код роли»)

  
Где код роли может принимать строковое значение, например:  
 ‘admin’– администратор  
 ‘dealer’ – дилер  
 ‘employee’ – сотрудник

</td></tr><tr style="height: 63.0417px;"><td style="width: 33.3051%; height: 63.0417px;">initMetabotWidget()</td><td style="width: 33.3051%; height: 63.0417px;">Функция инициализации виджета. Выполняется в самом конце.</td><td style="width: 33.3077%; height: 63.0417px;">  
</td></tr></tbody></table>