Вебхук в CRM: ответы на вопросы
Вебхук передаёт новые заявки прямо в CRM клиники, без ручного переноса. Разбираем настройку, проверку и поведение при сбоях.
Как работает вебхук
Когда заявка попадает к клинике, сеть отправляет запрос на адрес вашей CRM, который вы задали в кабинете. Так заявка появляется в системе без ручного переноса, и сотрудник сразу видит её в привычном интерфейсе.
Проверка и журнал
В кабинете клиники есть проверка вебхука и журнал отправок. Проверка показывает, отвечает ли адрес, а журнал сохраняет результат каждой попытки доставки. Это помогает быстро находить, где возникает сбой: у вас или у сети.
Вопросы и ответы
Что делает вебхук?
Отправляет данные новой заявки на адрес вашей CRM. Это автоматизирует доставку: заявка попадает в систему клиники сразу после приёма, а не после того, как сотрудник зайдёт в кабинет.
Как подключить вебхук?
Укажите адрес приёма заявок вашей CRM в кабинете клиники и воспользуйтесь кнопкой проверки. Точные поля настройки определяются интерфейсом. Для интеграции с вашей CRM может потребоваться помощь разработчика или интегратора.
Как проверить, что вебхук работает?
В кабинете есть проверка, она отправляет тестовый запрос на ваш адрес. Затем посмотрите журнал отправок: там видно, с каким результатом завершилась попытка. Если ответа нет, проверьте доступность адреса снаружи.
Что будет, если CRM не ответила?
Сеть повторяет доставку до 8 раз с растущей паузой. Это защищает от кратковременных сбоев: CRM может быть недоступна пару минут из-за обновления. Если все попытки неудачны, заявка остаётся в кабинете, и вы можете обработать её вручную.
Каким должен быть адрес вебхука?
Публичным: внешние запросы идут только на публичные адреса, без редиректов и с таймаутом. Адреса внутренних сетей и localhost не принимаются. Если ваша CRM стоит во внутренней сети, потребуется публичная точка входа.
Что такое таймаут и почему он важен?
Таймаут — предельное время ожидания ответа. Если ваша CRM отвечает слишком долго, запрос считается неудачным и повторяется. Поэтому принимайте заявку быстро и отвечайте сразу, а тяжёлую обработку выносите в фон.
Почему запрос не должен перенаправляться?
Для безопасности внешние запросы идут без редиректов: сеть не следует за перенаправлениями. Если ваш адрес перенаправляет на другой, вебхук не сработает. Укажите конечный адрес сразу.
Как не получить дубли в CRM при повторах?
Повторы возможны, если CRM не ответила, но заявку приняла. Чтобы избежать дублей, идентифицируйте заявку по номеру lead_id и не создавайте вторую запись для того же номера. Ответ отправляйте только после успешной обработки.
Нужен ли вебхук, если есть Telegram-бот?
Это разные каналы. Бот для людей, вебхук для автоматизации. Если у клиники нет CRM или заявки обрабатывают вручную, достаточно бота. Но с вебхуком меньше потерь и ручной работы. См. страницу про Telegram-уведомления.
Безопасно ли передавать данные в CRM?
Данные пациентов хранятся в сети на серверах в России. В CRM они попадают по адресу, который задали вы, поэтому следите за защитой своей системы и доступом сотрудников. Подробнее — на странице про персональные данные.