Документация / Интеграция с SaleBot / Интеграция с Salebot

Интеграция с Salebot

salebotтариф базычат-боты

Для чего нужна интеграция

  • Запускать нужную воронку в SaleBot при регистрации, после вебинара или при оплате.
  • Передавать переменные в профиль клиента и в переменные сделки — дату вебинара, ссылку на комнату, статус оплаты и любые другие данные.
  • Отправлять текстовые сообщения клиенту через SaleBot в тот мессенджер, где он подписан.

Подключение SaleBot

Подробная инструкция по ссылке.

1 Откройте раздел сервисов

В Vakas-tools перейдите в «Сервисы и доступы» → «Добавить сервис» → выберите SaleBot.

2 Введите название и API-ключ

  1. Введите произвольное название подключения.
  2. Введите API-ключ из вашего проекта SaleBot.

3 Сохраните

Нажмите «Добавить сервис». Система проверит ключ — при успешной авторизации подключение появится в списке.

Где взять API-ключ: личный кабинет SaleBot → настройки проекта → API.

Если появляется ошибка «Ошибка подключения» — проверьте ключ: он должен быть скопирован полностью, без пробелов. Если ключ изменился — откройте существующее подключение и нажмите «Обновить».

Подготовка

У вас должны быть:

  1. Сайт на Tilda с формой регистрации и страницей «Спасибо»;
  2. Подключённый бот в SaleBot;
  3. База в Vakas-tools (куда будут попадать данные).

Подключение Tilda к Vakas-tools

Перейдите в Vakas-tools → База → Ссылки → Регистрации.

Раздел ссылок

Скопируйте Webhook.

Копирование вебхука

Перейдите в Tilda → Настройки сайта.

Настройки сайта Tilda

Выберите в меню слева «Формы».

Раздел Формы в Tilda

Спуститесь по странице вниз до раздела «Другое», выберите «Webhook».

Выбор Webhook

Вставьте скопированный webhook.

Вставка вебхука

Нажмите Добавить → Закрыть.

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

Подключенные сервисы
Установка галочки

Важно:

  1. поля email и phone должны быть обязательными;
  2. переменные для e-mail и телефона не переименовывать (оставить стандартные Tilda, латиница, в маленьком регистре).

Поля формы

Настройка страницы «Спасибо» на Tilda

На странице «Спасибо» добавьте кнопку для подписки в Telegram.

Кнопка подписки на Telegram

В SaleBot → Ссылки → Мессенджеры скопируйте ссылку на Telegram-бота.

Ссылка на Telegram-бота

Вставьте её в кнопку на странице «Спасибо».

Вставка ссылки в кнопку

Перейдите во вкладку «Регистрации». Для передачи данных с формы регистрации на страницу «Спасибо» скопируйте соответствующий скрипт.

Скрипт передачи данных

В редакторе страницы нажмите «+ → Другое → T123 HTML code»;

Добавление HTML блока
HTML code блок

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

Нажмите на «Сохранить и закрыть». Опубликуйте (кнопка справа вверху страницы).

Вставка скрипта

Аналогично вставьте скрипт на саму страницу «Спасибо», чтобы данные передавались в кнопку бота.

Скрипт на странице Спасибо

Опубликуйте страницу.

Проверка передачи данных с Tilda

Заполните форму регистрации.

После перехода на страницу «Спасибо» проверьте: в адресной строке должны отображаться имя, e-mail, телефон, UTM-метки.

В базе Vakas-tools должны появиться переданные контакты.

Передача данных из SaleBot в Vakas-tools

Скопируйте в ссылках для базы в разделе «Регистрации» снова «Webhook для Tilda».

Копирование вебхука для Tilda

В SaleBot → Конструктор → Блок «Спасибо за регистрацию» добавьте API-запрос:

Тип запроса: POST-data.

URL: вставьте скопированный webhook для Tilda.

API-запрос в SaleBot

JSON-параметры: используйте шаблон из инструкции (не изменяйте).

JSON параметры

В поле «JSON параметры» в фигурных скобках укажите параметры, которые будут передаваться в Vakas-tools:

{
  "ss_id": "#{client_id}",
  "client_id": "#{client_id}",
  "name": "#{name}",
  "phone": "#{phone}",
  "email": "#{email}",
  "utm_source": "#{utm_source}",
  "utm_medium": "#{utm_medium}",
  "utm_campaign": "#{utm_campaign}",
  "import": "update"
}

Если вы используете прямую интеграцию Salebot с Vakas-tools (т.е. не используете Tilda или Getcourse) и регистрации поступают с лендинга напрямую в базу, обязательно необходимо запрашивать у участников контакты (email, телефон). При этом в поле «JSON параметры» параметр "import": "update" необходимо удалить. Сохраните блок.

Настройка передачи событий (регистрации, с вебинара или заказов) в Salebot

Общие настройки

Открываются кнопкой «Настройки» на странице сервиса. Применяются ко всем правилам данного подключения SaleBot в этой базе.

Идентификация клиента в SaleBot

SaleBot требует client_id для выполнения любого действия. Система определяет его в следующем порядке:

  1. Из поля «Client ID (откуда брать)» — если указан шорткод, берётся значение из него.
  2. По SS ID — поле ss_id в данных контакта (если было передано при регистрации).
  3. По email — запрос к API SaleBot по email контакта.
  4. По телефону — запрос к API SaleBot по телефону контакта.
  5. По Platform ID — если указано поле «Platform ID (откуда брать)».

Если клиент не найден ни одним способом — все действия вернут ошибку «Нет client_id».

Поля настроек:

Поле Описание
Client ID (откуда брать) Шорткод, содержащий client_id клиента в SaleBot. Например, {#client_id#} или {#ss_id#}. Если пусто — поиск выполняется автоматически по ss_id, email, телефону.
Platform ID (откуда брать) Шорткод для идентификации по Platform ID — используется как дополнительный фоллбэк, если email и телефон не дали результата.

Совет: если клиент регистрируется через форму Tilda и вы передаёте client_id через скрытое поле формы — укажите шорткод в поле «Client ID (откуда брать)». Это самый надёжный способ.

Конструктор действий

Открывается кнопкой «Действия» напротив нужного правила. Доступно 3 действия.

Действие 1: Запустить воронку

Запускает воронку в SaleBot через callback — имитирует входящее сообщение от клиента, которое инициирует нужную воронку.

Поле Описание
Сообщение Текст callback — должен совпадать с текстом, настроенным как триггер воронки в SaleBot. Например: /start_webinar. Поддерживает шорткоды.

Воронка запускается только если в SaleBot есть воронка с таким текстом в качестве триггера. Если воронка не настроена — запрос выполнится без ошибки, но ничего не произойдёт.

Действие 2: Переменные

Сохраняет переменные в SaleBot. По умолчанию — в переменные сделки. Чтобы записать в профиль клиента — используйте префикс client. перед названием переменной.

Поле Описание
Название в SaleBot (левая колонка) Название переменной. Для записи в профиль — с префиксом client. (например, client.phone)
Значение (правая колонка) Значение. Поддерживает шорткоды.

Можно добавить несколько пар переменных. Нажмите «Добавить» для добавления строки. Пустые пары пропускаются.

Примеры:

Название в SaleBot Значение Куда записывается
webinar_date {#webinar_date#} Переменная сделки
webinar_link {#room_link#} Переменная сделки
client.name {#name#} Профиль клиента
client.phone {#phone#} Профиль клиента
order_status {#payment_status#} Переменная сделки

Действие 3: Сообщение

Отправляет текстовое сообщение клиенту через SaleBot — в тот мессенджер, где он подписан.

Поле Описание
Текст сообщения Текст для отправки. Поддерживает шорткоды.

Настройка правил

Передача данных в SaleBot настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.

Создание правила

1 Перейдите на нужную вкладку

2 Нажмите «Добавить правило»

3 Заполните поля

  • Правило активно — поставьте галочку.
  • Название — например, «Все регистрации», «Кликнул по кнопке», «Оплатил».
  • Порядок — число, определяющее очерёдность (1, 2, 3...). Правила выполняются от меньшего к большему.
  • После выполнения не выполнять другие правила — если включить, при срабатывании этого правила остальные пропускаются.

4 Нажмите «Сохранить изменения»

Настройка условий

1 В правиле нажмите «Добавить условие»

2 Заполните строку

  • Поле — выберите поле из базы (например: «был минут», «кликал ли по кнопке», «utm_source»).
  • Условие — оператор: =, , >, <, , , содержит, не содержит.
  • Значение — значение для сравнения.

Несколько условий объединяются через И — все должны выполниться одновременно.

Правило без условий

Правило без условий срабатывает для всех лидов. Рекомендуется создавать как первое правило — чтобы все лиды были переданы.

Порядок выполнения правил

  1. Проверяет условия правила.
  2. Если условия выполнены — выполняет действия.
  3. Если включена галочка «После выполнения не выполнять другие правила» — остальные пропускаются.
  4. Если галочка не включена — переходит к следующему правилу.

После создания правила нажмите «Действия» напротив него — откроется конструктор действий.

Передача регистраций в SaleBot

Цель: при регистрации на вебинар передать данные в SaleBot — переменные (дата вебинара, ссылка) и запустить нужную воронку прогрева.

1 Создайте правило на вкладке «Регистрации»

  1. Перейдите на вкладку «Регистрации».
  2. Нажмите «Добавить правило».
  3. Название: Все регистрации. Порядок: 1. Галочка «Правило активно».
  4. Оставьте правило без условий — чтобы все регистрации передавались.
  5. Сохраните.

2 Настройте действия

Нажмите «Действия» напротив правила.

2.1. Передайте переменные

Нажмите «Добавить действие» → Переменные.

Добавление переменных

Названия переменных — только латиница, нижнее подчеркивание, без пробелов. Переменные записываются по умолчанию в заявку. Чтобы записать в профиль клиента, укажите client. перед названием переменной.

Настройка переменных

При передаче кастомных полей используйте шорткоды: {#reg_field_Имя переменной#}
Пример для поля «age» - {#reg_field_age#}.

Шорткоды кастомных полей

Какие ещё есть переменные:

Название в SaleBot Значение (шорткод) Что передаётся
webinar_date {#webinar_date#} Дата вебинара
webinar_time {#webinar_time#} Время вебинара
webinar_link {#room_link#} Ссылка на комнату
client.name {#name#} Имя (в профиль)

Нажмите иконку {--} рядом с полем значения, чтобы увидеть список доступных шорткодов.

2.2. Запустите воронку

Нажмите «Добавить действие» → Запустить воронку. В поле «Сообщение» укажите текст callback, настроенный в SaleBot, например: reg

Запуск воронки

Для запуска — перейдите в Salebot и скопируйте триггер.

Триггер в SaleBot
Копирование триггера

2.3. Отправьте сообщение (по желанию)

Действие Сообщение

Нажмите «Добавить действие» → Сообщение. Укажите текст:

Вы зарегистрированы! Вебинар {#webinar_date#} в {#webinar_time#}. Ссылка: {#room_link#}

Важные условия

  1. Без email или телефона лид не попадёт в Vakas-tools.
  2. Переменные email и phone должны оставаться стандартными.
  3. Если контактов нет — лид попадёт с «технической почтой», но для аналитики это бесполезно.

Передача отчётов в SaleBot

Цель: после вебинара передать данные об активности (время просмотра, клики по кнопкам) в SaleBot — запустить нужную воронку в зависимости от поведения зрителя.

Создайте правила на вкладке «Отчёты»

Перейдите на вкладку «Отчёты».

Правило 1 — Все лиды (без условий)

1 Нажмите «Добавить правило»

2 Заполните данные

Название: Все лиды. Порядок: 1. Галочка «Правило активно».

3 Оставьте без условий

Чтобы все лиды обрабатывались.

4 Сохраните

Важно: первое правило оставляйте без условий. Иначе лиды, не подходящие ни под одно условие, не передадутся в SaleBot.

Правило 2 — По активности (с условиями)

1 Нажмите «Добавить правило»

2 Заполните данные

Название: Был на вебинаре. Порядок: 2. Галочка «Правило активно».

3 Добавьте условие

Поле = был минут, Условие = >, Значение = 30.

4 Сохраните

Правило 3 и далее

Добавляйте дополнительные правила по нужной логике:

  • «Кликнул по кнопке» — условие: кликал ли по кнопке = 1
  • «Не был на вебинаре» — условие: был минут < 1
  • «Был больше 90 минут» — условие: был минут > 90

Настройте действия каждого правила (Отчёты)

Для правила «Все лиды»

Нажмите «Действия» → добавьте переменные:

Название в SaleBot Значение (шорткод) Что передаётся
bil_minut {#bil_minut#} Сколько минут был
click_button {#clickFile#} Кликал ли по кнопке

Добавьте действие Запустить воронку с callback для обработки всех зрителей, например: veb

Переменные для отчётов
Запуск воронки для отчётов
Настройка действий отчётов

Для правила «Был на вебинаре»

Добавьте Запустить воронку с callback для тёплых лидов, например: warm_lead

Для правила «Кликнул по кнопке»

Добавьте Запустить воронку с callback для горячих лидов, например: hot_lead

Записать Переменные:

Переменные для горячих лидов

Переменные записываются по умолчанию в заявку. Чтобы записать в профиль клиента, укажите client. перед названием переменной. Названия переменных: латиница, нижнее подчеркивание, без пробелов. Пример: visit_web

Используем шорткоды «Для отчетов» и «Базовые».

Шорткоды для отчётов

Можно также отправить Сообщение:

Привет, ты был на вебинаре! Вот ваша ссылка на запись: {#room_link#}
Сообщение для зрителей
Пример сообщения

Передача заказов и оплат в SaleBot

Цель: при создании заказа или оплате передать данные в SaleBot — переменные оплаты, запустить воронку дожима или подтверждения.

Заказы и оплаты (или частичные оплаты) должны передаваться в базу, из которой будете настраивать передачу в Salebot. Лиды должны быть подписаны на вашего бота. Если контакт не подписан — данные не передадутся.

Проверка проходит по SSID или email:

  • если регистрация идет напрямую через Salebot → проверка по SSID;
  • если регистрация через другую базу → проверка по email.

Создайте правила на вкладке «Заказы»

Перейдите на вкладку «Заказы».

Правило 1 — Все заказы (без условий)

1 Нажмите «Добавить правило»

2 Заполните данные

Название: Все заказы. Порядок: 1. Галочка «Правило активно».

3 Оставьте без условий

4 Сохраните

Правило 2 — Оплатил

1 Нажмите «Добавить правило»

2 Заполните данные

Название: Оплатил. Порядок: 2. Включите «После выполнения не выполнять другие правила».

3 Добавьте условия

  • Поле: оплачено, Условие: >, Значение: 0
  • Поле: осталось оплатить, Условие: =, Значение: 0

4 Сохраните

Правило 3 — Не оплатил

1 Заполните данные

Название: Новая заявка. Порядок: 3.

2 Добавьте условия

  • Поле: оплачено, Условие: =, Значение: 0
  • Поле: осталось оплатить, Условие: >, Значение: 0

3 Сохраните

Настройте действия каждого правила (Заказы)

Нажмите «Действия» → добавьте переменные:

Переменные заказов

Переменные записываются по умолчанию в заявку. Чтобы записать в профиль клиента, укажите client. перед названием переменной.

Примеры:

number → в заявку попадёт номер заказа.

client.number → номер заказа пропишется в профиль клиента.

Названия переменных: латиница, нижнее подчеркивание, без пробелов. Пример: tarif_name, cost_money.

Для произвольных полей (например, возраст) используем шорткод: {#pay_field_Имя переменной#}

Шорткоды для заказов
Пример переменных заказа
Название в SaleBot Значение (шорткод) Что передаётся
order_number {#payment_number#} Номер заказа
tariff {#positions#} Название тарифа
amount {#costMoney#} Сумма заказа
paid {#payedMoney#} Оплачено
left {#leftCostMoney#} Осталось оплатить
order_status {#payment_status#} Статус платежа

Добавьте Запустить воронку

Например: vse

Запуск воронки для заказов
Настройка воронки

Добавьте Сообщение:

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

Спасибо за оплату! Тариф: {#positions#}. Сумма: {#costMoney#} руб.
Пример сообщения для заказов

Частые вопросы

Ошибка «Нет client_id»
Клиент не найден в SaleBot. Проверьте:
  1. Есть ли у контакта email или телефон в базе Vakas-tools?
  2. Зарегистрирован ли клиент в боте SaleBot — он должен хотя бы раз написать боту.
  3. Совпадают ли email/телефон в Vakas-tools и SaleBot?
  4. Если передаёте client_id из формы — проверьте, что шорткод в «Общих настройках» указан верно.
Воронка не запускается
Проверьте, что текст в поле «Сообщение» действия «Запустить воронку» точно совпадает с callback-триггером воронки в SaleBot (с учётом регистра и пробелов).
Переменные не появляются в профиле клиента
По умолчанию переменные записываются в переменные сделки. Чтобы записать в профиль клиента — добавьте префикс client. к названию (например, client.phone).
Сообщение не доставляется
Проверьте: клиент подписан на бот SaleBot? Не заблокировал ли бота? Есть ли активный канал (Telegram, VK, WhatsApp)?
Ошибка «Ошибка подключения» при сохранении сервиса
Неверный API-ключ. Проверьте, что ключ скопирован полностью, без пробелов. Ключ находится в настройках проекта SaleBot.
Как узнать, по какому параметру был найден клиент?
В логах выполнения правила указывается resolved_by — способ нахождения клиента: из настроек, по ss_id, по email или по телефону.

Видео-инструкция

00:00 Передача регистраций из Salebot

07:15 Передача регистраций в Salebot

17:23 Передача заказов в Salebot

33:17 Передача отчетов в Salebot

Общие настройки правил для передачи регистраций

Общие настройки правил для передачи заказов

Общие настройки правил для передачи отчетов

×