Создание виджета
Кратко
Виджет -- это элемент интерфейса, встраиваемый на внешний сайт для приёма обращений от посетителей. Через виджет клиенты могут создавать заявки без регистрации и авторизации. Создание виджета -- первый шаг к приёму обращений с сайта.
Кто имеет доступ
| Роль | Просмотр виджетов | Создание | Редактирование | Удаление |
|---|---|---|---|---|
| администратор | да | да | да | да |
| Руководитель | да | да | да | да |
| оператор | нет | нет | нет | нет |
| Сотрудник клиента | нет | нет | нет | нет |
Где найти
Настройки -- Интеграции -- Виджеты. Раздел доступен из бокового меню административной панели.
Как работает
Типы виджетов
Платформа поддерживает три типа виджетов:
| Тип | Описание | Когда использовать |
|---|---|---|
| FAB | Плавающая кнопка в углу экрана | Основной вариант для большинства сайтов |
| Button | Кнопка, встроенная в содержимое страницы | Для размещения в конкретном месте |
| Inline | Форма, встроенная прямо в страницу | Для страниц "Контакты" или "Помощь" |
Процесс создания
- Перейдите в Настройки -- Интеграции -- Виджеты
- Нажмите кнопку "Создать виджет"
- Заполните основные поля:
| Поле | Обязательное | Описание |
|---|---|---|
| Название | да | Внутреннее название для идентификации |
| Тип | да | FAB, Button или Inline |
| Домены | да | Список доменов, где виджет будет работать |
| Цвет | нет | Цвет фона кнопки (по умолчанию синий) |
| Подпись | нет | Текст на кнопке/рядом с кнопкой |
- Нажмите "Сохранить"
- Система автоматически генерирует API-ключ для виджета
- Виджет появляется в списке с кодом для встраивания
API-ключ виджета
При создании виджета автоматически генерируется уникальный API-ключ. Этот ключ:
- Идентифицирует виджет при отправке заявок
- Используется в коде встраивания
- Определяет домены, с которых разрешён приём заявок (CORS)
- Применяется для rate limiting
API-ключ отображается в карточке виджета и в коде встраивания.
Домены (whitelist)
Список доменов определяет, на каких сайтах виджет будет работать:
- Укажите домены через запятую: example.com, shop.example.com
- Поддомены указываются отдельно (example.com не включает shop.example.com)
- Для локальной разработки можно добавить localhost
- Запросы с неразрешённых доменов будут отклонены
После создания
После сохранения виджета:
- Виджет появляется в списке виджетов
- Статус: "Активен"
- Доступен код для встраивания (вкладка "Код")
- Можно перейти к детальной настройке
Настройка
Базовая настройка выполняется при создании. Для детальной настройки (обязательные поля, сообщение после отправки, внешний вид) перейдите в карточку виджета.
Подробности -- в статье Настройка виджета.
Частые вопросы
Сколько виджетов можно создать?
Количество виджетов зависит от тарифного плана. На бесплатном плане -- 1 виджет. На платных планах -- без ограничений.
Можно ли использовать один виджет для нескольких сайтов?
Да, укажите все нужные домены в списке разрешённых при создании виджета.
Что произойдёт, если удалить виджет?
Виджет перестанет работать на всех сайтах. Код встраивания станет недействительным. Ранее созданные заявки сохранятся.
Можно ли деактивировать виджет временно?
Да, в карточке виджета есть переключатель активности. Деактивированный виджет не отображается на сайте, но сохраняет все настройки.
Как узнать, работает ли виджет?
Откройте сайт с установленным виджетом. Если виджет активен и домен в whitelist -- кнопка или форма отобразится на странице.
Связанные статьи
- Настройка виджета -- детальная настройка параметров
- Встраивание на сайт -- установка виджета на сайт
- Создание заявки (клиент) -- как клиент создаёт заявку через виджет