Webhook - Инструкция для отправки лидов
Отправка лидов на свой сервер. Инструкция для отправки лидов.
Для отправки лидов на свой сервер или в свою CRM следуйте инструкции ниже.
ШАГ 1 (Создание скрипта обработчика)
Методом POST, будут отправлены следующие параметры:
| Поле | Тип | Описание |
|---|---|---|
Id | Целочисленное значение | Идентификатор заявки в нашей системе. |
FullName | Символьное значение 63 знака | Ф.И.О. клиента. |
PhoneNumbers | Символьное значение 63 знака. | № телефонов клиента, разделенные через запятую (если несколько) в международном формате E.164. Например: «+79261112233,+79221112233». |
Email | Символьное значение 63 знака | Адрес электронной почты клиента. |
Brief | Символьное значение 2047 знаков | Дополнительная информация о заказе. |
Comment | Символьное значение 255 знаков | Служебный комментарий к заявке. |
Topic | Символьное значение 255 знаков | Тема обращения. |
Region | Символьное значение 127 знаков | Регион, указанный клиентом. Например: «Москва». |
RegionDeterminedISOCode | Символьное значение 6 знаков | ISO-код региона клиента, определенного системой. Например: «RU-MOS». |
RegionDeterminedName | Символьное значение 127 знаков | Название региона клиента, определенного системой. |
ProjectId | Целочисленное значение | Идентификатор проекта. |
ProjectName | Символьное значение 63 знака | Название проекта. |
ChannelId | Целочисленное значение | Идентификатор канала. |
ChannelName | Символьное значение 63 знака | Название канала. |
IPAddress | Символьное значение 45 знаков | IP-адрес клиента. |
UrlReferrer | Символьное значение 1023 знака | URL-адрес страницы, с которой отправлена заявка. |
UrlSource | Символьное значение 1023 знака | URL-адрес источника перехода на сайт. |
UserAgent | Символьное значение 255 знаков | UserAgent клиента. |
RecordUrl | Символьное значение 1023 знака | URL-записи разговора с клиентом. |
CustomParams[XYZ] | Символьное значение 1023 знака | Пользовательские параметры. Вместо XYZ будет указано имя параметра. Конструкций вида CustomParams[XYZ] может быть передано несколько, в зависимости от количества параметров. |
Формат ответа
Мы анализируем ответы вашего сервера в кодировке UTF-8 и в формате JSON.
В случае успешного запроса: { status: "success", id: "...", message: "..." }
В случае ошибки: { status: "error", message: "..." } или код ответа сервера отличный от 200, если заявка не была обработана вашим сервером.
ШАГ 2 (Настройка проекта)
- После того как вы создали обработчик POST-запросов, перейдите в настройки проекта и выберите для добавления интеграцию по Webhook.
- Укажите URL-адрес обработчика в настройках интеграции для выбранного проекта.
- Опционально укажите значения заголовка «Authorization», если вашему серверу требуется авторизация.
- Сохраните настройки проекта для применения изменений.
