Вебхук CRM: как передавать данные лидов в ваши системы

Рядом с CRM почти всегда живут ваши системы: учётная программа, склад, свой сайт, платформа обучения или таблицы руководителя. Без вебхука CRM менеджер вносит сделку дважды: сначала в CRM, потом в учётную программу. Это потерянное время, опечатки в телефонах и суммах, а иногда — забытые заказы.

Раздел «Менеджер webhook» убирает двойной ввод. Вебхук — это автоматическое сообщение из CRM на адрес вашей системы. При каждом изменении лида его данные сами уходят туда POST-запросом, то есть отправкой данных на сервер. Ваша система получает их сразу и сама решает, что делать. Отдельной платы за вебхуки нет.

Посмотрите видео на две минуты, а ниже — пошаговая настройка.

Зачем бизнесу вебхуки из CRM

• Товарный бизнес. Лид перешёл на шаг вроде «Оплачен» — запрос уходит в складскую или учётную программу, и там создаётся заказ на отгрузку. Менеджер больше не дублирует заказ руками.
• Онлайн-школа. При платеже по лиду ваш скрипт находит ученика по email или телефону и открывает доступ к курсу. Куратора ждать не нужно.
• Клиника, салон. Лид дошёл до шага записи — данные клиента уходят в программу учёта записей или в таблицу администратора.
• B2B-продажи. На шаге выставления счёта учётная система получает реквизиты и сумму из полей лида и готовит счёт. Бухгалтерия не ждёт письма от менеджера.
• Маркетинг. Шаги и оплаты уходят в своё хранилище, где их сводят с расходами на рекламу. Получается своя сквозная аналитика поверх данных CRM.

Что именно делать с данными, решает обработчик — программа на стороне вашей системы.

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

1. Любое изменение лида — смена шага воронки продаж в CRM, правка полей, новый комментарий или платёж — отправляет POST-запрос.
2. В запросе полные данные лида: номер и название, поля лида с шагом воронки и ответственным, контакт с телефонами и email.
3. Запрос уходит на каждый адрес из списка вебхуков проекта. Два вебхука — два запроса на каждое изменение.

Каждое изменение — отдельный запрос. Поэтому обработчик должен обновлять запись по номеру лида, а не создавать новую каждый раз. Нужны свои данные, например ИНН или адрес доставки, — сначала заведите для них дополнительные поля в CRM. Точный формат данных — в «Документации по API» в меню «Помощь».

Как настроить вебхук в CRM

1. 1
   Откройте раздел

   Меню слева «Помощь» → «Менеджер webhook».
2. 2
   Выберите проект

   В блоке «Проект». У каждого проекта свои вебхуки. Раздел запоминает последний выбранный проект в этом браузере, поэтому проверяйте поле при каждом входе.
3. 3
   Нажмите «Добавить вебхук»

   Откроется окно «Новый вебхук».
4. 4
   Заполните «Название»

   Понятное имя, например «sklad_zakazy». Оно должно быть уникальным в проекте.
5. 5
   Вставьте «URL»

   Адрес обработчика вашей системы, лучше с https://.
6. 6
   Нажмите «Сохранить»

   Появится сообщение «Вебхук добавлен», и вебхук встанет в список.

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

Раздел проверяет только формат адреса: тестовый запрос он не отправляет и журнал отправок не показывает. Поэтому проверьте сами:

1. Добавьте вебхук с адресом обработчика. Или временно — с адресом онлайн-сервиса для просмотра входящих запросов.
2. Измените тестового лида этого проекта: переведите на другой шаг или добавьте комментарий.
3. Посмотрите журнал своего сервера: должен прийти POST-запрос с данными лида.

Временный тестовый вебхук потом удалите, чтобы данные клиентов не уходили на чужой сервис.

Куда можно принимать данные из CRM

• Свой сервер или сайт — скрипт, который пишет данные в вашу базу.
• Учётные и складские программы — если они умеют принимать HTTP-запросы, или через программиста-интегратора.
• Google Таблицы — через скрипт таблицы, опубликованный как веб-приложение.
• Сервисы автоматизации, которые дают свой адрес для приёма вебхуков.

Адрес должен быть доступен из интернета и принимать POST-запросы. Для https:// нужен действующий сертификат.

Нужной интеграции нет в списке: что делать

Готовые связки в кабинете есть для мессенджеров, Avito, почты, форм и конструкторов сайтов, Яндекс Метрики, amoCRM, Битрикс24, Yclients и Google Календаря. Если вашей системы среди них нет, связь можно собрать через API и вебхуки:

• «Вебхуки при изменении лида» — этот раздел: данные лида уходят в вашу систему при каждом изменении. Подходит для учётных программ, складов, своих сайтов и таблиц.
• «Документация по API» в меню «Помощь» — запросы, которыми ваша система сама создаёт лидов и читает данные кабинета. Как передать заявку с источником, разобрано в статье создание лида в crm через api.
• «Запись webhook» голосового бота и целевое действие «Запись вебхук» чат-бота — после разговора бот сам отправляет на ваш адрес GET-запрос с данными из диалога, а параметры задаются переменными вида ${…}. Подробнее — в статье база знаний для голосового бота.

Доработка нужна, если у вашей системы нет API, она не принимает запросы или нужна сложная логика обмена. Тогда напишите в отдел интеграции: пункт «Отдел интеграции ai» в меню «Помощь» открывает его Telegram-бот.

Правила для названия и адреса вебхука

• «Название» — обязательно, до 255 символов и уникально в проекте. Названия, которые отличаются только регистром или пробелами по краям, считаются одинаковыми. Пустое поле — «Введите название», повтор — «Вебхук с таким названием уже есть — название должно быть уникальным.».
• «URL» — обязательно, до 2000 символов и без пробелов. Адрес начинается с http:// или https:// и содержит домен с зоной, например https://example.com/webhook.php. Пустое поле — «Введите адрес», неверный формат — «Адрес должен начинаться с http:// или https://».
• Ошибки при сохранении. «Сессия истекла, войдите заново» — войдите в кабинет ещё раз и повторите. «Не удалось сохранить вебхук. Попробуйте ещё раз.» — сбой связи, сохраните снова. Экран «Доступ запрещён» — у сотрудника нет права «Настройка CRM» в проекте.

Читайте также: Воронка продаж в CRM, Автоворонка продаж, Офлайн-конверсии в Яндекс Метрике, Интеграция с amocrm, Интеграция с битрикс24, Создание лида в crm через api