Лидпульт

Вебхук в CRM: ответы на вопросы

Вебхук передаёт новые заявки прямо в CRM клиники, без ручного переноса. Разбираем настройку, проверку и поведение при сбоях.

Как работает вебхук

Когда заявка попадает к клинике, сеть отправляет запрос на адрес вашей CRM, который вы задали в кабинете. Так заявка появляется в системе без ручного переноса, и сотрудник сразу видит её в привычном интерфейсе.

Проверка и журнал

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

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

Что делает вебхук?

Отправляет данные новой заявки на адрес вашей CRM. Это автоматизирует доставку: заявка попадает в систему клиники сразу после приёма, а не после того, как сотрудник зайдёт в кабинет.

Как подключить вебхук?

Укажите адрес приёма заявок вашей CRM в кабинете клиники и воспользуйтесь кнопкой проверки. Точные поля настройки определяются интерфейсом. Для интеграции с вашей CRM может потребоваться помощь разработчика или интегратора.

Как проверить, что вебхук работает?

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

Что будет, если CRM не ответила?

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

Каким должен быть адрес вебхука?

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

Что такое таймаут и почему он важен?

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

Почему запрос не должен перенаправляться?

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

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

Повторы возможны, если CRM не ответила, но заявку приняла. Чтобы избежать дублей, идентифицируйте заявку по номеру lead_id и не создавайте вторую запись для того же номера. Ответ отправляйте только после успешной обработки.

Нужен ли вебхук, если есть Telegram-бот?

Это разные каналы. Бот для людей, вебхук для автоматизации. Если у клиники нет CRM или заявки обрабатывают вручную, достаточно бота. Но с вебхуком меньше потерь и ручной работы. См. страницу про Telegram-уведомления.

Безопасно ли передавать данные в CRM?

Данные пациентов хранятся в сети на серверах в России. В CRM они попадают по адресу, который задали вы, поэтому следите за защитой своей системы и доступом сотрудников. Подробнее — на странице про персональные данные.