Webhook для CRM: 6 ошибок, из-за которых статусы лида теряются по дороге

Webhook для CRM: 6 ошибок, из-за которых статусы лида теряются по дороге

Когда лиды идут в CRM через webhook, ломается не только интеграция — ломается логика воронки. Чаще всего проблемы сидят не в самом запросе, а в формате данных и обработке ответа.

— Отправляют разные названия статусов в одном потоке: CRM видит «new», «New» и «новый» как три сущности.
— Не фиксируют уникальный id лида, из-за чего повторная отправка создаёт дубль вместо обновления.
— Путают «создано» и «обновлено»: один и тот же webhook может закрыть старую сделку или открыть новую.
— Не проверяют, как CRM отвечает на пустые поля, спецсимволы и нестандартные телефоны.

Ещё одна частая ошибка — слать webhook без очереди и повторных попыток. Если CRM временно не отвечает, событие должно сохраниться и уйти повторно, иначе статус потеряется без следа. Полезно сразу заложить логирование: timestamp, payload, ответ сервера, причина отказа.

Перед запуском проверьте схему маппинга: какой статус на входе, во что он превращается в CRM, и кто отвечает за перевод между этапами. Если есть коллбек на смену стадии, не запускайте его в тот же момент, когда идёт первичная запись лида — сначала сохранение, потом обновление.

Надёжный webhook — это не «отправил и забыл», а понятный протокол обмена: единый id, нормализация статусов и сохранение ошибок в логах.