betool betool

Документация

Веб-чат-виджет

Чат-виджет, встраиваемый на любой сайт с помощью одного JS-скрипта.

Веб-чат-виджет

Чат-виджет — это JS-скрипт, который вы встраиваете на свой сайт (маркетинговый, поддержки, приложение). Он открывает диалоговое окно, работающее на базе одного из ваших pipeline betool.

Возможности

  • Один тег скрипта для вставки в ваш <head>. Без npm-зависимостей.
  • Публичный токен — отзывается в любой момент из панели администрирования. Никаких секретов на стороне клиента.
  • Постоянные переписки — пользователи продолжают с того места, где остановились, между визитами.
  • Мультиpipeline — один сайт может обслуживать несколько виджетов (пресейл, поддержка, документация).

Настройка

  1. Администрирование → Чат-виджеты → Новый виджет.
  2. Задайте имя и выберите целевой pipeline.
  3. Скопируйте сгенерированный сниппет:
<script
  src="https://platform.betool.ai/widget/v1/widget.js"
  async
></script>
<script>
  window.addEventListener('load', () => {
    window.BetoolChat.init({
      token: 'pub_wdg_xxxxxxxxxxxxxxxx',
    })
  })
</script>

По умолчанию виджет появляется в правом нижнем углу.

Кастомизация

Из панели администрирования виджета:

  • Внешний вид — акцентный цвет, положение, подписи.
  • Поведение — автооткрытие через X секунд, приветственное сообщение.
  • Область действия — ограничение разрешённых доменов (CORS).

Безопасность

token публичен по замыслу: он ограничивает область действия одним виджетом. Если кто-то использует его с неавторизованного домена, запрос отклоняется на стороне сервера. Чтобы отозвать скомпрометированный виджет: Администрирование → Чат-виджеты → Отозвать.

Ограничения

  • Пока нет совместного просмотра (агент не видит страницу пользователя).
  • Виджет не обрабатывает крупные вложения (>10 МБ). Для этого используйте pipeline электронной почты.