Как подключить BotHelp

BotHelp поддерживает ограниченную интеграцию с Откуда Подписки, доступен функционал:

• Передача активаций бота в рекламные системы Яндекс/ФБ/Гугл/ВК, оптимизация на старты бота
• Аналитическая отчетность по аудитории: источники трафика, полный список подписчиков, utm метки откуда пришли (только подписки)
• Аналитическая отчетность по подпискам: переходы в бота, конверсии в подписку
• Ежедневные отчеты бота
  “подписки 24ч”
• Досье подписчика
• Глубокие цели
  

Следуйте по шагам для настройки подключения:

1. Настройка передачи webhook для BotHelp

1. Для интеграции необходимо получить API ключ. Как получить API ключ тут.
2. В самом боте после Старт, создайте действие.

3. В действии выберите “Отправить данные подписчика через Webhook”

2. Проверка подключения

Для проверки работоспособности интеграции используйте нашу страницу тестирования:
https://bot-api.tgtrack.ru/last_events/

Укажите ваш API ключ (который получили на шаге 1) и проверьте последние 100 запросов.

Проверим, что BotHelp действительно передаёт старт, стоп, а сервис Откуда Подписки принимает его без ошибок. Статус обработки событий должен быть – 0.

Особенности:

Если ваша воронка не запускается, то допишите параметр к ссылке бота ?nochange на ленде.

1) с параметром старт: https://t.me/ВАШБОТ/?start=СТАРТСЛОВО&nochange=1
2) без параметра старт: https://t.me/ВАШ_БОТ/?nochange=1

Если у вас несколько воронок, которые запускаются по разным значениям параметра start бота, то в ссылке на вашего бота укажите нужный параметр: СтартСлово – параметр по которому стартует та или иная воронка.

nochange – запрещает нашему сервису изменять значение параметра старт.

Как настроить API для передачи глубокой цели из бота на BotHelp

Если вы используете бота на платформе BotHelp и хотите передавать данные о глубокой цели (например, результат теста) в рекламную систему, выполните следующие шаги:

1. Создайте действие в воронке с передачей данных

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

2. Настройте внешний запрос

Укажите URL для отправки данных в сервис Откуда Подписки бот.

Пример URL, на который надо послать запрос, укажите ваш API ключ, полученный от Откуда Подписки: 

В тело запроса добавьте следующий JSON:

{
  "user_id": "{%user_id%}",
  "target": "testResult"
}Code language: JSON / JSON with Comments (json)

user_id: Переменная {%user_id%} автоматически подставит уникальный ID пользователя из BotHelp.
target: Это идентификатор вашей глубокой цели. Например, "testResult" означает, что пользователь завершил тест.
Code language: HTTP (http)

Если посадочная страница сделана на конструкторе BotHelp

Если ваш лендинг сделан на конструкторе BotHelp, то кнопку перехода в телеграм канал нужно сделать самому на чистом HTML коде:

<!-- Start BotHelp custom button --> 
 <div class="btnWrapper" id="bothelp_button">
 <a href="https://t.me/ссылка_в_канал/номер_поста" target="_blank">
 <button class="toTg">
 Перейти в телеграм
 </button>
 </a>
 </div>

 <style>
 .btnWrapper a{
 text-decoration: none;
 padding-left: 30px;
 padding-right: 30px;
 display: block;
 margin-top: 16px
 }

 .toTg {
 display: block;
 box-sizing: border-box;
 width: 100%;
 padding: 16px 24px; /* Отступы */
 font-family: 'Nunito', sans-serif;
 background-color: #4faee6; /* Основной цвет фона */
 color: white; /* Цвет текста */
 border-radius: 4px; /* Скругленные углы */
 text-align: center; /* Центровка текста */
 font-size: 16px; /* Размер шрифта */
 font-weight: normal; /* Толщина шрифта */
 cursor: pointer; /* Курсор при наведении */
 border: none; /* Убираем границу */
 position: relative; /* Положение для блика */
 overflow: hidden; /* Скрываем выходящий блик */
 
 }

 .toTg::before {
 content: '';
 position: absolute;
 top: -30%;
 left: -30%;
 width: 50%;
 height: 50%;
 background: rgba(255, 255, 255, 0.5);
 transform: rotate(45deg);
 pointer-events: none;
 animation: shine 2s linear infinite; /* Цикличная анимация блика */
 }

 @keyframes shine {
 0% {
 left: -150%; /* Начинаем с левой стороны */
 }
 100% {
 left: 150%; /* Заканчиваем на правой стороне */
 }
 } 
 </style>
 
 <script>
 var fOnLoad = () => {
 let bhButton = document.querySelector(".wh-landing-button-telegram");
 bhButton.innerHTML = "";
 bhButton.appendChild(document.getElementById("bothelp_button"));
 };
 window.addEventListener("DOMContentLoaded", fOnLoad);
 </script>
 
 <!-- End BotHelp custom button -->Code language: HTML, XML (xml)

См. далее:
Передача стартов бота в Я.Директ
Передача стартов бота в Facebook/Insta
Передача стартов бота в VK Реклама