Webhooks между CRM и рекламой ломаются не в коде, а в логике событий

Webhooks между CRM и рекламой ломаются не в коде, а в логике событий

Интеграция через webhook выглядит просто: лид создан — отправили событие в рекламную систему, сделка закрыта — вернули оффер в оптимизацию. На практике ошибки появляются на стыке идентификаторов, статусов и тайминга.

Проверьте три слоя:
— уникальный ключ лида: client_id, gclid, fbclid, external_id должны сохраняться в CRM без обрезки;
— маппинг статусов: «новый», «квалифицирован», «оплачен» должны иметь однозначные правила отправки;
— защиту от дублей: один и тот же webhook не должен создавать повторную конверсию при ретрае.

Дальше важен формат payload. Не передавайте только «успех/неуспех» — рекламной площадке нужны параметры для атрибуции: сумма, валюта, источник, timestamp, номер заказа. Если CRM шлёт событие раньше, чем фиксируется сделка, вы получаете шум в оптимизации и ложные сигналы для алгоритма.

Логируйте всё: входящий payload, ответ API, код ошибки, время доставки. Аналитика показала аномалию, разбираем техническую причину.

Если webhook не проходит проверку на идемпотентность и полноту данных, автоматизация не масштабирует результат, а масштабирует хаос.