Bitrix24 — найпопулярніший CRM в українському B2B сегменті. Якщо ви впроваджуєте AI-чат-бота і не плануєте інтеграцію з Bitrix — ви робите дорогу іграшку. Без CRM-зв'язку леди з бота просто губляться у спам-папці адміністратора. У цьому гайді — повний процес інтеграції з реальними прикладами.
Що саме інтегрувати
Перш ніж торкатися Bitrix, визначте: що саме повинно потрапляти в CRM? Стандартна архітектура виглядає так:
- Новий лід — кожен унікальний відвідувач, який почав розмову. Не "купив", а саме почав. Це джерело даних для warm-up сценаріїв.
- Кваліфіковані ліди — AI зібрав потребу, бюджет, контакти. Це гарячі ліди для менеджерів.
- Угода (Deal) — клієнт готовий до покупки і потребує menеджера. Найвища пріоритетність.
- Активності (Activity) — кожна важлива розмова як активність прив'язана до контакту.
- Файли — якщо клієнт надсилає скрін чи PDF, прикріплюємо до контакту.
Технічний стек інтеграції
Bitrix24 має 3 способи інтеграції з зовнішніми системами. Кожен має свої use case:
- Inbound Webhook — найпростіший. Bitrix створює endpoint URL, ваш AI-сервіс надсилає POST-запити. Підходить для 80% задач.
- REST API + OAuth — потужніший, з токенами і авторизацією. Потрібен, коли працюємо з конфіденційними даними.
- Bitrix24 App (на маркетплейсі) — для довгострокових SaaS-продуктів, які продаються через маркетплейс Bitrix.
Для більшості наших клієнтів використовуємо Inbound Webhook — швидко, надійно, без зайвої складності.
Крок 1. Створюємо webhook у Bitrix
У Bitrix24 переходимо: Розробникам → Інші → Інхідний вебхук. Налаштовуємо права (CRM: lead, contact, deal — повний доступ). Bitrix згенерує URL вигляду: https://your-portal.bitrix24.ua/rest/USER_ID/TOKEN/
Цей URL — секретний. Зберегти у environment variables AI-сервісу, ніколи не комітити в Git. У наших проєктах тримаємо в Vercel Environment Variables.
Крок 2. Створення ліда з AI-сервісу
AI-сервіс після того, як зібрав мінімальні дані (ім'я + контакт), робить POST-запит на webhook URL з методом crm.lead.add:
- TITLE — формуємо із суті розмови, наприклад "AI: Запит на холодильник до 25 000"
- NAME, LAST_NAME — з імені клієнта
- PHONE / EMAIL — формат "VALUE: ..., VALUE_TYPE: WORK"
- SOURCE_ID — кастомне джерело "AI-bot", щоб менеджер бачив звідки прийшов лід
- COMMENTS — повний transcript розмови з AI
- UF_CRM_
— кастомні поля бізнесу (бюджет, urgency, тип запиту)
"Передача лідів без контексту розмови — головна помилка. Менеджер витрачає 5 хвилин на з'ясування того, що клієнт уже сказав AI. Завжди передавайте transcript повністю.— З нашого внутрішнього playbook
Крок 3. Призначення відповідального
AI може автоматично призначати ліда правильному менеджеру. У Bitrix цe робиться через поле ASSIGNED_BY_ID. Логіка вибору може враховувати:
- Спеціалізація менеджера — техніка → менеджер з технічної команди, побутова хімія → інший
- Робочий час — після 19:00 ставимо на менеджера ранкової зміни
- Завантаження — округ-робін розподіл по менеджерах з найменшою кількістю активних лідів
- Регіон клієнта — за номером телефону або ip-геолокацією
Крок 4. Webhook у зворотну сторону (Bitrix → AI)
Для двостороннього потоку даних налаштовуємо outgoing webhook у Bitrix. Коли статус ліда змінюється (наприклад, "Зв'язалися") — Bitrix надсилає update нашому AI-сервісу. AI знає, що з клієнтом уже спілкувалися, і не дублює повідомлення.
Типові помилки і їх рішення
За 14+ наших інтеграцій з Bitrix зібралися повторювані проблеми. Ось топ-5 і як їх вирішити:
- 429 Too Many Requests — Bitrix лімітує 2 запити/сек. Використовуйте rate-limiter у вашому коді.
- Дублі лідів — клієнт міг писати з кількох каналів. Перед створенням ліда шукаємо за email/телефоном.
- Втрачений transcript — Bitrix обмежує COMMENTS у 64KB. Довгі розмови треба зберігати окремо і прикладати посилання.
- Custom fields не передаються — перевіряйте точні назви полів через crm.lead.fields метод.
- SSL помилки — Bitrix24 self-hosted іноді має проблеми з SSL. Використовуйте --insecure тільки для dev environment.
Що далі
Описав я тут лише базову інтеграцію. Розширені можливості: автоматичне створення угод з payment-stage tracking, синхронізація з Bitrix Workflows для маркетинг-автоматизації, інтеграція з Bitrix Telephony для дзвінків. Усе це робиться через ту ж REST API.
Хочете готову інтеграцію без коду — пишіть нам. Зробимо за 1-2 тижні з нашим AI-консультантом і налаштуванням під вашу специфіку Bitrix.
