Перейти к основному содержимому

Интеграция виджета NaviBot и требования к сайту

Развертывание виджета NaviBot на вашем сайте занимает считанные минуты. В этом документе приведены технические требования к веб-серверу, механизмы защиты от спама и порядок настройки вебхуков.


1. Технические требования к сайту заказчика​

Для стабильной работы виджета веб-ресурс должен удовлетворять базовым стандартам:

  • Обязательный протокол HTTPS: страница должна открываться по защищенному протоколу HTTPS. Браузеры блокируют сторонние скрипты на незащищенных HTTP-сайтах.
  • Политики безопасности (CSP): если на вашем веб-сервере включены строгие заголовки Content Security Policy, добавьте домены сервиса в разрешенный список:
    script-src https://navi.1it.pro;
    connect-src https://navi.1it.pro wss://navi.1it.pro;
    img-src https://navi.1it.pro data:;
  • Размещение скрипта: тег со скриптом вставляется в шаблон перед закрывающим тегом </body>.

2. Защита от спам-ботов (Cloudflare Turnstile)​

Чтобы исключить спам-атаки и необоснованный расход токенов нейросети автоматическими скриптами, виджет использует умную защиту Cloudflare Turnstile:

  • Невидимая проверка: реальные посетители сайта не проходят утомительных капч с выбором светофоров или картинок.
  • Ограничение частоты запросов: автоматизированные скрипты отсекаются на уровне шлюза до момента обращения к модели ИИ.

3. Отправка лидов через вебхуки (Webhooks)​

Когда пользователь оставляет контактные данные в окне чата, NaviBot моментально отправляет событие HTTP POST на указанный адрес вашей CRM:

{
"event": "lead.captured",
"inboxId": "inbox_abc123",
"timestamp": "2026-11-10T14:30:00Z",
"contact": {
"name": "Алексей Иванов",
"phone": "+48 500 123 456",
"email": "[email protected]"
},
"summary": "Интересуется внедрением тарифа Business для ветеринарной клиники.",
"sourceUrl": "https://yourcompany.com/services"
}
  • Целевой адрес настраивается в разделе Settings ──> Webhooks панели управления NaviBot.
  • Все отправления подписываются криптографической подписью HMAC для проверки подлинности источника.