Налаштування логування API-запитів Бітрікс24

Чому стандартного журналу подій недостатньо?

Інтеграція перестала працювати. Дані не надходять із зовнішньої системи, угоди не оновлюються, вебхук мовчить. Розробник питає: «А запит взагалі дійшов?» — і відповіді немає, тому що логів немає. Без логування API-запитів налагодження інтеграції — це ворожіння. Ми стикалися з цим десятки разів. Наші інженери пропонують налаштування логування API-запитів під ключ: проксі-логгер, middleware, моніторинг та алерти. Оцінимо проект за 1 день і гарантуємо прозору налагодження. Потрібно бачити: який запит прийшов, з якими параметрами, що повернув Б24, скільки часу зайняла відповідь. Тільки тоді можна зрозуміти, де проблема — на стороні Б24, інтеграції чи мережі. Саме такий підхід дозволяє скоротити час діагностики з годин до хвилин.

Як налаштувати логування, щоб не гадати?

Вбудований Журнал подій (Налаштування → Інструменти → Журнал подій) фіксує системні події: авторизації, зміни налаштувань, помилки модулів. Для API-запитів журнал фіксує:

• Помилки REST API — QUERY_LIMIT_EXCEEDED, ACCESS_DENIED, INVALID_TOKEN
• Встановлення та видалення застосунків
• Спрацювання подій (event handlers)

Обмеження: журнал подій не логує успішні API-виклики — лише помилки та системні події. Для повного логування потрібні додаткові інструменти.

Що робити, якщо вбудований журнал не дає повної картини?

Вебхуки — найпопулярніший спосіб інтеграції, і найскладніший для налагодження. Вхідний вебхук (URL для виклику Б24 ззовні) не логує виклики за замовчуванням. Вихідний вебхук (Б24 викликає зовнішній URL при події) логує результат у журналі бізнес-процесів, якщо вебхук викликається з БП.

Для логування вхідних вебхуків рішення на стороні інтеграції:

• Проксі-логгер — проміжний сервіс між зовнішньою системою та Б24. Всі запити проходять через проксі, який записує тіло запиту, заголовки, відповідь Б24 та час виконання. Можна реалізувати на nginx (access log + request body logging) або на рівні застосунку. Проксі-логгер дає на 90% більше інформації, ніж журнал подій.
• Middleware у застосунку — якщо інтеграція написана на PHP/Node.js/Python, додається middleware, який логує кожен вихідний запит до API Б24 у файл або в БД.

Наприклад, на одному з проектів ми виявили, що вебхук не приходив через помилку SSL-сертифіката, яку можна було відловити лише за допомогою проксі-логгера. Це заощадило клієнту дні простою.

Для серверних застосунків (OAuth) у маркетплейсі Б24 є розділ «Розробникам → Журнал викликів REST API» — показує кількість викликів, помилки, статистику по методах. Доступний лише для опублікованих застосунків.

Для власних застосунків (не з маркетплейсу) рекомендується реалізувати логування на рівні HTTP-клієнта:

Порівняння способів логування

Моніторинг та алерти

Логи корисні, коли їх аналізують. Рекомендації:

• Лічильник помилок — відстежувати кількість помилок API за останню годину. Зростання помилок QUERY_LIMIT_EXCEEDED — сигнал про перевищення лімітів. Зростання ACCESS_DENIED — можливо, протермінувалися токени.
• Час відповіді — якщо середній час відповіді API виріс з 200 мс до 2 с — проблема на стороні Б24 (навантаження, обслуговування).
• Алерти — сповіщення в Telegram/email при: 5+ помилок поспіль, 0 успішних викликів за останні 30 хвилин, добовий ліміт вичерпано на 80%.

Для централізованого збору логів використовується ELK (Elasticsearch + Logstash + Kibana) або Grafana Loki. Логи з middleware відправляються в систему, де будуються дашборди та налаштовуються алерти.

{
  "method": "crm.deal.get",
  "params": {"id": "123"},
  "response": {"result": {}},
  "time": "2023-10-01T12:00:00Z",
  "duration_ms": 340
}

Що входить у роботу

• Налаштування проксі-логгера для вхідних вебхуків: запис запитів та відповідей
• Middleware логування для серверних застосунків (PHP/Node.js/Python)
• Структура логів: метод, параметри, статус, час, тривалість
• Підключення логів до системи моніторингу (ELK, Loki, Grafana)
• Алерти на помилки API, перевищення лімітів, тайм-аути
• Ротація логів та політика зберігання
• Документація та навчання команди

Наш 10-річний досвід з Бітрікс24 гарантує, що ви отримаєте прозору та підтримувану систему логування. Замовте налаштування — і ви позбавитеся ворожіння при налагодженні інтеграцій. Зв'яжіться з нами, щоб обговорити ваш проект. Отримайте консультацію протягом 24 годин.

Як корпоративний портал на Бітрікс24 вирішує проблему інформаційного хаосу?

Ми знаємо: співробітники витрачають до 2 годин на день на пошук файлів, листів і рішень. Завдання губляться в десятку чатів, погодження застряють на тижні. Керівник дізнається про зрив дедлайну лише на нараді. Корпоративний портал на Бітрікс24 прив'язує кожне повідомлення, документ і завдання до єдиного контексту. Ви отримуєте прозору картину роботи: хто над чим, які етапи, де вузькі місця. Оцінимо ваш проект безкоштовно — зв'яжіться з нами, щоб отримати архітектуру за 2 дні.

Що дає портал у щоденній роботі і чому це краще месенджерів?

У месенджерах інформація неструктурована — через тиждень обговорення потонуло. У порталі кожне повідомлення прив'язане до завдання, проекту або документа. Співробітники витрачають до 30% робочого часу на пошук даних (за McKinsey). Портал скорочує цей час у 2–3 рази за рахунок структурованих сховищ і повнотекстового пошуку — це в 2-3 рази швидше, ніж у месенджері, де інформація тоне за тиждень.

Комунікації. Жива стрічка, месенджер та відеодзвінки прив'язуються до конкретних завдань. Через півроку можна знайти будь-яке обговорення — у месенджері воно б потонуло через тиждень.

Завдання та проекти. Канбан, Гант, чеклісти, залежності, облік часу. Ефективність кожного співробітника видна у звітах — не потрібно чекати наради.

Документообіг. Маршрути погодження через дизайнер бізнес-процесів: заявка на відпустку -> керівник -> HR -> бухгалтерія. Електронний підпис, версіонування, контроль термінів. Інтеграція з електронним документообігом (СБІС, Діадок) через REST API.

HR. Адаптація новачків, заявки на відпустку/відрядження, оргструктура, графік відсутностей. Співробітник з першого дня знає, куди йти.

База знань. Wiki-движок Бітрікс24: регламенти, інструкції. Знання не йдуть зі звільненими.

Приклад із впровадження. Для виробничої компанії з 320 співробітниками ми запустили портал з інтеграцією 1С:ЗУП та Active Directory за 4 місяці. Час погодження заявок на відрядження скоротився з 3 днів до 4 годин. Економія на простої співробітників — близько 1,2 млн грн на рік. Керівники отримують автоматичні звіти з ефективності підрозділів. Термін відповіді клієнтам зменшився на 20%. Окупність порталу — 7 місяців.

Як інтеграція з 1С та Active Directory прискорює кадровий облік?

Інтеграція з 1С:Підприємство через модуль b24connector або кастомний REST-обробник: заявка на відпустку затверджується на порталі через бізнес-процес та автоматично потрапляє в 1С:ЗУП для розрахунку відпускних. Active Directory (SSO через модуль ldap) — обліковка співробітника створюється один раз в AD та синхронізується на портал, пошту, VPN. При звільненні блокується всюди. Ручне створення акаунтів виключено, помилки мінімізовані.

Типи корпоративних порталів та ключові інтеграції

Додаткові інтеграції, що дають реальну цінність:

• Пошта. Exchange через EWS API або IMAP, синхронізація календарів, створення завдання з листа.
• IP-телефонія. Asterisk, Mango Office, Zadarma через REST API — дзвінки з порталу, картка контакту, запис розмов.
• Відеоконференції. Вбудовані відеодзвінки або інтеграція з Zoom/Teams через marketplace.
• ЕДО. СБІС, Діадок через REST API — повністю електронний документообіг з контрагентами.

Безпека та відповідність 152-ФЗ

На порталі — персональні дані, фінансова звітність, стратегічні плани. Ми гарантуємо захист:

• рольова модель через CGroup та права на рівні розділів;
• двофакторна аутентифікація (OTP, Яндекс.Ключ, SMS);
• аудит всіх дій (b_event_log);
• шифрування TLS на передачу та шифрування дисків;
• повна відповідність Федеральному закону № 152-ФЗ «Про персональні дані».

Як відбувається впровадження? Покроковий план

1. Аудит — фіксуємо поточні процеси, вимірюємо втрати часу.
2. Проектування — обираємо тип порталу, плануємо інтеграції.
3. Реалізація — налаштовуємо бізнес-процеси, права, інтерфейс.
4. Тест — пілотна група перевіряє сценарії, ми виправляємо недоліки.
5. Запуск — підключаємо всіх співробітників, навчаємо, передаємо документацію.

Що входить у роботу

В результаті ви отримуєте:

• проектну документацію (архітектура, схеми бізнес-процесів, технічне завдання);
• налаштований портал з інтеграціями (1С, AD, пошта, телефонія, ЕДО);
• опис бізнес-процесів та інструкції для адміністраторів і користувачів;
• 30 днів технічної підтримки після запуску.

Підтримка після запуску: як не дати порталу померти

Через півроку багато порталів стають занедбаними. Щоб цього уникнути, пропонуємо пакети з фіксованим SLA та виділеним адміністратором. Моніторинг продуктивності, оновлення платформи, адміністрування користувачів, доопрацювання нових модулів. Досвід нашої команди — понад 50 впроваджень корпоративних порталів на Бітрікс24, 10+ років роботи, статус сертифікованого партнера 1С-Бітрікс. Гарантуємо якість та терміни.

Мобільний доступ. Нативний додаток Бітрікс24 (iOS/Android) з push-сповіщеннями, завданнями, чатами. Адаптивний веб-інтерфейс для екстранет-користувачів (не треба встановлювати додаток). Офлайн-доступ до документів та завдань, синхронізація при відновленні зв'язку.

Замовте впровадження корпоративного порталу під ключ

Зв'яжіться з нами — оцінимо ваш проект, запропонуємо архітектуру та терміни. Отримайте консультацію безкоштовно та переконайтеся, що портал окупається в перші півроку. Замовляйте впровадження та почніть автоматизацію вже сьогодні.