SimpleBot — Документация для разработчиков

Интеграция

Как установить виджет

Получите код виджета

После создания бота в панели управления вы получите уникальный код вставки. Скопируйте его.

Вставьте перед </body>

Откройте HTML-файл вашего сайта и вставьте скопированный код перед закрывающим тегом </body>.

Готово

Виджет появится на всех страницах сайта. Никаких дополнительных настроек не требуется.

Независимо от фреймворка

Работает с React, Next.js, Vue, обычным HTML, WordPress, Tilda — с чем угодно, что рендерит страницу.

Асинхронно, без блокировок

Загрузчик подгружается лениво и не блокирует рендеринг. Нулевое влияние на Core Web Vitals.

Изолирован и в песочнице

Работает в своей области видимости — без утечек в global и без конфликтов CSS с вашим приложением.

index.html

react.tsx

<!-- Вставьте перед </body> -->

<script

  src="https://cdn.simplebot.online/w.js"

  data-bot="bot_8f3a91c2"

  data-theme="auto"

  async></script>

API

Параметры конфигурации

Виджет поддерживает data-атрибуты для настройки поведения и внешнего вида.

Атрибут	Описание	Пример
`data-bot`	ID бота (обязательный)	`bot_8f3a91c2`
`data-theme`	Тема: `auto`, `light`, `dark`	`auto`
`data-position`	Позиция: `right`, `left`	`right`
`data-color`	Основной цвет виджета (hex)	`#14b8a6`
`data-title`	Заголовок в шапке чата	`Поддержка`

Программное управление

Вы можете управлять виджетом через глобальный объект window.SimpleBot:

// Открыть чат

window.SimpleBot.open()

// Закрыть чат

window.SimpleBot.close()

// Показать уведомление

window.SimpleBot.notify("Чем могу помочь?")