Webhook ломается не в CRM, а в мелочах: 5 проверок перед запуском

Webhook ломается не в CRM, а в мелочах: 5 проверок перед запуском

Webhook — это не просто «отправить данные по адресу». В интеграциях конструкторов с CRM чаще всего ломаются три вещи: формат полей, обязательность параметров и логика повторной отправки. Если в конструкторе поле называется «Телефон», а CRM ждёт `phone`, данные могут уйти, но не попасть в сделку.

Проверь перед запуском:
— совпадают ли типы полей: строка, число, дата;
— есть ли обязательные поля и чем они заполняются при пустом ответе;
— не дублируются ли заявки при повторной отправке;
— передаётся ли уникальный идентификатор формы или лида;
— можно ли отследить ответ CRM и понять, принята заявка или нет.

Отдельно смотри на ошибки таймаута и ретраев. Если конструктор не дождался ответа, он может отправить webhook ещё раз, а CRM создаст дубликат. Чтобы этого не было, на стороне CRM полезно проверять id заявки и отклонять повтор.

Самая рабочая схема — сначала отправить webhook в тестовый endpoint, посмотреть сырой payload, а потом уже маппить поля в CRM. Так ты ловишь ошибки до того, как они превращаются в потерянные лиды.