Skip to content

Битрикс24 ​

Подключение Битрикс24 забирает из вашего портала пользователей, компании и сделки через входящий вебхук. Система работает поверх Битрикс24: данные загружаются на проверку и попадают в CRM только после вашего подтверждения. Битрикс24 продолжает работать как раньше.

Статус подключения — Бета. Ключи платформы не нужны: вебхук создаёте вы в своём портале.

Как подключить ​

  1. В Битрикс24 откройте Разработчикам → Другое → Входящий вебхук.
  2. Выберите права CRM (crm) и Пользователи (user) и сохраните. Скопируйте адрес вида https://company.bitrix24.kz/rest/1/xxxxxxxx/.
  3. В системе откройте Коннекторы (/connectors) → карточка Битрикс24.
  4. Вставьте адрес в поле Адрес входящего вебхука и нажмите Подключить Битрикс24. Система сразу проверит, что вебхук работает.

Адрес вебхука — это ключ доступа. Он хранится в зашифрованном виде и после подключения больше не показывается. Чтобы сменить вебхук, вставьте новый адрес и нажмите Заменить вебхук.

Подключать и отключать может владелец или администратор организации.

Изменения из Битрикс24 (необязательно) ​

Чтобы изменения в Битрикс24 приходили сами, без ручной загрузки:

  1. Скопируйте Адрес обработчика с карточки Битрикс24.
  2. В Битрикс24 создайте Исходящий вебхук с этим адресом и событиями: добавление/изменение/удаление компании, добавление/изменение/удаление сделки, добавление пользователя.
  3. Скопируйте выданный Токен приложения и вставьте его на карточке, нажмите Сохранить токен.

Пока токен не сохранён, события из Битрикс24 не принимаются.

Как загрузить данные ​

  1. Нажмите Загрузить из Битрикс24. Сначала загружаются пользователи, потом компании, потом сделки.
  2. Если данных много, загрузка идёт частями — нажмите кнопку ещё раз, чтобы продолжить. Следующие загрузки берут только изменённые компании и сделки.
  3. События исходящего вебхука попадают в тот же список на проверку.

Проверка и подтверждение ​

В блоке Проверка импорта видны загруженные записи: тип (пользователь, компания, сделка), название и сумма сделки.

  • Подтвердить выбранные или Подтвердить все на странице — создаёт или обновляет записи в CRM.
  • Пропустить выбранные — запись не попадёт в CRM.
В Битрикс24В системе
ПользовательСвязь с участником организации с тем же e-mail. Учётные записи не создаются; если участника нет, запись остаётся на проверке
КомпанияКлиент (компания)
СделкаЛид, привязанный к клиенту. Ответственный — связанный пользователь. Сумма и валюта сделки указываются в заметке

Повторная загрузка не создаёт дублей: каждая запись Битрикс24 связана с записью в системе. Если запись изменилась после подтверждения, она снова появится на проверке с пометкой «обновление». Удаление в Битрикс24 ничего не удаляет в системе.

Счета из сделок автоматически не создаются.

Отключение ​

Кнопка Отключить удаляет сохранённый вебхук и токен. Уже подтверждённые клиенты и лиды остаются. Сам вебхук в Битрикс24 удалите в портале.

Безопасность ​

  • Адрес вебхука и токен приложения хранятся только в зашифрованном виде.
  • Запросы к Битрикс24 ограничены по частоте (не больше 2 в секунду); при превышении лимита запрос повторяется с паузой.
  • Событие принимается только по секретному адресу обработчика, с верным токеном приложения и только от подключённого портала; повторная доставка не создаёт дублей.
  • Подключение, загрузки, отключение и каждая созданная запись записываются в журнал действий без ключей и токенов.

Ошибки ​

Последняя ошибка показывается на карточке. «bitrix_webhook_unauthorized» — вебхук удалён или у него нет прав: создайте новый и нажмите Заменить вебхук.

См. также: Интеграции финансов.

Документация для клиентов AIDIR · docs.aidir.kz