Skip to main content

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

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

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

image.png


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

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

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



2. Вставка скопированной ссылки с ключом в интерфейс salebot

image.png


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

3. Ввод информации в запрос. Данные о клиенте.
Для добавления продажи необходимо отправить данные о клиенте. Обязательными для отправки являются только telegram_id или tg_username. В примере ниже отправляется полный набор информации о клиенте, который перешёл в блок с отправкой запроса:
Описание изображения
В нём передаётся продажа от клиента со следующими параметрами:
- platform_id - переменная, которая содержит id клиента
- telegram_username - юзернейм клиента
- purchase_price = 5000 - цена продажи 5000 рублей
- purchase_name - название продажи
- current_date - текущая дата, хранящаяся в salebot
Таким образом, когда данные о продаже отправляются на webhook, то можем ожидать их появление в сервисе во вкладке “Продажи” в группе клиентов, для которой была создана связка.

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

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