Как подключить BotHelp
BotHelp поддерживает ограниченную интеграцию с Откуда Подписки, доступен функционал:
- Передача активаций бота в рекламные системы Яндекс/ФБ/Гугл/ВК, оптимизация на старты бота
- Аналитическая отчетность по аудитории: источники трафика, полный список подписчиков, utm метки откуда пришли (только подписки)
- Аналитическая отчетность по подпискам: переходы в бота, конверсии в подписку
- Ежедневные отчеты бота
“подписки 24ч” - Досье подписчика
- Глубокие цели
Следуйте по шагам для настройки подключения:
1. Настройка передачи webhook для BotHelp
- Для интеграции необходимо получить API ключ. Как получить API ключ тут.
- В самом боте после Старт, создайте действие.
![](https://doc.tgtrack.ru/wp-content/uploads/2024/10/Действие-перед-стартом-3.jpg)
3. В действии выберите “Отправить данные подписчика через Webhook”
![](https://doc.tgtrack.ru/wp-content/uploads/2024/10/Действие-Отправить-вебхук-2.jpg)
![](https://doc.tgtrack.ru/wp-content/uploads/2024/10/Бот-хэлп.png)
Пример url, на который надо послать запрос: : https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/my_bothelp_was_started |
Просто выберите пункт о пересылке данных пользователя и отошлите его на наш url методом POST. Укажите ваш API ключ, который получили от Откуда Подписки бот на шаге 1.
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. Создайте действие в воронке с передачей данных
В нужном месте воронки добавьте шаг, который будет отправлять информацию о получении результата теста.
Выберите действие – Внешний запрос.
![](https://doc.tgtrack.ru/wp-content/uploads/2024/10/Действие-глубокая-цель.jpg)
2. Настройте внешний запрос
Для передачи данных по глубокой цели из вашего бота в рекламную систему после настройки интеграции, нужно сделать подключение к рекламной системе по инструкции. Ссылки на инструкции в конце этой страницы.
Укажите URL для отправки данных в сервис Откуда Подписки бот.
Пример URL, на который надо послать запрос, укажите ваш API ключ, полученный от Откуда Подписки:
![](https://doc.tgtrack.ru/wp-content/uploads/2024/10/Глубокая-цель-ТестГотов-1024x714.jpg)
В тело запроса добавьте следующий 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 Реклама