Как проверить вебхук и читать журнал отправок
Настроенный вебхук нужно проверить до того, как по нему пойдут реальные заявки пациентов. Покажем, как использовать тестовую заявку и журнал отправок и как находить причины сбоев.
Зачем проверять вебхук
Вебхук работает без вашего участия: заявка пришла, система сама вызвала адрес в CRM. Если что-то сломано, вы узнаете об этом не сразу, а когда менеджеры пожалуются, что новых сделок нет, а пациенты ждут звонка. Поэтому проверка нужна в трёх случаях: после первичной настройки, после любых изменений в CRM или на сервере и регулярно, например раз в неделю, как профилактика.
В кабинете клиники для этого есть кнопка «Отправить тестовую заявку» и журнал «Последние отправки» в блоке настроек, где задаётся адрес вебхука. Настройка вебхука описана в отдельной инструкции.
Шаги: тестовая заявка
- Откройте «Настройки» и блок «Заявки в вашу CRM».
- Убедитесь, что адрес вебхука сохранён: кнопка проверки доступна, только когда введённый адрес совпадает с сохранённым. Если вы только что изменили адрес, нажмите «Сохранить настройки».
- Нажмите «Отправить тестовую заявку». Сеть вызовет адрес с тестовыми данными в том же формате, что и боевые заявки.
- Посмотрите результат в кабинете: там показан ответ вашего сервера или причина ошибки.
- Откройте CRM и найдите тестовую сделку. Проверьте, что имя, телефон, город, оффер и дополнительная информация легли в нужные поля.
- Убедитесь, что назначен ответственный и что сработали автоматические действия: задача на звонок, уведомление менеджеру.
- Удалите тестовую сделку, чтобы она не попала в отчёты и не вызвала звонок несуществующему пациенту.
Как читать журнал «Последние отправки»
Журнал показывает последние попытки доставки заявок на ваш адрес: когда выполнялась попытка, какая заявка отправлялась и чем закончилась. Ориентируйтесь на такие признаки:
- Успех (ответ 2xx). CRM приняла запрос. Если сделки всё равно нет, ищите проблему внутри CRM: правила создания, фильтры, права.
- Ошибки 4xx. Сервер отверг запрос. Обычно это неверный путь, неверный токен в адресе или проверка формата.
- Ошибки 5xx и обрывы. Проблема на стороне вашей CRM или сервера. Доставка будет повторяться до восьми раз с растущей паузой.
- Отказ адреса. Если адрес не прошёл проверку безопасности (внутренняя сеть, localhost, редирект), запрос не выполнится.
Повторы одной заявки — нормальное явление при временных сбоях. Если ваша CRM принимает повторы без проверки, вы получите дубли сделок, поэтому используйте номер заявки lead_id как ключ для поиска существующей сделки.
Диагностика типичных проблем
- Журнал пуст при наличии новых заявок: проверьте, что адрес вебхука сохранён и не пустой.
- Все попытки с ошибкой соединения: проверьте, доступен ли адрес из интернета, действителен ли сертификат, не блокирует ли файрвол запросы.
- Ответ 301 или 302: сервер перенаправляет запрос. Укажите конечный адрес без редиректа.
- Ответ 401 или 403: проверьте токен или права на вебхук.
- Ответ 404: путь неверный или приёмник удалён.
- Ответ 5xx: посмотрите логи CRM или сервера в момент попытки.
- Ответ 2xx, но сделки нет: проверьте правила CRM, фильтры дублей и очереди обработки.
Воспроизводите запрос вручную: отправьте на адрес похожий POST с JSON и сравните поведение. Это быстро показывает, виноват ли адрес или сама заявка.
Что делать, если часть заявок не дошла
Если на время сбоя пришли заявки, которых нет в CRM, не паникуйте: все они остались в кабинете. Откройте раздел «Заявки», сверьте список с CRM за период сбоя и создайте недостающие сделки вручную либо передайте данные тем сотрудникам, которые будут обзванивать. Затем устраните причину и сделайте тестовую заявку.
- Сначала обзвоните пациентов: срочность важнее порядка в CRM.
- После устранения причины проверьте несколько реальных заявок подряд.
- Если сбой повторяется, включите оповещение в вашей CRM о перерывах в приёме заявок.
- Сообщите менеджеру сети, если проблема не на вашей стороне.
Типичные ошибки
- Проверка не проводится после изменений. Сменили токен или домен CRM и забыли обновить адрес.
- Игнорирование журнала. Ошибки накапливаются неделями.
- Дубли сделок. Повторы доставки создают лишние карточки.
- Адрес вне публичной сети. Тест не проходит, а причина неочевидна.
- Тестовая сделка осталась в базе. Менеджер звонит по условному номеру.
Регламент регулярной проверки
Чтобы вебхук не ломался незаметно, закрепите проверку в регламенте клиники. Ответственный раз в неделю открывает журнал отправок и просматривает последние попытки. Если среди них есть ошибки, он выясняет причину в тот же день. После любых изменений в CRM — обновления, смены домена, перевыпуска токена, перехода на другой тариф — выполняется тестовая заявка. Результат фиксируется коротко: дата, кто проверял, всё ли прошло.
Такой регламент занимает считанные минуты в неделю, но защищает от самой неприятной ситуации: когда несколько дней заявки приходили, а менеджеры о них не знали. Особенно это важно для клиник с высоким потоком, где каждая необработанная заявка — потерянные деньги. Если у вас несколько сотрудников, договоритесь, кто проверяет вебхук в выходные и праздники, а кто в рабочие дни.
- Храните в общем документе адрес вебхука, но без секретных токенов.
- Фиксируйте даты изменений CRM, чтобы связывать их со сбоями.
- Назначьте контакт на стороне разработчика или подрядчика, который обслуживает CRM.
Как отличить проблему сети от проблемы CRM
Первое правило: заявка в кабинете есть — значит, сеть своё дело сделала. Дальше смотрите на журнал. Если попытки доставки выполняются и завершаются ошибкой, проблема на стороне адреса: CRM недоступна, отвергает запрос или отвечает слишком долго. Если попыток нет совсем, проверьте, указан ли адрес и сохранены ли настройки. Если попытки успешны, а сделок нет, ищите причину в настройках самой CRM: фильтры, правила дублей, права, очередь обработки.
Если вы не можете определить причину самостоятельно, напишите менеджеру сети и приложите время сбоя, номера нескольких заявок и скриншот журнала. Не пересылайте токены и пароли: для диагностики они не нужны.
Вопросы и ответы
Почему кнопка тестовой заявки неактивна?
Она доступна, когда адрес сохранён и совпадает с введённым. Сохраните настройки и повторите.
Сколько раз система повторяет доставку?
До восьми раз с растущей паузой между попытками.
Теряются ли заявки при сбое вебхука?
Нет, заявка остаётся в кабинете клиники независимо от результата доставки в CRM.
Как избежать дублей в CRM?
Сохраняйте lead_id в карточке и перед созданием новой сделки проверяйте, нет ли уже сделки с таким номером.
Как часто проверять вебхук?
После каждого изменения в CRM или на сервере и в целом регулярно, например раз в неделю.