Webhook ломается не в CRM, а на этапе приема: 6 проверок перед запуском

Webhook ломается не в CRM, а на этапе приема: 6 проверок перед запуском

Webhook — это не «магия отправки формы», а обычный POST-запрос, который должен дойти в нужный URL, с нужным методом и понятным форматом. Если интеграция молчит, сначала проверяйте не CRM, а сам маршрут: адрес, доступность, ответ сервера и структуру payload.

— URL должен быть точным: без лишних слэшей, пробелов и редиректов.
— Метод запроса должен совпадать с тем, что ждёт приемник: чаще всего POST.
— Поля формы нужно маппить явно: имя, телефон, email, UTM, источник.
— Ответ сервера лучше делать простым: 200 OK и короткое тело, чтобы отправитель не считал запрос ошибкой.
— Если есть вложенные данные, проверьте кодировку и типы: строка, число, массив.
— Логируйте каждый запрос и ответ, иначе отладка превращается в угадайку.

Частая проблема — дубли. Они появляются, когда форма отправляется повторно, CRM не видит уникальный ключ или сервер отвечает слишком долго. Для защиты добавьте идентификатор заявки, проверьте таймауты и не запускайте повторную отправку без причины.

Ещё один типовой сбой — «всё ушло, но не создалось». Обычно причина в обязательном поле, пустом токене, неверном формате телефона или скрытой ошибке на стороне обработчика.

Если webhook не работает, начинайте с тестового запроса в изолированной цепочке: один URL, одна форма, один лид. Так вы быстро поймёте, где рвётся интеграция.