Битрикс24
Подключение Битрикс24 забирает из вашего портала пользователей, компании и сделки через входящий вебхук. Система работает поверх Битрикс24: данные загружаются на проверку и попадают в CRM только после вашего подтверждения. Битрикс24 продолжает работать как раньше.
Статус подключения — Бета. Ключи платформы не нужны: вебхук создаёте вы в своём портале.
Как подключить
- В Битрикс24 откройте Разработчикам → Другое → Входящий вебхук.
- Выберите права CRM (crm) и Пользователи (user) и сохраните. Скопируйте адрес вида
https://company.bitrix24.kz/rest/1/xxxxxxxx/. - В системе откройте Коннекторы (
/connectors) → карточка Битрикс24. - Вставьте адрес в поле Адрес входящего вебхука и нажмите Подключить Битрикс24. Система сразу проверит, что вебхук работает.
Адрес вебхука — это ключ доступа. Он хранится в зашифрованном виде и после подключения больше не показывается. Чтобы сменить вебхук, вставьте новый адрес и нажмите Заменить вебхук.
Подключать и отключать может владелец или администратор организации.
Изменения из Битрикс24 (необязательно)
Чтобы изменения в Битрикс24 приходили сами, без ручной загрузки:
- Скопируйте Адрес обработчика с карточки Битрикс24.
- В Битрикс24 создайте Исходящий вебхук с этим адресом и событиями: добавление/изменение/удаление компании, добавление/изменение/удаление сделки, добавление пользователя.
- Скопируйте выданный Токен приложения и вставьте его на карточке, нажмите Сохранить токен.
Пока токен не сохранён, события из Битрикс24 не принимаются.
Как загрузить данные
- Нажмите Загрузить из Битрикс24. Сначала загружаются пользователи, потом компании, потом сделки.
- Если данных много, загрузка идёт частями — нажмите кнопку ещё раз, чтобы продолжить. Следующие загрузки берут только изменённые компании и сделки.
- События исходящего вебхука попадают в тот же список на проверку.
Проверка и подтверждение
В блоке Проверка импорта видны загруженные записи: тип (пользователь, компания, сделка), название и сумма сделки.
- Подтвердить выбранные или Подтвердить все на странице — создаёт или обновляет записи в CRM.
- Пропустить выбранные — запись не попадёт в CRM.
| В Битрикс24 | В системе |
|---|---|
| Пользователь | Связь с участником организации с тем же e-mail. Учётные записи не создаются; если участника нет, запись остаётся на проверке |
| Компания | Клиент (компания) |
| Сделка | Лид, привязанный к клиенту. Ответственный — связанный пользователь. Сумма и валюта сделки указываются в заметке |
Повторная загрузка не создаёт дублей: каждая запись Битрикс24 связана с записью в системе. Если запись изменилась после подтверждения, она снова появится на проверке с пометкой «обновление». Удаление в Битрикс24 ничего не удаляет в системе.
Счета из сделок автоматически не создаются.
Отключение
Кнопка Отключить удаляет сохранённый вебхук и токен. Уже подтверждённые клиенты и лиды остаются. Сам вебхук в Битрикс24 удалите в портале.
Безопасность
- Адрес вебхука и токен приложения хранятся только в зашифрованном виде.
- Запросы к Битрикс24 ограничены по частоте (не больше 2 в секунду); при превышении лимита запрос повторяется с паузой.
- Событие принимается только по секретному адресу обработчика, с верным токеном приложения и только от подключённого портала; повторная доставка не создаёт дублей.
- Подключение, загрузки, отключение и каждая созданная запись записываются в журнал действий без ключей и токенов.
Ошибки
Последняя ошибка показывается на карточке. «bitrix_webhook_unauthorized» — вебхук удалён или у него нет прав: создайте новый и нажмите Заменить вебхук.
См. также: Интеграции финансов.