Skip to main content

Salebot – Как загружать клиентов через Webhook

ДИнтеграция с Salebot позволяет отправтоматически webhookпередавать данные о покупках в Vortex с помощью salebotAPI-запроса. Это удобно для учёта конверсий на любых этапах воронки – особенно после оплаты, когда клиент получает доступ к платному контенту.

1. Создание связки и получение Webhook-ключа

Перед настройкой в Salebot необходимо получить ключ вебхука на стороне в Vortex. Скопировать его можно во вкладке «Продажи» ➡️ «Управление конверсиями» в настройках вебхука.

Чтобы получить вебхук, нужно создать группу конверсий на вкладке «Продажи» и выбрать «Вебхук» в качестве источника.
Как это сделать описано в этой инструкции.

2. Настройка блока API-запроса в Salebot

В нужном месте цепочки (например, сразу после оплаты) добавиьтье блок с вложением «API-запрос
Описание изображения»

Он отмечается специальным значком в правом нижнем углу.

Описание изображения


Этот блок может располагаться, например, может находиться в начале платной цепочки бота, к которой получают доступ только оплатившие доступ клиенты
Описание изображения
Как видно, блок с отправкой API запроса имеет специальный значок справа снизу. Для того чтобы отправить webhook необходимо выполнить следующие действия:

1.Создание связки в сервисе и копирование ключа для запросов.

image.pngОписание изображения


Для копирования достаточно лишь нажать на соответствующую кнопку справа от ключа вебхука и он сохранится в буфере обмена.

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

Как это сделать описано здесь - https://docs.vortex.pro/sections/72-okno-upravlenie-konversiiami/page/kak-zagruzat-klientov-v-servis-algoritm



2. Вставкаьте скопированноый ссылкиURL с ключом в интполе «Адрфейс salebot
запроса»

image.pngУстановите:


  • Тип запроса: POST
  • Формат доланных: JSON

При желании быть POST-JSON, а вможно сохраняемых значениях по желанию можно указать ответ сервера в переменную (например, detail) для отладки

отп

image.png

3. Передавки webhook нча сервис.

3. Ввод информации в запрос. Данныех о клиенте.

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

являются
    только
  • telegram_id
    • telegram_id
  • username
    • или
tg_username.

В примере ниже отправляется полный набор иданфных.

Описание изображения

{
  "telegram_id": "#{platform_id}",
  "username": "#{telegram_username}",
  "purchase_price": "5000",
  "purchase_name": "дормации оступ клиенте курсу",
  который"purchased_at": п"#{current_date}"
}

Гдерешёл:

в
    блок
  • platform_id с отправкой запроса:
    Описание изображения
    В нём передаётся продажа от клиента со следующими параметрами:
    - platform_id -– переменная, котораяSalebot содержит idTelegram ID клиента
    -
  • telegram_username -– юusername пользоватернеймля
    • клиента
    -
  • purchase_price = 5000 -– ценсумма продажкупки
    • 5000
  • purchase_name рублей
    - purchase_name -– название продуктажи
    -
  • current_date - текущая– дата, хсовершения покупки

Начинящая с 19.05.25, не нужно удалять символ @ из юзернейма – наш веб-хук salebot
Такиморректно образбатывает егом,.

Проверкогда дрезультанныета

По продажсле отправлки запроса:

  • Конверсияются на webhook, то можем ожидать их появлениется в севыбрвисе ванно вкладке “Продажи” вй группе клиентов
  • Данные можно просмотреть во вкладке «Продажи»
  • Также доступна детальная выгрузка
Важно: Изменение формата ответа веб-хука (с 02.05.25)

Структура ответа обновлена. Актуальные названия переменных (на 15.05.2025):

Старое имяНовое имяОписание
data|joined_atdatetime_subscribeДата подписки
data|source|namesource_nameНазвание источника трафика
data|audience|nameaudience_nameИмя аудитории или подрядчика
data|creative|link_namechannel_nameНазвание ссылки, дляпо которой пришёл пользователь

Пример успешного ответа:

{
  "detail":"Successfully added sale",
  "data":{
    "telegram_id":1111111111
    "first_name":"Имя неизвестно",
    "last_name":null,
    "username":"classniyuser",
    "has_premium":false,
    "register_date":"2020-11-07T20:13:39",
    "joined_at":"2023-10-23T17:42:56",
    "left_at":null,
    "purchased_at":"2024-12-24T00:00:00",
    "purchase_name":"ЖИВОЙ вебылинар",
    "purchase_price":null,
    "seconds_until_purchase":36915424,
    "time_until_purchase_humanreadable":"427 д., 6 ч., 17 м.",
    "source":{"is_tgads":false,"name":"Telegram ADS"},
    "audience":{"name":"Бизнесозд каналы"},
    "creative":{
      "link":"https:\/\/t.me\/+zv0jFdsfgbsfgf",
      "link_name":"Бизнесвязка.
",
      
"is_active":true,
      
"with_join_request":false
      
},
   "is_bot":false
  }
}
Видео-объяснение с примером:

UPDATE 19.05.25: добавлять обработчик на исключение @ из юзернэйма больше не нужно. Наш вебхук обработает его 


UPDATE 02.05.25 : Внимание! Формат ответов вебхука изменился! Актуальные значения на 15.05.2025 переменных в ответе вебхука: 

data|joined_at -> datetime_subscribe; /* дата подписки */

data|source|name -> source_name;  /* Здесь может быть название канала трафика */

data|audience|name -> audience_name; /* Здесь может быть имя подрядчика по трафику / или аудитории */

Пример ответа: 

{"detail":"Successfully added sale","data":{"telegram_id":1111111111"first_name":"Имя неизвестно","last_name":null,"username":"classniyuser","has_premium":false,"register_date":"2020-11-07T20:13:39","joined_at":"2023-10-23T17:42:56","left_at":null,"purchased_at":"2024-12-24T00:00:00","purchase_name":"ЖИВОЙ вебинар","purchase_price":null,"seconds_until_purchase":36915424,"time_until_purchase_humanreadable":"427 д., 6 ч., 17 м.","source":{"is_tgads":false,"name":"Telegram ADS"},"audience":{"name":"Бизнес каналы"},"creative":{"link":"https:\/\/t.me\/+zv0jFdsfgbsfgf","link_name":"Бизнес","is_active":true,"with_join_request":false},"is_bot":false}}

Back to top