Автоматизація завдань Бітрікс24 за допомогою бота
Менеджер створює завдання, забуває вказати крайній термін — завдання висить тиждень без руху. Інший менеджер закриває угоду, але не ставить завдання на відвантаження — клієнт чекає. Третій сценарій: щоранку керівник вручну збирає статуси по завданнях з різних проектів. Усе це вирішується ботом, який працює всередині чату Бітрікс24 і взаємодіє із завданнями, CRM та сповіщеннями через REST API. Ми розробляємо таких ботів під ключ — від реєстрації до навчання співробітників. Наш досвід — 10+ років у 1С-Бітрікс та 40+ реалізованих проектів. Бот не лише звільняє час, але й знижує кількість помилок, пов'язаних з людським фактором. Наприклад, при створенні завдання по угоді бот автоматично підтягує дані з CRM, виключаючи описки та пропуски.
Як бот взаємодіє з REST API Бітрікс24?
Бот у Бітрікс24 — це серверний застосунок, зареєстрований через метод imbot.register. Портал надсилає події на URL обробника (webhook endpoint), бот обробляє команди та відповідає через imbot.message.add. Вся логіка живе на вашому сервері — Бітрікс24 виступає як інтерфейс (чат) та джерело даних (REST API).
Ключові компоненти:
- Реєстрація бота —
imbot.registerіз зазначеннямEVENT_HANDLER(URL для прийому подій),MESSAGE_ADD(URL для відправки повідомлень),BOT_ID. Після реєстрації бот з'являється у списку чатів. - Обробник команд — серверний endpoint, який приймає POST-запити від Бітрікс24 при відправці повідомлення боту. Парсить текст команди, виконує логіку, відповідає.
- REST API виклики — бот працює із завданнями (
tasks.task.add,tasks.task.update,tasks.task.list), CRM (crm.deal.get,crm.lead.add), сповіщеннями (im.notify), користувачами (user.get).
Офіційна документація REST API Бітрікс24
Сценарії автоматизації
Бот-контролер завдань
Запускається за розкладом (cron на стороні сервера) і перевіряє завдання через tasks.task.list із фільтрами:
- Завдання без крайнього терміну (
DEADLINE= null) — надсилає повідомлення відповідальному: «У завдання #123 немає дедлайну. Встанови термін або поясни чому». - Прострочені завдання (
DEADLINE < now,STATUS!= 5) — сповіщає керівника та виконавця. - Завдання без активності понад N днів —
DATE_LAST_ACTIVITYпорівнюється з поточною датою. Якщо завдання «зависло» — пінг у чат.
Бот пише в особистий чат із співробітником або в груповий чат проекту — залежить від налаштування. Повідомлення містить посилання на завдання, ім'я відповідального, кількість днів прострочення. Така автоматизація скорочує кількість прострочених завдань на 80%.
Бот-асистент для CRM
Менеджер пише боту в чат: «Створи завдання на відвантаження по угоді 4521». Бот:
- Викликає
crm.deal.getз ID 4521 — отримує дані угоди. - Вилучає контакт, суму, товари з угоди.
- Викликає
tasks.task.add— створює завдання із заповненими полями: назва, опис з даними угоди, відповідальний (з налаштувань), дедлайн (поточна дата + 2 робочих дні). - Відповідає в чат: «Завдання #789 створено, відповідальний — Іванов А.С., термін — 15.03».
Розбір текстових команд реалізується через регулярні вирази або набір фіксованих шаблонів. Для складних сценаріїв підключаємо NLP-обробку, але в 90% випадків вистачає простого парсингу.
Бот-збирач звітів
Керівник пише: «Статус по проекту Альфа». Бот:
- Шукає групу (проект) за назвою через
sonet_group.getіз фільтром. - Отримує завдання проекту:
tasks.task.listіз фільтромGROUP_ID. - Групує за статусами: нові, в роботі, завершені, прострочені.
- Формує зведення і надсилає в чат.
Формат відповіді — структуроване повідомлення з розбивкою по категоріях. REST API Бітрікс24 підтримує форматування: жирний текст, посилання, розділювачі.
Що робити, якщо обробка команди займає більше 5 секунд?
Бот приймає події через POST-запити. Основні типи подій:
-
ONIMBOTMESSAGEADD— користувач написав боту. Payload міститьDIALOG_ID,MESSAGE_ID,FROM_USER_ID, текст повідомлення. -
ONIMBOTJOINCHAT— бот доданий у груповий чат. -
ONIMBOTDELETE— бот видалений з чату.
Обробник повинен відповідати HTTP 200 протягом 5 секунд — інакше Бітрікс24 вважатиме запит невдалим. Якщо обробка команди займає більше часу (запит до зовнішнього API, важка вибірка завдань), використовуємо асинхронну обробку: приймаємо подію, ставимо в чергу (Redis/RabbitMQ), відповідаємо 200, обробляємо у фоні, надсилаємо результат через imbot.message.add.
Інтеграція із зовнішніми сервісами
Бот не обмежений даними Бітрікс24. Типові зовнішні підключення:
- Трекери та Git. Бот приймає webhook від GitLab/GitHub при мерджі — знаходить завдання в Б24 за номером з коміту, змінює статус на «Виконано».
- Моніторинг. Zabbix надсилає алерт → бот створює завдання в проекті «Інфраструктура» та сповіщає чергового.
- Календар та HR. Бот перевіряє відсутності через
calendar.event.getі перерозподіляє завдання співробітника, який пішов на лікарняний.
Порівняння: ручне управління проти бота
| Характеристика | Ручний процес | Бот-автоматизація |
|---|---|---|
| Контроль дедлайнів | Раз на тиждень, пропуски | Щоденний аудит, сповіщення в реальному часі |
| Створення завдань по угодах | Вручну, 3-5 хвилин на завдання | Автоматично, 2 секунди |
| Звітність по проектах | Збір у Excel, 30 хвилин | Миттєве зведення в чаті |
Бот створює завдання в 100 разів швидше, ніж ручний ввід, і знижує витрати часу на контроль.
Терміни впровадження
| Масштаб | Що входить | Термін |
|---|---|---|
| Простий бот | 1–2 команди, робота із завданнями або CRM, без зовнішніх інтеграцій | 3–5 днів |
| Середній | 5–10 команд, інтеграція з 1–2 зовнішніми сервісами, обробка подій | 1–2 тижні |
| Складний | Повноцінний асистент із NLP, множинні інтеграції, адмін-панель налаштування | 3–4 тижні |
Технічні вимоги
Серверна частина бота розміщується на вашому сервері або в хмарі. Вимоги:
- HTTPS-доступ — Бітрікс24 надсилає події тільки на HTTPS-endpoint.
- Час відповіді — менше 5 секунд на POST-запит. Для важких операцій — черга (Redis, RabbitMQ).
- Авторизація — бот працює з правами OAuth-застосунку. При реєстрації через
imbot.registerвказується scope:imbot,task,crm,sonet_groupта інші модулі, до яких бот звертається. - Логування — всі вхідні події та вихідні виклики REST API записуються в лог. Без логів налагодження бота перетворюється на ворожіння.
Типові помилки при розробці ботів:
- Відсутність обробки таймаутів. Якщо бот не відповідає за 5 секунд, Бітрікс24 блокує його. Рішення — асинхронна черга.
- Некоректний scope OAuth. Бот не може викликати
crm.deal.get, якщо не вказано модульcrm. Перевіряйте права при реєстрації. - Ігнорування логів. Без логів неможливо налагодити збій. Пишіть всі запити та відповіді.
Що входить в роботу
- Розробка серверного обробника бота (PHP, Node.js або Python)
- Реєстрація бота в Бітрікс24 через
imbot.register - Набір команд під ваші бізнес-процеси
- Інтеграція із зовнішніми сервісами по webhook або API
- Тестування в dev-середовищі, деплой на production
- Документація по командах бота для співробітників
- Навчання ключових користувачів
- Місяць безкоштовної технічної підтримки
Отримайте консультацію по автоматизації ваших процесів — ми оцінимо ваш проект за один день. Економія часу для вашої команди — до 10 годин на тиждень. Зв'яжіться з нами, щоб замовити розробку бота під ключ.







