Как подключить вебхук в CRM клиники и проверить доставку
Вебхук отправляет каждую новую заявку в вашу CRM автоматически, без ручного копирования. Разберём подготовку, подключение, проверку по журналу и действия при сбоях.
Зачем клинике вебхук
Без интеграции администратор переносит заявки руками: из кабинета в CRM. Это задержка, ошибки в телефонах и лишний шаг, на котором теряется время первого звонка. Вебхук убирает этот шаг: заявка попадает в CRM сразу после поступления, и сотрудник видит её в привычном интерфейсе.
В кабинете клиники вебхук настраивается самостоятельно, с проверкой и журналом отправок. Доставка клинике в сети идёт по трём каналам: статус «У клиента», сообщение в Telegram, если подключён бот, и вебхук в CRM. Каналы дополняют друг друга.
Что подготовить до подключения
- Адрес приёма. Публичный URL, на который CRM принимает входящие данные. Внутренние и локальные адреса не подойдут: внешние запросы из сети идут только на публичные адреса.
- Формат данных. Уточните у разработчика или поддержки CRM, какие поля она ожидает и в каком виде.
- Ответственного. Человека, который проверит интеграцию и будет разбирать ошибки.
- Тестовую среду, если она есть: сначала проверьте на ней.
Правила безопасности запросов
Внешние запросы сети, то есть постбэки и вебхуки, идут только на публичные адреса, без перехода по редиректам и с ограничением по времени ожидания. Это значит, что ваш приёмник должен отвечать быстро и по тому адресу, который вы указали, а не перенаправлять запрос на другой. Если ваш сервис отвечает перенаправлением, укажите конечный адрес сразу. Если приём занимает много времени, лучше принять данные и обработать их позже, а ответ вернуть сразу.
Пошаговое подключение
- Создайте в CRM точку приёма входящих заявок и получите её адрес.
- В кабинете клиники откройте раздел с настройкой вебхука и укажите адрес.
- Запустите проверку: система отправит тестовое обращение.
- Убедитесь, что запись появилась в CRM с правильными полями: имя, телефон, услуга, город.
- Откройте журнал отправок и проверьте код ответа вашего сервера.
- Только после этого рассчитывайте на интеграцию в рабочем режиме.
Не пропускайте проверку: чаще всего ошибки — неверный адрес или формат поля — обнаруживаются на тестовой отправке, а не после потери реальных заявок.
Как читать журнал отправок
Журнал показывает каждую попытку отправки, время и ответ вашего сервера. Если ответ успешный, значит, CRM приняла данные. Если нет, смотрите код и текст ошибки. Система повторяет доставку до восьми раз с растущей паузой, чтобы переждать временные сбои. Поэтому однократная ошибка обычно проходит сама, а серия неудач — повод проверить приёмник.
| Симптом | Вероятная причина |
|---|---|
| Ошибка соединения | Адрес недоступен или указан неверно |
| Ошибка ответа сервера | CRM не приняла формат полей |
| Долгое ожидание | Приёмник отвечает слишком медленно |
| Ответ-перенаправление | Нужно указать конечный адрес без редиректа |
Защита от дублей на стороне CRM
Из-за повторных доставок одна и та же заявка может прийти в CRM несколько раз. Настройте в CRM поиск дубля по телефону и идентификатору заявки, чтобы повтор не создавал вторую карточку. Идентификатор заявки передаётся вместе с данными, и по нему удобно сопоставлять записи. Это особенно важно, если интеграция строит автоматические задачи на звонок: дубль создаст лишнюю задачу.
Типичные ошибки
- Указан адрес из внутренней сети, недоступный из интернета.
- Приёмник отвечает перенаправлением на другую страницу.
- В CRM не создано поле для услуги или города, и часть данных теряется.
- Никто не смотрит журнал: ошибки накапливаются, пока не станет заметно по пустой очереди заявок.
- Вебхук подключён, но Telegram отключён, и при сбое CRM администраторы не узнают о заявке. Лучше держать оба канала.
Подробнее об уведомлениях для администраторов читайте в статье про Telegram.
Какие данные обычно нужны CRM
Чтобы администратор мог сразу позвонить, в карточке должны быть имя, телефон, услуга и город. Полезно также передавать время поступления и идентификатор заявки, чтобы потом сопоставлять записи. Утверждать конкретный набор полей мы не будем: его определяет формат вебхука, и он может отличаться, поэтому сверяйтесь с тем, что показывает проверка в кабинете. Главное, чтобы в вашей CRM заранее были созданы поля под все значения, иначе часть сведений потеряется или упадёт в комментарий.
Отдельно продумайте, куда будет попадать заявка: в общую очередь, к конкретному сотруднику или в задачу на звонок. Чем меньше ручных шагов после поступления, тем быстрее первый звонок.
Тестирование и приёмка интеграции
Перед тем как считать интеграцию готовой, пройдите короткий сценарий. Отправьте проверку из кабинета и убедитесь, что карточка создалась. Проверьте, что телефон записан без искажений, а кириллица в именах не превратилась в нечитаемые символы. Посмотрите, что произойдёт при повторной отправке: не появится ли вторая карточка. Временно отключите приёмник и убедитесь, что журнал показывает ошибки, а заявка при этом остаётся в кабинете. Такой тест занимает меньше часа и защищает от неприятных сюрпризов в первые дни работы.
Мониторинг после запуска
После запуска интеграции раз в неделю заходите в журнал отправок и смотрите долю неуспешных попыток. Если она растёт, значит, изменилось что-то на стороне CRM: обновление, смена адреса, ограничения по доступу. Сверяйте число заявок в кабинете с числом новых карточек в CRM: расхождение указывает на потери. Закрепите за этим ответственного и запишите порядок действий при сбое, чтобы проблема не зависела от одного человека.
Что дальше
Когда интеграция работает, настройте в CRM автоматическую задачу «позвонить в течение N минут» и отчёт по источникам. Это даст возможность измерять скорость первого звонка и конверсию в запись. Если в процессе возникнут вопросы по параметрам, формат данных описан для вебмастеров на странице документации API, а подключение клиники согласуется через контакты.
Вопросы и ответы
Что делать, если CRM временно недоступна?
Система повторяет доставку до восьми раз с растущей паузой. Если сбой долгий, заявки не пропадут: они видны в кабинете клиники и приходят в Telegram.
Можно ли указать адрес из локальной сети?
Нет, внешние запросы идут только на публичные адреса.
Нужно ли отключать Telegram после подключения вебхука?
Не нужно. Telegram остаётся резервным каналом, и при сбое CRM администраторы всё равно увидят заявку.
Как проверить, что интеграция работает?
Используйте кнопку проверки и смотрите журнал отправок: там видны время попытки и ответ вашего сервера.
Кто должен настраивать вебхук: маркетолог или разработчик?
Адрес приёма и поля в CRM обычно настраивает тот, кто администрирует CRM, а в кабинете адрес подставляет маркетолог. Лучше, чтобы они проверили интеграцию вместе.