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

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

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

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

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

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

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

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

Этот блок может располагаться, например, в начале платной цепочки бота, к которой получают доступ только оплатившие клиенты

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

Установите:

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

При желании можно сохранить ответ сервера в переменную (например, detail) для отладки

3. Передача данных о клиенте

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

• telegram_id
• username

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

{
  "telegram_id": "#{platform_id}",
  "username": "#{tg_username}",
  "purchase_price": "5000",
  "purchase_name": "доступ к курсу",
  "purchased_at": "#{current_date}"
}

Где:

• platform_id – переменная Salebot с Telegram ID клиента
• telegram_username – username пользователя
• purchase_price = 5000 – сумма покупки
• purchase_name – название продукта
• current_date – дата совершения покупки

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

Проверка результата

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

• Конверсия появится в выбранной группе клиентов
• Данные можно просмотреть во вкладке «Продажи»
• Также доступна детальная выгрузка

Важно: Изменение формата ответа веб-хука (с 02.05.25)

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

Старое имя	Новое имя	Описание
data|joined_at	datetime_subscribe	Дата подписки
data|source|name	source_name	Название источника трафика
data|audience|name	audience_name	Имя аудитории или подрядчика
data|creative|link_name	channel_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
  }
}

Видео-объяснение с примером