Лидпульт

Как настроить вебхук и получать заявки сразу в свою CRM

Вебхук отправляет каждую новую заявку в вашу CRM POST-запросом в формате JSON. Так менеджеры работают в привычной системе, а не переписывают заявки вручную. Разберём настройку.

· 5 мин чтения

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

Вебхук — адрес в вашей CRM или на вашем сервере. Когда в Лидпульте появляется новая заявка для вашей клиники, система вызывает этот адрес POST-запросом и передаёт данные заявки в формате JSON. В теле запроса есть поля: номер заявки (lead_id), имя (name), телефон (phone), город (city), оффер (offer) и дополнительная информация (info).

Такой способ подходит для популярных CRM, например amoCRM и Bitrix24, и для собственного сервера. Если адрес вебхука не указан, заявки доступны только в кабинете.

Вебхук — это односторонняя передача: из сети в CRM. Итог звонка вы по-прежнему проставляете в кабинете: от него зависят статус заявки и выплата вебмастеру.

Что подготовить в CRM

  • Публичный адрес, по которому CRM или ваш сервер принимает POST-запросы.
  • Правило: какое поле CRM соответствует каждому полю JSON. Например, телефон — в поле контакта, оффер — в источник, lead_id — в пользовательское поле для сверки.
  • Определение ответственного менеджера, чтобы новая заявка не оставалась без владельца.
  • Защиту адреса: добавьте в адрес секретный параметр, который известен только вам.

Не все CRM принимают произвольный JSON напрямую. В таких случаях используется промежуточный обработчик или входящий вебхук CRM со своим форматом: уточните это в документации вашей системы.

Шаги: настройка вебхука

  1. В CRM создайте приёмник заявок и скопируйте его публичный адрес.
  2. Откройте кабинет клиники, раздел «Настройки», блок «Заявки в вашу CRM».
  3. Вставьте адрес в поле «Адрес вебхука CRM». Подсказка показывает формат: https://ваша-crm.ru/webhook/….
  4. Нажмите «Сохранить настройки».
  5. Нажмите «Отправить тестовую заявку»: кнопка активна, когда адрес сохранён. Сеть отправит тестовые данные на ваш адрес.
  6. Проверьте в CRM, что заявка создалась, поля заполнились, а ответственный назначен. Подробный порядок проверки — в инструкции про проверку вебхука и журнал.
  7. После успешной проверки дождитесь реальной заявки и сверьте её данные.

Чтобы отключить передачу в CRM, очистите поле адреса и сохраните настройки.

Требования к адресу и повторы

Внешние запросы выполняются только на публичные адреса. Адреса внутренних сетей и localhost не принимаются. Запросы идут без перенаправлений и с ограниченным временем ожидания, поэтому адрес должен отвечать быстро и сразу, без редиректов.

  • Используйте https и действующий сертификат.
  • Отвечайте кодом 2xx, когда заявка принята.
  • Не отвечайте редиректом.
  • Делайте обработчик идемпотентным: при сбоях доставка повторяется до восьми раз с растущей паузой, и CRM должна уметь распознавать повтор по lead_id.

Если CRM недоступна, заявка остаётся в кабинете, и вы можете обработать её там, не дожидаясь возобновления связи.

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

Через вебхук передаются персональные данные пациентов. Сеть хранит их на серверах в России, и клиника как оператор отвечает за последующую обработку в своей CRM. Позаботьтесь о том, чтобы CRM находилась в юрисдикции, допустимой по закону о персональных данных, а доступ к ней был ограничен.

  • Добавьте в адрес секретный токен и проверяйте его в обработчике.
  • Не публикуйте адрес вебхука в открытых источниках.
  • Ограничьте права сотрудников, которые видят телефоны пациентов.
  • Периодически меняйте токен и обновляйте адрес.

Типичные ошибки

  • Внутренний адрес. Адрес в закрытой сети недоступен для внешних запросов.
  • Редирект с http на https. Указывайте конечный адрес сразу.
  • Медленный обработчик. CRM долго обрабатывает запрос, и доставка считается неудачной.
  • Дубли заявок в CRM. Повторы доставки без проверки lead_id создают повторные карточки.
  • Неверное сопоставление полей. Телефон попадает в комментарий, а не в контакт.
  • Забыли сохранить настройки. Тестовая кнопка недоступна, пока введённый адрес не совпадает с сохранённым.

Пример сопоставления полей

Покажем, как удобно сопоставить поля. Допустим, в вашей CRM есть карточка сделки с полями «Контакт», «Телефон», «Город», «Источник» и «Комментарий». Тогда name попадает в имя контакта, phone — в телефон, city — в город, offer — в источник или название услуги, info — в комментарий, а lead_id — в пользовательское поле «Номер в Лидпульте». Последнее поле очень важно: по нему вы сверяете заявки с кабинетом и распознаёте повторные доставки.

  1. Создайте в CRM пользовательское поле для номера заявки.
  2. Настройте правило поиска по этому полю, чтобы повторный запрос не создавал новую сделку.
  3. Назначьте ответственного по умолчанию или правило распределения.
  4. Настройте напоминание о звонке по новой сделке.
  5. Проверьте на тестовой заявке, что все поля заполнены правильно.

Если CRM не умеет разбирать JSON без дополнительной настройки, используйте входящий вебхук с поддерживаемым форматом или небольшой промежуточный обработчик, который принимает запрос сети и создаёт сделку через API CRM.

Кто отвечает за результат

Передача данных в CRM — зона ответственности клиники. Сеть гарантирует доставку по описанным правилам: повторы при сбоях, журнал отправок. Если же CRM приняла запрос, но не создала сделку, причину нужно искать в настройках CRM. Поэтому ведите регламент: кто проверяет цепочку, кто чинит, кто сообщает менеджеру сети о сбоях.

Если у клиники нет CRM

Не у каждой клиники есть CRM, и это нормально. Если системы нет, используйте кабинет и Telegram: заявки приходят в кабинет сразу, бот сообщает о каждой, а итог звонка ставится в таблице. Для небольшой клиники этого достаточно. Когда поток вырастет и появится потребность в сквозной аналитике и автоматических задачах менеджерам, подключите CRM и вебхук. Не усложняйте инфраструктуру раньше времени: сначала налаживайте процесс обзвона, а потом автоматизируйте.

Контрольный список перед запуском

  1. Адрес публичный, начинается с https и не использует редиректы.
  2. В CRM есть поле для номера заявки и правило против дублей.
  3. Назначен ответственный за новые сделки.
  4. Тестовая заявка прошла, поля заполнены, тестовая сделка удалена.
  5. Журнал отправок просмотрен, ошибок нет.
  6. Команда знает, что делать, если CRM недоступна: работать с заявками в кабинете.

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

Какой формат у запроса?

POST-запрос с телом в JSON. В нём поля lead_id, name, phone, city, offer, info.

Работает ли вебхук с amoCRM и Bitrix24?

Подходит для таких систем при условии, что они принимают входящие запросы по публичному адресу. Уточните формат приёма в документации CRM.

Что если CRM недоступна?

Доставка повторится до восьми раз с растущей паузой. Заявка в любом случае остаётся в кабинете.

Можно ли использовать вебхук вместе с Telegram?

Да, оба канала работают независимо друг от друга.

Нужно ли подтверждать приём ответом?

Отвечайте кодом 2xx быстро: это признак успешной доставки.