Лидпульт

Как проверить вебхук и читать журнал отправок

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

· 5 мин чтения

Зачем проверять вебхук

Вебхук работает без вашего участия: заявка пришла, система сама вызвала адрес в CRM. Если что-то сломано, вы узнаете об этом не сразу, а когда менеджеры пожалуются, что новых сделок нет, а пациенты ждут звонка. Поэтому проверка нужна в трёх случаях: после первичной настройки, после любых изменений в CRM или на сервере и регулярно, например раз в неделю, как профилактика.

В кабинете клиники для этого есть кнопка «Отправить тестовую заявку» и журнал «Последние отправки» в блоке настроек, где задаётся адрес вебхука. Настройка вебхука описана в отдельной инструкции.

Шаги: тестовая заявка

  1. Откройте «Настройки» и блок «Заявки в вашу CRM».
  2. Убедитесь, что адрес вебхука сохранён: кнопка проверки доступна, только когда введённый адрес совпадает с сохранённым. Если вы только что изменили адрес, нажмите «Сохранить настройки».
  3. Нажмите «Отправить тестовую заявку». Сеть вызовет адрес с тестовыми данными в том же формате, что и боевые заявки.
  4. Посмотрите результат в кабинете: там показан ответ вашего сервера или причина ошибки.
  5. Откройте CRM и найдите тестовую сделку. Проверьте, что имя, телефон, город, оффер и дополнительная информация легли в нужные поля.
  6. Убедитесь, что назначен ответственный и что сработали автоматические действия: задача на звонок, уведомление менеджеру.
  7. Удалите тестовую сделку, чтобы она не попала в отчёты и не вызвала звонок несуществующему пациенту.
Тестовая заявка содержит условные данные. Предупредите менеджеров, что тестовая сделка появится, иначе кто-то попытается ей позвонить.

Как читать журнал «Последние отправки»

Журнал показывает последние попытки доставки заявок на ваш адрес: когда выполнялась попытка, какая заявка отправлялась и чем закончилась. Ориентируйтесь на такие признаки:

  • Успех (ответ 2xx). CRM приняла запрос. Если сделки всё равно нет, ищите проблему внутри CRM: правила создания, фильтры, права.
  • Ошибки 4xx. Сервер отверг запрос. Обычно это неверный путь, неверный токен в адресе или проверка формата.
  • Ошибки 5xx и обрывы. Проблема на стороне вашей CRM или сервера. Доставка будет повторяться до восьми раз с растущей паузой.
  • Отказ адреса. Если адрес не прошёл проверку безопасности (внутренняя сеть, localhost, редирект), запрос не выполнится.

Повторы одной заявки — нормальное явление при временных сбоях. Если ваша CRM принимает повторы без проверки, вы получите дубли сделок, поэтому используйте номер заявки lead_id как ключ для поиска существующей сделки.

Диагностика типичных проблем

  1. Журнал пуст при наличии новых заявок: проверьте, что адрес вебхука сохранён и не пустой.
  2. Все попытки с ошибкой соединения: проверьте, доступен ли адрес из интернета, действителен ли сертификат, не блокирует ли файрвол запросы.
  3. Ответ 301 или 302: сервер перенаправляет запрос. Укажите конечный адрес без редиректа.
  4. Ответ 401 или 403: проверьте токен или права на вебхук.
  5. Ответ 404: путь неверный или приёмник удалён.
  6. Ответ 5xx: посмотрите логи CRM или сервера в момент попытки.
  7. Ответ 2xx, но сделки нет: проверьте правила CRM, фильтры дублей и очереди обработки.

Воспроизводите запрос вручную: отправьте на адрес похожий POST с JSON и сравните поведение. Это быстро показывает, виноват ли адрес или сама заявка.

Что делать, если часть заявок не дошла

Если на время сбоя пришли заявки, которых нет в CRM, не паникуйте: все они остались в кабинете. Откройте раздел «Заявки», сверьте список с CRM за период сбоя и создайте недостающие сделки вручную либо передайте данные тем сотрудникам, которые будут обзванивать. Затем устраните причину и сделайте тестовую заявку.

  • Сначала обзвоните пациентов: срочность важнее порядка в CRM.
  • После устранения причины проверьте несколько реальных заявок подряд.
  • Если сбой повторяется, включите оповещение в вашей CRM о перерывах в приёме заявок.
  • Сообщите менеджеру сети, если проблема не на вашей стороне.

Типичные ошибки

  • Проверка не проводится после изменений. Сменили токен или домен CRM и забыли обновить адрес.
  • Игнорирование журнала. Ошибки накапливаются неделями.
  • Дубли сделок. Повторы доставки создают лишние карточки.
  • Адрес вне публичной сети. Тест не проходит, а причина неочевидна.
  • Тестовая сделка осталась в базе. Менеджер звонит по условному номеру.

Регламент регулярной проверки

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

Такой регламент занимает считанные минуты в неделю, но защищает от самой неприятной ситуации: когда несколько дней заявки приходили, а менеджеры о них не знали. Особенно это важно для клиник с высоким потоком, где каждая необработанная заявка — потерянные деньги. Если у вас несколько сотрудников, договоритесь, кто проверяет вебхук в выходные и праздники, а кто в рабочие дни.

  • Храните в общем документе адрес вебхука, но без секретных токенов.
  • Фиксируйте даты изменений CRM, чтобы связывать их со сбоями.
  • Назначьте контакт на стороне разработчика или подрядчика, который обслуживает CRM.

Как отличить проблему сети от проблемы CRM

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

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

Вопросы и ответы

Почему кнопка тестовой заявки неактивна?

Она доступна, когда адрес сохранён и совпадает с введённым. Сохраните настройки и повторите.

Сколько раз система повторяет доставку?

До восьми раз с растущей паузой между попытками.

Теряются ли заявки при сбое вебхука?

Нет, заявка остаётся в кабинете клиники независимо от результата доставки в CRM.

Как избежать дублей в CRM?

Сохраняйте lead_id в карточке и перед созданием новой сделки проверяйте, нет ли уже сделки с таким номером.

Как часто проверять вебхук?

После каждого изменения в CRM или на сервере и в целом регулярно, например раз в неделю.