Быстрый старт виджета
Это руководство поможет быстро запустить первый полезный диалог на сайте. Начните с него, а затем адаптируйте сценарий под свой бизнес.
Перед началом
Нужен доступ к настройкам виджета бота и сайт, куда можно добавить один фрагмент кода. Заранее определите точные HTTPS-адреса сайтов, на которых будет работать виджет. HTTP допустим только для локальной разработки на loopback.
1. Выберите пресет
Откройте «Виджет» и выберите «Онлайн-школа» или «Интернет-магазин». Пресет копирует в конфигурацию редактируемые стартовые значения, а не фиксирует шаблон. Перед применением проверьте изменения.
2. Настройте диалог
Задайте бренд, приветствие, быстрые действия, форму перед началом чата, рабочие часы и текст для офлайн-режима. Быстрые действия отправляют в диалог настроенный текст, поэтому до публикации создайте подходящие реакции. Контактные поля дополняют профиль текущего посетителя, но email и телефон остаются неподтверждёнными.
3. Добавьте сайт
Добавьте каждый точный разрешённый origin, включая схему, www и поддомены. Затем скопируйте фрагмент из раздела «Установка» и добавьте его один раз в общий шаблон страниц. Подробнее см. в справочнике по виджету.
4. Проверьте важные состояния в предпросмотре
Проверьте кнопку запуска, тизер, приветствие, форму перед чатом, чат и офлайн-состояние. Посмотрите результат на компьютере и телефоне, на светлом и тёмном фоне страницы. Сохранённая настройка полезна только тогда, когда посетителю понятен её смысл в нужном состоянии.
5. Сохраните и установите
Сохраните всю конфигурацию вместе со списком origin, затем опубликуйте скопированный код. Присваивание ключа должно идти перед асинхронным скриптом загрузчика. Не добавляйте фрагмент дважды.
6. Запустите автоматическую диагностику
Выберите сохранённый origin и адрес страницы, затем запустите «Проверить установку». Диагностика исследует статические признаки в HTML и CSP, а также открывает настоящую страницу для подтверждения работы во время выполнения. Только готовность виджета подтверждает успешную установку. Тайм-аут означает, что сигнал не получен, а не однозначную ошибку CSP.
7. Протестируйте весь диалог
Откройте приватное окно браузера и пройдите путь как посетитель. Нажмите быстрое действие, отправьте или пропустите форму согласно настройке, напишите сообщение и проверьте нужную реакцию. Также проверьте время вне расписания: текст офлайн-режима должен обещать ответ, а не присутствие оператора прямо сейчас.
Если настройка занимает больше 15 минут
Не публикуйте неопределённый сценарий только ради скорости. Проверьте точный origin, порядок фрагмента, консоль браузера, CSP и блокировщики. Если диалог пока не даёт полезного ответа, сначала настройте реакции. Детали установки есть в справочнике по виджету, а при неудачной настройке поможет поддержка.