Интеграция с CRM

1. Опишите поток данных

До разработки перечислите сущности и направление обмена: лиды, сделки, контакты, товары или задачи. Для каждого поля определите источник истины и момент обновления.

Сразу решите, как обрабатывать дубли, удаление и изменение записей одновременно в двух системах.

2. Выберите тип интеграции

Для внутренней автоматизации одного портала подойдёт локальный вебхук. Для тиражируемого решения и нескольких клиентов нужна OAuth-интеграция или приложение.

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

3. Создайте вебхук безопасно

Создайте отдельного технического пользователя и выдайте только нужные права. В разделе разработчика создайте локальную интеграцию и выберите минимальный набор REST-областей.

Храните URL вебхука как секрет на сервере, а не в JavaScript браузера или репозитории.

4. Выполните тестовый REST-запрос

Начните с безопасного метода чтения и проверьте JSON-ответ. Затем добавьте создание тестовой записи в отдельной воронке.

Используйте собственный URL; пример нельзя копировать как рабочий ключ.

5. Добавьте контроль и повторы

Проверяйте HTTP-код и поле error, журналируйте идентификатор запроса и время без секретов. Для временных ошибок используйте ограниченные повторы с увеличением интервала.

Учитывайте лимиты REST и пакетные методы. Повторная отправка не должна создавать дубли.