Инструкция

1.1Что умеет «Точка входа»

1.2Быстрый старт

1. Добавьте бота администратором в свой канал. Как это сделать
2. Размещаете рекламу в каналах и пабликах? Отправьте боту /link, выберите канал и создайте отдельную ссылку на каждое размещение. Подробнее
3. Запускаете Яндекс Директ? Отправьте /add_integration, войдите через Яндекс ID и выберите счётчик Метрики. Если счётчика нет, создайте его в том же окне, указав адрес сайта. Бот создаст цель подписки и пришлёт скрипт.
4. Вставьте скрипт на свою страницу. Своего сайта нет? Соберите прелендинг в кабинете, скрипт на нём встанет сам.
5. Пришлите боту адрес страницы и нажмите «Проверить лендинг». Потом добавьте цель подписки в настройки кампании в Директе.

Учёт начинается после подключения бота. Источники старых подписок задним числом не появятся.

2.1Подключение канала

Канал в Max

1. Запустите бота «ТочкаВхода» в Max.
2. Откройте канал → «Подписчики» → «Добавить подписчика». Начните вводить название бота и добавьте его в подписчики.
3. Вернитесь в настройки канала: «Администраторы» → «Добавить администратора». Назначьте бота администратором, из прав нужно только «добавлять подписчиков».
4. Вернитесь в бота и нажмите «Канал добавлен». Без этого канал может появиться в боте не сразу.

Канал в Telegram

1. Откройте бота @jointrack_bot и запустите его.
2. В своём канале откройте «Управление каналом» → «Администраторы».
3. Добавьте администратором @jointrack_bot. Из прав достаточно «добавлять подписчиков».
4. Канал появится в боте сам. Если бот промолчал, нажмите «Канал добавлен»: он проверит, что видит канал и что вы в нём администратор.

Подписки учитываются с момента подключения. Если человек подписался раньше, а отписался уже при боте, в отписках у него будет источник «начальная аудитория».

2.2Подключение бота

Если реклама ведёт не в канал, а в вашего бота в Telegram или Max, его можно подключить так же, как канал.

1. Отправьте нашему боту команду /add_bot.
2. Следующим сообщением пришлите токен вашего бота: в Telegram его выдаёт @BotFather, в Max @MasterBot. Сообщение с токеном бот сразу удаляет.
3. Дальше как с каналом: /add_integration и скрипт на лендинг. Кнопка на лендинге должна вести на вашего бота.

• Ваш бот работает как раньше. Переписку мы не читаем, видим только запуски и блокировки.
• Бот в Telegram с вебхуком подключается сразу. Если вебхука нет (бот сам забирает сообщения у Telegram), наш бот выдаст адрес, на который запуски присылает сам ваш бот: как это настроить.
• В Метрику уходит цель «Join TG — запуск бота», её и добавляйте в стратегию кампании.
• В списках бот отмечен «| Бот». Оплата за бота отдельная, как за канал.
• Отчёты получает тот, кто подключил бота. Чтобы дать доступ ещё одному человеку, отправьте боту /add_admin и перешлите ему ссылку: она работает сутки. То же есть в кабинете: «Настройки» → «Кто получает отчёты по боту», там же кнопка «Убрать».

Бот без вебхука: запуски присылает сам бот

Так подключается бот на своём коде, который сам забирает сообщения у Telegram (getUpdates, polling). Telegram отдаёт каждое сообщение только одному получателю, поэтому со стороны запуски не видны: их должен передавать нам сам бот. Это делает тот, кто писал бота. Если бот писала нейросеть, скопируйте ей этот раздел целиком, этого достаточно.

Что нужно сделать

1. Получите адрес: отправьте нашему боту /add_bot и токен вашего бота. В ответ придёт адрес вида https://jointrack.ru/bot/push/ключ. Ключ секретный, передайте его только разработчику.
2. В коде бота, там, где он получает обновления от Telegram, добавьте отправку каждого обновления на этот адрес: HTTP POST, в теле тот же JSON, что пришёл от Telegram, без изменений, заголовок Content-Type: application/json.
3. Чтобы мы видели и блокировки, бот должен получать от Telegram обновления my_chat_member: в запросе getUpdates передайте allowed_updates: ["message", "my_chat_member"]. Если список уже есть, допишите в него.
4. Проверьте: запустите бота по ссылке с лендинга или из /link. Через минуту человек появится в кабинете и в /user_info.

Пример на Python, то же самое на любом языке:

import requests

PUSH_URL = "https://jointrack.ru/bot/push/ключ"   # адрес из /add_bot

def send_to_jointrack(update):          # update: один элемент из ответа getUpdates
    try:
        requests.post(PUSH_URL, json=update, timeout=5)
    except Exception:
        pass                             # ошибка отправки не должна останавливать бота

# в цикле обработки обновлений, перед своей логикой:
for update in updates:
    send_to_jointrack(update)
    ...

Сервер отвечает {"ok": true}. Если ответ 404, ключ в адресе не тот: получите адрес снова через /add_bot. Из обновлений мы берём только /start в личке и блокировку бота, остальное не читаем и не храним. Повторный запуск того же человека дубль не создаёт.

Глубокие цели. Заявка, оплата, пройденный тест: в этот момент бот шлёт на тот же адрес ещё одну строку, где target это имя цели латиницей:

requests.post(PUSH_URL, json={"event": "goal", "user_id": user_id, "target": "order"}, timeout=5)

Цель «Бот: order» появится в счётчике Метрики сама при первом событии, добавьте её в стратегию кампании. Цель уходит по тому переходу с рекламы, с которого человек запустил бота, поэтому принимается 21 день после запуска и только для тех, кто пришёл с рекламы: если источника нет, в ответе будет "sent": false. Повтор той же цели для того же человека не дублируется. Имён целей может быть сколько угодно: lead, pay, quiz.

2.3Интеграция с Яндекс.Директом

1. Отправьте боту /add_integration. Если каналов несколько, бот спросит, какой подключаем.
2. Нажмите «Войти через Яндекс ID». Сервис получает доступ к счётчикам Метрики, пароль он не видит.
3. Выберите счётчик лендинга или «Создать новый счётчик», тогда укажите домен лендинга, например example.ru.
4. Для канала Max по желанию отметьте «Кнопка через мини-апп». Что это даёт
5. Бот создаст в счётчике цель «Join Max · подписка в Max» или «Join TG · подписка в ТГ» и пришлёт по шагам: скрипт для лендинга, ссылку, на которую должна вести кнопка, и что проверить. Всё это потом есть и в личном кабинете во вкладке «Настройки».
6. Добавьте эту цель в стратегию кампании, чтобы Директ оптимизировался на подписки.

Цель «Остался в канале»

Засчитывается, если человек подписался с лендинга и не отписался за выбранный срок. Её можно поставить в стратегию Директа: он будет учиться на тех, кто остался в канале.

Особенно пригодится для закрытых каналов Max. Там подпиской считается уже открытие канала, и кто-то заглядывает из любопытства и сразу выходит. В эту цель такие люди не попадают.

1. Откройте личный кабинет, вкладку «Настройки». Блок этой цели стоит сразу под целями, которые передаёт сервис.
2. Укажите срок от 1 до 21 дня (по умолчанию 1 день) и нажмите «Включить цель».
3. В счётчике появится цель «Stay TG · остался в канале» или «Stay Max · остался в канале». Добавьте её в стратегию кампании.

2.4Скрипт на лендинге

Скрипт выглядит так, у каждого канала свой номер. Бот присылает его при подключении интеграции, он же есть в личном кабинете во вкладке «Настройки»:

<script src="https://jointrack.ru/s/xxxxxxxxxxxx.js" defer></script>

Как поставить

1. Вставьте скрипт в <head> на каждой странице, где есть кнопка канала. Если у проекта канал и в Telegram, и в Max, скриптов два, вставьте оба.
2. Кнопка должна быть ссылкой на ваш канал:
   Telegram: https://t.me/ваш_канал
   Max, открытый канал: https://max.ru/имя_канала
   Max, закрытый канал: ссылка-приглашение https://max.ru/join/... ровно такая, как в Max.
3. Кнопка может вести и на конкретный пост:
   Telegram: https://t.me/ваш_канал/123
   Max, открытый канал: ссылка на пост из «Копировать ссылку», вида https://max.ru/имя_канала/AaCmOgnmLIw.
   У закрытого канала Max ссылок на посты нет, только ссылка на канал.
4. Пришлите боту адрес страницы и нажмите «Проверить лендинг»: бот покажет, видит ли он скрипт, кнопку и счётчик.

Скрипт не мешает сайту: страница открывается так же быстро, а человек по кнопке сразу попадает в канал или на пост. Работает с Тильдой и другими конструкторами.

Несколько лендингов на один канал

Лендингов может быть сколько угодно: основной, копии под разные кампании, тесты. Отдельная интеграция для этого не нужна, и заводить её не надо: поставьте на новую страницу тот же самый скрипт. Страница появится в отчётах сама после первых переходов, отдельно от других, в разделе «Лендинги».

• Кнопка через мини-апп включается у каждой страницы отдельно, в кабинете, во вкладке «Настройки». Можно включить на одном лендинге и сравнить с обычной кнопкой на другом.
• Настройка у адреса раздела, например сайт.ру/catalog, действует на весь раздел.
• Новая интеграция нужна только тогда, когда у лендинга свой счётчик Метрики. Тогда в кабинете будет несколько скриптов, каждый для своего сайта, а статистика по каналу останется общей.

2.5Проверка лендинга

Пришлите боту адрес страницы, например example.ru, и нажмите «Проверить лендинг». В Telegram можно сразу командой: /check example.ru. Бот покажет:

• стоит ли скрипт и к какому каналу он относится;
• есть ли на странице кнопка канала и сколько таких кнопок; если кнопки нет, бот напишет, на какую ссылку она должна вести;
• видно ли счётчик Метрики;
• переходы, подписки и переданные в Метрику цели за последние три дня.

Кнопка «🔄 Обновить» проверяет страницу заново и обновляет то же сообщение.

2.6Метки в объявлениях

Чтобы в кабинете были кампании, объявления, регионы и площадки, добавьте в Директе в параметры URL кампании такой шаблон:

utm_source=yandex&utm_medium={source_type}&utm_campaign={campaign_id}_{campaign_name}&utm_content={ad_id}_{gbid}_{device_type}_{region_name}&utm_term={keyword}&place={source}

Другие метки вида utm_... тоже появятся в кабинете под своим именем.

2.7Telegram и Max одного проекта

Если у проекта есть канал и в Telegram, и в Max, подключите оба. После интеграции бот предложит объединить их в одну кнопку статистики, и в /stats они будут рядом.

Каналы в Telegram и Max, подключённые к одному счётчику Метрики, считаются одним проектом: оплата одна на оба. Ничего связывать не нужно, достаточно выбрать тот же счётчик при интеграции второго канала.

2.8Прелендинги

Прелендинг это короткая страница перед каналом: реклама ведёт на неё, а оттуда человек переходит в канал по кнопке. Свой сайт не нужен: страница собирается в кабинете, скрипт и политика на ней ставятся сами.

1. Отправьте боту /lk, откройте вкладку «Прелендинги», нажмите «Создать страницу» и выберите шаблон.
2. Напишите заголовок и текст. Аватар канала и кнопки со ссылками на каналы подтянутся сами, если каналы уже добавлены в бота. Заголовок можно разделить знаком «|» на две строки, вторая будет курсивом.
3. Добавьте фото, до 8 штук, настройте порядок кнопок, шрифты и цвета. Кнопка может вести на конкретный пост: укажите ссылку на него.
4. Если вы ИП или компания, заполните свои данные: они встанут в подвал страницы и в политику конфиденциальности. Можно указать ссылку на политику со своего сайта.
5. Придумайте адрес латиницей и опубликуйте: страница откроется по адресу max-canal.ru/имя, его и ставьте в объявление. Откройте страницу на телефоне и проверьте текст, фото и кнопку.

На странице достаточно одного действия: перейти в канал. Не перегружайте её текстом и не добавляйте лишних ссылок.

Для «Ленты фото» и «Сетки 3×2» нужно минимум 4 фото.

Сплит-тест: отметьте галочками страницы и нажмите «Сплит-тест». Посетители делятся между ними поровну, а в разделе «Лендинги» у каждой страницы видно переходы, подписки и процент подписки. Так понятно, какая работает лучше.

Свой домен (PRO+)

1. В кабинете во вкладке «Прелендинги» найдите блок «Свой домен», введите домен, например lend.ru, и нажмите «Подключить и проверить».
2. У регистратора домена создайте запись A со значением 147.45.251.52. Для поддомена, например promo.lend.ru, вместо неё можно сделать CNAME на leadfrom.ru.
3. Когда DNS обновится (от 5 минут до нескольких часов), нажмите «Проверить» ещё раз. Сертификат выпустится сам.

На вашем домене откроется первая опубликованная страница, остальные по адресу ваш-домен/имя. Адреса на leadfrom.ru продолжают работать. Один домен на канал. Если PRO+ закончится, страницы останутся на leadfrom.ru, а домен снова заработает после продления.

PRO+ оплачивается в боте: /pro → выберите канал → на странице оплаты «PRO+, 1 месяц». При оплате PRO на 3 или 6 месяцев PRO+ будет в подарок на этот срок.

2.9Кросспостинг в Max и VK

Публикуете пост в Telegram, а бот сам переносит его в ваш канал Max и сообщество VK. Работает и в обратную сторону, из Max в Telegram и VK. Переносятся форматирование и правки поста. Кросспостер входит в PRO без доплаты.

1. Запустите бота кросспостинга в Telegram или в Max и добавьте его администратором в свой канал с правом публиковать и редактировать посты.
2. Отправьте /channels и выберите канал, из которого берём посты.
3. Для Max нажмите «Подключить Max»: бот выдаст код и подскажет, как добавить Max-бота администратором и подтвердить канал.
4. Для VK нажмите «Подключить VK» и войдите через VK ID. Бот только публикует посты в сообществе.
5. Проверьте, какие направления включены, и сделайте тестовый пост.

Автозамена ссылок

Можно задать правила: например, чтобы кнопка «Написать» в Telegram вела в вашу личку в Telegram, а в Max в личку в Max. Правил может быть несколько: личка, каталог, бот для расчёта стоимости. Ссылки на ваши каналы и на ваши прошлые посты, опубликованные через бота, заменяются сами.

Что не переносится

• Видео в VK. В настройках можно публиковать такие посты без видео или пропускать их.
• Опросы, стикеры и кнопки.
• Файлы больше 20 МБ.
• Удаление: если удалить пост в Telegram, копии останутся.

2.10Группы и личка

Кроме каналов можно подключить группу, а в Telegram ещё и личку. Команда в боте: /add_chat.

Группа (Telegram и Max)

1. Добавьте бота администратором в группу с правом приглашать участников, так же как в канал.
2. Группа появится в списке в боте сама.

Вступления в группу и выходы из неё считаются как подписки и отписки: видно, откуда пришли участники.

Личка (только Telegram)

Можно подключить и личку: будет видно, сколько вам написали и откуда пришли обращения. Нужен Telegram Premium.

1. В Telegram откройте «Настройки» → «Telegram для бизнеса» → «Чат-боты» и добавьте @jointrack_bot.
2. В правах оставьте только чтение, галочка «Отвечать на сообщения» не нужна.
3. В выборе чатов отметьте «Новые чаты».
4. На лендинге оставьте тот же скрипт, а кнопку «Написать» сделайте ссылкой на вашу личку: https://t.me/ваш_ник.

Первое сообщение от нового человека считается обращением: видно, откуда он пришёл, а в Метрику уходит цель «Join TG — обращение в личку». Её можно добавить в стратегию Директа.

2.11Пиксель VK Рекламы

Подписки можно передавать в VK Рекламу, чтобы её кампании учились на подписках. Метрика для этого не нужна.

1. Отправьте боту /add_integration_vk и выберите канал.
2. Пришлите номер пикселя. Он есть в кабинете VK Рекламы: «Сайты» → «Пиксели», число вида 3523812.
3. В VK Рекламе в разделе пикселя «События» создайте два события с условием «Произошло JS-событие»: userDidClick (переход в канал с лендинга) и userDidSubscribe (подписка). Для подключённого бота вместо подписки userDidStartBot.
4. Поставьте на лендинг код пикселя VK рядом с нашим скриптом.
5. В кампаниях VK Рекламы выберите оптимизацию на событие подписки.

В кабинете во вкладке «Настройки» можно выбрать одно событие для Telegram и Max или отдельные. Чтобы отключить пиксель, отправьте /add_integration_vk и пришлите слово «выключить».

3.1Личный кабинет

Отправьте боту /lk в Telegram или в Max, и придёт ссылка на кабинет. В Telegram она есть и в утреннем отчёте.

Если каналов несколько, они переключаются списком сверху. Рядом всегда видно, сколько сейчас подписчиков в канале. Разделы:

Статистика по списку

Во вкладке «Поиск по id» вставьте id своих клиентов или лидов и нажмите «Показать статистику только по ним». Все разделы пересчитаются только по этим людям: из каких кампаний, объявлений и регионов они пришли, на каких лендингах были. Список нигде не сохраняется, он есть только в открытой вкладке браузера.

Ссылки для посевов в кабинете

У каждой ссылки есть «изменить»: там можно поменять название или удалить ссылку. После переименования статистика по ссылке сохраняется под новым названием. Удалённая ссылка перестаёт открывать канал, а те, кто уже пришёл по ней, остаются в статистике.

Сортировка и Excel

Любую таблицу можно отсортировать по любому столбцу: нажмите на заголовок, повторное нажатие меняет направление. Кнопка «Скачать в Excel» выгружает таблицы раздела файлом.

Часовой пояс

Время в кабинете московское, как в Метрике и Директе. Если вы в другом поясе, нажмите на него справа в строке с периодами, например «Ваш (UTC+10)»: время и границы «Сегодня» и «Вчера» пересчитаются под вас. Браузер запомнит выбор, вернуться можно по ссылке «МСК».

3.2Статистика в боте

Отправьте /stats и выберите канал или «Все каналы». Бот пришлёт сводку за последние 24 часа: сколько подписались и отписались, по каким источникам, какая конверсия из перехода в подписку и сколько целей передано в Метрику.

За другие периоды и с подробными разрезами статистика есть в личном кабинете.

3.3Утренний отчёт

Каждый день в 09:05 по Москве бот присылает администраторам канала отчёт за вчера. Отчёт получают те администраторы, которые запускали бота.

Если подписок за день не было, отчёт всё равно придёт с кнопкой «Больше не присылать пустых отчётов». Кнопка отключает пустые отчёты только для того, кто её нажал.

3.4История подписчика

Отправьте /user_info, затем id человека, его ник или перешлите боту любое его сообщение. Бот покажет:

• в какие ваши каналы и когда человек подписывался, когда отписался;
• откуда пришёл и с какими метками;
• по кнопке «Подробнее»: город, источник по данным Метрики, сколько страниц посмотрел и сколько времени провёл на сайте, устройство.

Если человек не подписался, но переходил через мини-приложение, бот покажет и этот переход.

3.5Имена подписчиков

Всё, что бот отправляет через Telegram (отчёты, статистика, история подписчика), приходит без имён и ников подписчиков. Имена видны в личном кабинете на jointrack.ru и в боте в Max. Так устроено по политике конфиденциальности сервиса.

Политика конфиденциальности · Согласие на обработку данных · Оферта

4.1Кнопка через мини-апп

В открытом канале Max человек может читать посты, выбрать товар и написать вам, не подписываясь. В обычной статистике его не видно. Кнопка через мини-апп на секунду открывает мини-приложение сервиса, а потом канал: так сервис узнаёт, кто именно нажал. Работает для каналов Max.

Как включить

• при подключении интеграции канала Max: галочка «Кнопка через мини-апп» на странице выбора счётчика;
• для уже подключённого канала: личный кабинет, вкладка «Настройки», у нужной страницы кнопка «Включить мини-апп».

Кнопка у страницы меняет только эту страницу. Под таблицей есть общая настройка для всех остальных страниц с этим скриптом, в том числе новых. Перед её включением кабинет спросит подтверждение.

Цель в счётчике создаётся сама при первом включении. Скрипт на лендинге менять не нужно. Если кнопка вела на конкретный пост, после мини-приложения откроется этот пост.

4.2Ссылки для посевов

1. Отправьте боту /link и выберите канал. Для канала в Telegram нажмите «Посевы и сайты».
2. Напишите название ссылки до 25 символов, например «Канал Новости 26.09» или «паблик Вечерний Город». Оно будет видно в отчётах.
3. Если канал открытый, бот спросит, куда вести ссылку: нажмите «В канал» или пришлите ссылку на нужный пост. У закрытого канала ссылка всегда ведёт в канал.
4. Бот пришлёт две ссылки. Если вы прислали ссылку на пост, обе ведут на него.

Ссылки для Telegram Ads

Только для каналов в Telegram. Отправьте боту /link, выберите канал и нажмите «Telegram Ads». Напишите названия объявлений или креативов, каждое с новой строки, и бот пришлёт по ссылке на каждое. Поставьте ссылку в объявление.

Подписки появятся в /stats и в кабинете: источник «Telegram Ads», внутри по названиям, с отписками.

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

4.3Что значат источники

Подписи одинаковые в кабинете, в /stats и в утреннем отчёте.

У подключённых ботов рядом с источником бывает пометка «через канал»: человек раньше пришёл с рекламы в ваш канал, а потом запустил бота.

В Метрику и Директ уходят только подписки после перехода с рекламы.

5.1Все команды бота

В Max те же действия вынесены кнопками под сообщением бота.

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

5.3Партнёрская программа

Приводите клиентов по своей ссылке и получайте процент с каждой их оплаты. Ссылки доступны на любом тарифе. Партнёрская скидка на свою оплату действует, пока хотя бы один приглашённый на платном тарифе.

Где взять ссылку

Команда /ref в боте или раздел «Реферальная программа» в кабинете (/lk). Там три ссылки: на сайт, на Telegram и на MAX, каждая копируется нажатием. Можно создать до 20 ссылок, например под разные площадки. У каждой своя статистика: сколько пришло, сколько подключили канал, сколько на платном тарифе и сколько начислено.

Сколько начисляется

Начисление идёт с каждой оплаты, пока клиент на платном тарифе. Бот пишет о каждом начислении.

Как использовать бонусы

Партнёрским балансом можно оплатить свой тариф со скидкой 25% в /pro. Вывести деньгами могут самозанятые и ИП, от 3 000 ₽, заявкой в кабинете.

5.4Поддержка

Что-то не работает или есть вопрос: команда /support в боте или напишите в службу заботы «Точки входа» в Telegram или Max.