Что синхронизировать с Integrator-Bitrix24

Для обеспечения консистентности данных между CRM и внешними информационными системами (ERP, WMS, BI), платформа Integrator-Bitrix24 поддерживает синхронизацию следующих сущностей:

• Лиды (LEAD): Синхронизация с формами на сайте или рекламными кабинетами. Метод: crm.lead.add / crm.lead.update.
• Сделки (DEAL): Передача статусов и сумм в учетные системы (1С, МойСклад). Метод: crm.deal.update.
• Контрагенты (COMPANY/CONTACT): Актуализация реквизитов из внешних баз данных. Метод: crm.company.list.
• Товары (PRODUCT): Синхронизация остатков и цен из ERP. Метод: crm.item.productrow.set.
• Счета (INVOICE): Автоматизация выставления счетов через платежные шлюзы. Метод: crm.invoice.add.
• Пользователи (USER): Синхронизация оргструктуры с Active Directory. Метод: user.add.
• Задачи (TASK): Передача проектных метрик в Jira или Kaiten. Метод: tasks.task.add.

Технические особенности API Integrator-Bitrix24

• Аутентификация: Используется протокол OAuth 2.0 для облачных версий (получение access_token и refresh_token) либо статические входящие вебхуки для коробочных решений.
• Формат данных: Обмен данными осуществляется исключительно через JSON. Кодировка UTF-8 является обязательной для всех передаваемых параметров.
• Ограничения (Rate-Limits): Стандартный лимит составляет 2 запроса в секунду для одного приложения. При превышении сервер возвращает ошибку 429 Too Many Requests.
• Обработка ошибок: Система возвращает стандартные HTTP-коды: 401 Unauthorized (истек токен), 403 Forbidden (недостаточно прав), 500 Internal Server Error (ошибка на стороне CRM).
• Вебхуки (Events): Поддержка механизма событий (Events API). Реализована отправка POST-запросов на указанный handler при изменении сущностей (например, onCrmDealUpdate).
• Песочница: Предоставляется демо-аккаунт через Bitrix24 Partner Portal, позволяющий тестировать REST-методы без риска для продакшн-данных.
• Версионирование: API поддерживает обратную совместимость. Текущая актуальная версия методов — v43.

Часто задаваемые вопросы о Integrator-Bitrix24

Как получить API-ключ для интеграции?

Для облачной версии необходимо создать приложение в «Маркете» Bitrix24 или использовать локальное приложение. Для коробочной версии ключ генерируется в разделе «Вебхуки» в административной панели портала.

Существуют ли лимиты на количество API-запросов?

Да, стандартное ограничение составляет 50 000 запросов в сутки для одного приложения. При необходимости выполнения высоконагруженных операций рекомендуется использовать пакетную передачу данных через метод batch.

Поддерживает ли платформа асинхронные вебхуки?

Да, система позволяет подписываться на события изменения сущностей в реальном времени. Ответ сервера на вебхук должен возвращать код 200, иначе система повторит попытку отправки до 5 раз с экспоненциальной задержкой.

Доступна ли тестовая среда для разработчиков?

Разработчикам доступен режим «Локальное приложение» в облаке, который позволяет разворачивать интеграцию без публикации в публичный каталог приложений. Это основной инструмент для отладки перед внедрением.

Совместимы ли интеграции между облаком и коробкой?

Основные REST-методы идентичны, однако коробочная версия имеет расширенный доступ к API и позволяет использовать события, недоступные в облаке. При разработке важно проверять наличие специфических методов в документации конкретной редакции.

Где найти полную документацию по методам?

Актуальная техническая документация расположена на портале dev.1c-bitrix.ru. Там приведены описания всех сущностей, параметры запросов и примеры кода на PHP, JavaScript и Python. Настроить интеграцию Integrator-Bitrix24 под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.