Перейти до основного вмісту

Інтеграція віджета NaviBot та технічні передумови

Підключення віджета NaviBot до веб-сайту виконується швидко та прозоро. Цей розділ описує обов'язкові технічні вимоги до сайту, систему фільтрації ботів та передачу лідів через вебхуки.

1. Технічні передумови для сайту компанії​

Для коректної роботи віджета веб-сторінка повинна відповідати сучасним стандартам безпеки:

  • Протокол HTTPS: наявність дійсного сертифіката шифрування обов'язкова. Браузери блокують сторонні сценарії на незахищених з'єднаннях HTTP.
  • Налаштування CSP (Content Security Policy): якщо ваш сервер надсилає суворі заголовки безпеки, дозвольте підключення до ресурсів NaviBot: 
    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)​

Для збереження вашого ліміту генерацій та запобігання спаму NaviBot використовує систему Cloudflare Turnstile:

  • Непомітна верифікація: живі користувачі не стикаються з розгадуванням складних картинок чи вводом деформованого тексту.
  • Блокування парсерів: шкідливі спам-скрипти блокуються до виклику мовної моделі.

3. Передача лідів до CRM через вебхуки​

Щойно клієнт залишає контакти під час діалогу, NaviBot формує запит HTTP POST у режимі реального часу:

{
  "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"
}
  • Вкажіть цільову URL-адресу в розділі Settings ──> Webhooks особистого кабінету.
  • Кожен запит підписується захисним ключем HMAC для верифікації справжності повідомлення.