Отправка информации с помощью Webhook

Содержание

Раскрыть полностью

Webhook — это механизм, с помощью которого система Neiros автоматически отправляет данные о событиях (лиды, звонки и т.д.) на указанный вами URL в реальном времени. Это позволяет интегрировать Neiros с CRM, аналитикой или любой другой внешней системой.

Neiros позволяет передавать данные о лидах, звонках и других действиях на сторонние серверы через Webhook. Это даёт возможность в реальном времени обрабатывать заявки, анализировать поведение клиентов и автоматизировать бизнес-процессы.

Настройка Webhook

Для настройки Webhook перейдите в раздел Настройки → Проекты, нажмите на иконку шестерёнки ⚙️ у нужного проекта и перейдите во вкладку "Webhook и API".

API-ключ

В этом разделе вы получите уникальный ключ сайта для использования в API:

26:8dc864e78315d04f3b3d88b8docoed8

Рекомендуется использовать его в заголовке авторизации:

Authorization: Bearer {API_KEY}

Передаваемые данные

Вы можете выбрать, какие события будут инициировать отправку Webhook:

Обратный звонок — данные из формы заказа обратного звонка;
Коллтрекинг — звонки, поступившие через подменные номера;
Форма с сайта — все формы, встроенные на сайт;
Ловец лидов — автоматическая фиксация лидов;
E-mail — лиды, содержащие email;
Статус звонка — события: дозвон, не дозвонились, занят;
Время разговора — длительность успешного звонка;

Дополнительно можно включить передачу UTM-меток для рекламной аналитики.

Как добавить Webhook

Введите URL, на который нужно отправлять данные (например: https://yourserver.com/api/webhook).
Отметьте необходимые чекбоксы.
Нажмите на иконку дискеты 💾 для сохранения.
Проверьте добавленные URL в списке ниже.

Пример передаваемого JSON

{
  "id": 670396,
  "project_id": 5517,
  "comment": "null",
  "created_at": "2025-04-11 19:47:28",
  "fio": "Кирилл",
  "phone": "77777777777",
  "email": "mail@outlook.com",
  "widget_type": 3,
  "form_name": "Регистрация",
  "url": null,
  "widget": "Форма с сайта 77763003033",
  "neiros_id": "17443900522600",
  "neiros_visit": "e51791f5-8e1f-414a-bb4b-d79851a769ea",
  "site": "neiros.ru",
  "source": "Google ",
  "kwiz": null,
  "_ym_uid": "17443898505432522549",
  "_gid": "1270843238.17443289849",
  "utm_medium": "",
  "utm_campaign": "",
  "utm_term": ""
}

Описание передаваемых полей

Основные поля

Поле	Описание
id	Уникальный ID события
project_id	ID проекта
created_at	Дата и время события
form_name	Название формы
comment	Комментарий
widget	Название виджета
widget_type	Тип виджета (1 — чат, 3 — форма и т.д.)

Контактные данные

Поле	Описание
fio	Имя клиента
phone	Телефон
email	Электронная почта

Поведенческие и сессионные

Поле	Описание
site	Домен сайта
url	URL страницы (может быть null)
source	Источник трафика
neiros_id	Уникальный ID пользователя
neiros_visit	Идентификатор визита
kwiz	Данные из квиза (если есть)

Аналитика

Поле	Описание
_ym_uid	ID пользователя Яндекс.Метрики
_gid	ID Google Analytics
utm_source	Источник трафика
utm_medium	Тип трафика
utm_campaign	Кампания
utm_term	Ключевое слово
utm_content	Контент объявления

Ответ сервера

Для успешной доставки данных сервер должен вернуть:

HTTP/1.1 200 OK

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

Тестирование

После настройки — отправьте тестовую заявку или совершите звонок;
Используйте webhook.site для отладки;
Просматривайте историю отправок через интерфейс;