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», если вашему серверу требуется авторизация.
- Сохраните настройки проекта для применения изменений.
