Подключение CRM

В этом руководстве вы шаг за шагом подключите CRM-систему Bitrix24 к воронке: настроите соединение, научитесь искать сущности и обновлять данные автоматически.

Что вам понадобится

• Административный доступ к порталу Bitrix24
• Рабочая воронка с данными (например, из руководства Создание первого воронки)

Шаг 1. Получите вебхук Bitrix24

Вебхук (webhook) - это URL для программного доступа к вашему порталу Bitrix24.

1. Войдите в Bitrix24 с правами администратора.
2. Перейдите в раздел Разработчикам (или Приложения -> Вебхуки).
3. Нажмите “Добавить входящий вебхук”.
4. В разделе “Права доступа” выберите необходимые разрешения:
   • crm - доступ к CRM
   • crm.contact - работа с контактами
   • crm.company - работа с компаниями
   • crm.deal - работа со сделками
   • crm.lead - работа с лидами
5. Нажмите “Сохранить”.
6. Скопируйте полученный URL вебхука. Он выглядит примерно так:

   https://your-domain.bitrix24.ru/rest/1/abc123xyz456/

Важно: храните URL вебхука в безопасности. Он предоставляет полный доступ к CRM от имени вашей учётной записи.

Шаг 2. Добавьте подключение CRM в системе

1. В приложении Pipeline Manager перейдите в Настройки (иконка шестерёнки в боковом меню).
2. Выберите раздел “CRM-подключения”.
3. Нажмите “Добавить подключение”.
4. Заполните форму:
   • Название: произвольное название (например, Основной Bitrix24)
   • Тип CRM: выберите Bitrix24
   • URL вебхука: вставьте скопированный URL
5. Нажмите “Сохранить”.

Данные подключения будут зашифрованы и сохранены в системе.

Шаг 3. Проверьте подключение

После сохранения нажмите “Проверить подключение”. Система отправит тестовый запрос к Bitrix24 и проверит доступность API. Если подключение успешно, вы увидите подтверждение с информацией о портале.

В случае ошибки:

• Проверьте правильность URL вебхука.
• Убедитесь, что портал Bitrix24 доступен.
• Проверьте, что вебхук не был отозван или деактивирован.

Шаг 4. Добавьте процессор “Поиск в CRM” в воронку

1. Откройте воронку в визуальном редакторе.
2. Перетащите процессор “Поиск в CRM” (CRM Search) на холст.
3. Соедините его с предыдущим процессором (например, с “Поиск в реестрах”).

Шаг 5. Настройте процессор “Поиск в CRM”

Кликните на узел процессора и заполните конфигурацию:

1. Подключение CRM: выберите из списка подключение, созданное на шаге 2.
2. Тип сущности: выберите тип (Компания, Контакт, Сделка, Лид).
3. Условия поиска: настройте, по какому полю искать. Например:

   INN = {{registry-search.inn}}

4. Сохраните настройки.

Этот процессор проверит наличие сущности в CRM и вернёт результат поиска: найдена компания или нет, а также её ID и данные.

Шаг 6. Добавьте процессор “Обновление CRM”

1. Перетащите процессор “Обновление CRM” (CRM Update) на холст.
2. Соедините его с процессором “Поиск в CRM”.

Шаг 7. Настройте маппинг полей

Кликните на процессор “Обновление CRM” и настройте, какие данные записать в CRM:

1. Подключение CRM: выберите то же подключение.
2. Тип сущности: выберите тип (например, Компания).
3. Действие: выберите Создать или обновить.
4. Маппинг полей: сопоставьте поля CRM с переменными из воронки:

Поле CRM	Значение
Название	{{registry-search.name}}
ИНН	{{file-upload.inn}}
Юридический адрес	{{registry-search.address}}
Руководитель	{{registry-search.director}}
Телефон	{{registry-search.phone}}
ОКВЭД	{{registry-search.okved}}

5. Сохраните настройки.

Шаг 8. Тестирование на одной записи

Перед обработкой всего массива данных рекомендуется провести тест:

1. В настройках процессора “Обновление CRM” установите maxPackets: 1.
2. Запустите воронку.
3. Дождитесь завершения.
4. Перейдите в Bitrix24 и убедитесь, что сущность была создана/обновлена корректно.
5. Проверьте, что все поля заполнены правильно.

Шаг 9. Запуск полной воронки

Если тестовая запись прошла корректно:

1. Верните значение maxPackets к нужному объёму (или удалите ограничение).
2. Запустите воронку.
3. Наблюдайте за прогрессом в реальном времени.
4. По завершении проверьте результаты в CRM.

Типичная архитектура воронки с CRM

Загрузка файла -> Поиск в реестрах -> Поиск в CRM -> Обновление CRM

• Загрузка файла: исходные данные (ИНН, названия)
• Поиск в реестрах: обогащение данными из открытых источников
• Поиск в CRM: проверка наличия сущности в CRM
• Обновление CRM: создание новой или обновление существующей сущности

Возможные проблемы

Проблема	Решение
Ошибка подключения	Проверьте URL вебхука и доступность портала
Ошибка прав доступа	Убедитесь, что вебхук имеет нужные разрешения
Дублирование записей	Используйте процессор “Поиск в CRM” перед созданием
Поля не заполняются	Проверьте маппинг полей и имена переменных
Превышен лимит запросов	Bitrix24 ограничивает 2 запроса в секунду, система учитывает это автоматически

Что дальше

• Использование переменных - расширенная работа с переменными в маппинге
• Настройка фильтров - фильтрация данных перед отправкой в CRM
• Решение проблем - диагностика ошибок интеграции