Розробка бота для автоматизації завдань Бітрікс24 під ключ

Автоматизація завдань Бітрікс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». Бот:

1. Викликає crm.deal.get з ID 4521 — отримує дані угоди.
2. Вилучає контакт, суму, товари з угоди.
3. Викликає tasks.task.add — створює завдання із заповненими полями: назва, опис з даними угоди, відповідальний (з налаштувань), дедлайн (поточна дата + 2 робочих дні).
4. Відповідає в чат: «Завдання #789 створено, відповідальний — Іванов А.С., термін — 15.03».

Розбір текстових команд реалізується через регулярні вирази або набір фіксованих шаблонів. Для складних сценаріїв підключаємо NLP-обробку, але в 90% випадків вистачає простого парсингу.

Бот-збирач звітів

Керівник пише: «Статус по проекту Альфа». Бот:

1. Шукає групу (проект) за назвою через sonet_group.get із фільтром.
2. Отримує завдання проекту: tasks.task.list із фільтром GROUP_ID.
3. Групує за статусами: нові, в роботі, завершені, прострочені.
4. Формує зведення і надсилає в чат.

Формат відповіді — структуроване повідомлення з розбивкою по категоріях. 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 і перерозподіляє завдання співробітника, який пішов на лікарняний.

Порівняння: ручне управління проти бота

Бот створює завдання в 100 разів швидше, ніж ручний ввід, і знижує витрати часу на контроль.

Терміни впровадження

Технічні вимоги

Серверна частина бота розміщується на вашому сервері або в хмарі. Вимоги:

• 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 годин на тиждень. Зв'яжіться з нами, щоб замовити розробку бота під ключ.