Как настроить вебхук и получать заявки сразу в свою CRM
Вебхук отправляет каждую новую заявку в вашу CRM POST-запросом в формате JSON. Так менеджеры работают в привычной системе, а не переписывают заявки вручную. Разберём настройку.
Как работает вебхук
Вебхук — адрес в вашей CRM или на вашем сервере. Когда в Лидпульте появляется новая заявка для вашей клиники, система вызывает этот адрес POST-запросом и передаёт данные заявки в формате JSON. В теле запроса есть поля: номер заявки (lead_id), имя (name), телефон (phone), город (city), оффер (offer) и дополнительная информация (info).
Такой способ подходит для популярных CRM, например amoCRM и Bitrix24, и для собственного сервера. Если адрес вебхука не указан, заявки доступны только в кабинете.
Что подготовить в CRM
- Публичный адрес, по которому CRM или ваш сервер принимает POST-запросы.
- Правило: какое поле CRM соответствует каждому полю JSON. Например, телефон — в поле контакта, оффер — в источник,
lead_id— в пользовательское поле для сверки. - Определение ответственного менеджера, чтобы новая заявка не оставалась без владельца.
- Защиту адреса: добавьте в адрес секретный параметр, который известен только вам.
Не все CRM принимают произвольный JSON напрямую. В таких случаях используется промежуточный обработчик или входящий вебхук CRM со своим форматом: уточните это в документации вашей системы.
Шаги: настройка вебхука
- В CRM создайте приёмник заявок и скопируйте его публичный адрес.
- Откройте кабинет клиники, раздел «Настройки», блок «Заявки в вашу CRM».
- Вставьте адрес в поле «Адрес вебхука CRM». Подсказка показывает формат:
https://ваша-crm.ru/webhook/…. - Нажмите «Сохранить настройки».
- Нажмите «Отправить тестовую заявку»: кнопка активна, когда адрес сохранён. Сеть отправит тестовые данные на ваш адрес.
- Проверьте в CRM, что заявка создалась, поля заполнились, а ответственный назначен. Подробный порядок проверки — в инструкции про проверку вебхука и журнал.
- После успешной проверки дождитесь реальной заявки и сверьте её данные.
Чтобы отключить передачу в CRM, очистите поле адреса и сохраните настройки.
Требования к адресу и повторы
Внешние запросы выполняются только на публичные адреса. Адреса внутренних сетей и localhost не принимаются. Запросы идут без перенаправлений и с ограниченным временем ожидания, поэтому адрес должен отвечать быстро и сразу, без редиректов.
- Используйте
httpsи действующий сертификат. - Отвечайте кодом 2xx, когда заявка принята.
- Не отвечайте редиректом.
- Делайте обработчик идемпотентным: при сбоях доставка повторяется до восьми раз с растущей паузой, и CRM должна уметь распознавать повтор по
lead_id.
Если CRM недоступна, заявка остаётся в кабинете, и вы можете обработать её там, не дожидаясь возобновления связи.
Безопасность и персональные данные
Через вебхук передаются персональные данные пациентов. Сеть хранит их на серверах в России, и клиника как оператор отвечает за последующую обработку в своей CRM. Позаботьтесь о том, чтобы CRM находилась в юрисдикции, допустимой по закону о персональных данных, а доступ к ней был ограничен.
- Добавьте в адрес секретный токен и проверяйте его в обработчике.
- Не публикуйте адрес вебхука в открытых источниках.
- Ограничьте права сотрудников, которые видят телефоны пациентов.
- Периодически меняйте токен и обновляйте адрес.
Типичные ошибки
- Внутренний адрес. Адрес в закрытой сети недоступен для внешних запросов.
- Редирект с http на https. Указывайте конечный адрес сразу.
- Медленный обработчик. CRM долго обрабатывает запрос, и доставка считается неудачной.
- Дубли заявок в CRM. Повторы доставки без проверки
lead_idсоздают повторные карточки. - Неверное сопоставление полей. Телефон попадает в комментарий, а не в контакт.
- Забыли сохранить настройки. Тестовая кнопка недоступна, пока введённый адрес не совпадает с сохранённым.
Пример сопоставления полей
Покажем, как удобно сопоставить поля. Допустим, в вашей CRM есть карточка сделки с полями «Контакт», «Телефон», «Город», «Источник» и «Комментарий». Тогда name попадает в имя контакта, phone — в телефон, city — в город, offer — в источник или название услуги, info — в комментарий, а lead_id — в пользовательское поле «Номер в Лидпульте». Последнее поле очень важно: по нему вы сверяете заявки с кабинетом и распознаёте повторные доставки.
- Создайте в CRM пользовательское поле для номера заявки.
- Настройте правило поиска по этому полю, чтобы повторный запрос не создавал новую сделку.
- Назначьте ответственного по умолчанию или правило распределения.
- Настройте напоминание о звонке по новой сделке.
- Проверьте на тестовой заявке, что все поля заполнены правильно.
Если CRM не умеет разбирать JSON без дополнительной настройки, используйте входящий вебхук с поддерживаемым форматом или небольшой промежуточный обработчик, который принимает запрос сети и создаёт сделку через API CRM.
Кто отвечает за результат
Передача данных в CRM — зона ответственности клиники. Сеть гарантирует доставку по описанным правилам: повторы при сбоях, журнал отправок. Если же CRM приняла запрос, но не создала сделку, причину нужно искать в настройках CRM. Поэтому ведите регламент: кто проверяет цепочку, кто чинит, кто сообщает менеджеру сети о сбоях.
Если у клиники нет CRM
Не у каждой клиники есть CRM, и это нормально. Если системы нет, используйте кабинет и Telegram: заявки приходят в кабинет сразу, бот сообщает о каждой, а итог звонка ставится в таблице. Для небольшой клиники этого достаточно. Когда поток вырастет и появится потребность в сквозной аналитике и автоматических задачах менеджерам, подключите CRM и вебхук. Не усложняйте инфраструктуру раньше времени: сначала налаживайте процесс обзвона, а потом автоматизируйте.
Контрольный список перед запуском
- Адрес публичный, начинается с https и не использует редиректы.
- В CRM есть поле для номера заявки и правило против дублей.
- Назначен ответственный за новые сделки.
- Тестовая заявка прошла, поля заполнены, тестовая сделка удалена.
- Журнал отправок просмотрен, ошибок нет.
- Команда знает, что делать, если CRM недоступна: работать с заявками в кабинете.
Вопросы и ответы
Какой формат у запроса?
POST-запрос с телом в JSON. В нём поля lead_id, name, phone, city, offer, info.
Работает ли вебхук с amoCRM и Bitrix24?
Подходит для таких систем при условии, что они принимают входящие запросы по публичному адресу. Уточните формат приёма в документации CRM.
Что если CRM недоступна?
Доставка повторится до восьми раз с растущей паузой. Заявка в любом случае остаётся в кабинете.
Можно ли использовать вебхук вместе с Telegram?
Да, оба канала работают независимо друг от друга.
Нужно ли подтверждать приём ответом?
Отвечайте кодом 2xx быстро: это признак успешной доставки.