Чтобы подключить бота к сервису вам понадобится API токен вашего бота. После вам нужно настроить сервис, в котором у вас сделан бот. Поддерживаемые сервисы: BotHelp, SaleBot, Leadtex, CleverApp, BotMan, Боты на своем коде.
Сервис работает и с ботами MAX — порядок для них описан в разделе Боты MAX.
Подключение бота к сервису
1. Откройте главное меню @tgraphyx_bot через команду /start
2. В главном меню выберите 📂 Каналы, группы и боты
3. Выберите 🤖Подключить бота
4. Пришлите API токен вашего бота
API токен можно узнать в @Botfather. Он доступен владельцу бота.
5. Выберите в каком сервисе сделан ваш бот
Боты MAX
Сервис работает и с ботами MAX. Порядок тот же, но несколько шагов отличаются.
Токен бота MAX выдаётся владельцу в профиле организации: Чат-бот и мини-приложение → токен.
Подключение — в нашем боте MAX: в главном меню выберите 🤖 Мои боты, затем ➕ Подключить бота и пришлите токен.
Лендинг для бота MAX делает сам сервис. После подключения Яндекса нажмите 📄 Лендинг, укажите юридическое или физическое лицо, которое даёт рекламу, и его ИНН — сервис выдаст адрес вида https://max.tgryx.ru/адрес_вашего_бота. Код Метрики и трекер на этой странице уже стоят — вставлять ничего не нужно, ведите рекламу сразу на неё.
Адреса, на которые бот сообщает о запуске, для MAX другие — они указаны в разделе вашего сервиса ниже. Для ботов MAX используйте адреса с max.tgryx.ru — телеграмный адрес метку бота MAX не распознает.
Сервис BotMan для ботов MAX пока не поддерживается.
Проверка. Откройте свой лендинг, перейдите с него в бота и запустите его. Если всё настроено, в Метрике достигаются цели toBot (переход) и userBotStart (запуск). Переходы есть, а запусков нет — значит, бот не присылает метку: проверьте адрес и параметр. Лендинг открывает страницу «нет оплаты» — закончился тариф.
Поддерживаемые сервисы ботов
В данный момент мы поддерживаем интеграцию с сервисами:
BotHelp
В сервисе BotHelp вам нужно сначала добавить поле sl, а после отправить его через WebHook в Телеграфикс.
Откройте настройки, выберите раздел Настраиваемые поля и нажмите кнопку Добавить новое поле.
Имя настраиваемого поля укажите sl. Тип поля выберите Текст.
В боте добавьте блок Действия. В нем добавьте действие Отправить данные подписчика через Webhook.
В поле WebHook укажите:
https://app.telegraphyx.ru/api/bot/start/bothelp
Установите блок сразу после Старт.
Если у вас бот MAX, вебхук тот же, но адрес другой: https://max.tgryx.ru/api/max/bot/start/bothelp
SaleBot
В сервисе SaleBot вам нужно добавить условие в стартовый блок и после отправить API-запрос.
Добавьте блок Состояние диалога после стартового.
В нем нажмите включите API-запрос. Укажите тип запроса GET.
URL запроса:
https://app.telegraphyx.ru/api/bot/start?start=#{tag}
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Если у вас бот MAX, запрос тот же, но адрес другой: https://max.tgryx.ru/api/max/bot/start?start=#{tag}
LeadTex
В сервисе LeadTex вам нужно отправлять HTTP-запрос с параметром sl в Телеграфикс.
Для этого добавьте блок HTTP-запрос в сценарий.
В поле URL вставьте:
https://app.telegraphyx.ru/api/bot/start/leadtex?sl={{$sl}}
Поставьте блок HTTP-запрос сразу после блока Старт
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Если у вас бот MAX, адрес другой: https://max.tgryx.ru/api/max/bot/start/leadtex?sl={{$sl}}
CleverApp
В сервисе CleverApp вам нужно отправлять HTTP-запрос с параметром sl в Телеграфикс.
Для этого добавьте блок HTTP-запрос в сценарий.
В поле URL вставьте:
https://app.telegraphyx.ru/api/bot/start/cleverapp?sl={{$sl}}
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Если у вас бот MAX, адрес другой: https://max.tgryx.ru/api/max/bot/start/cleverapp?sl={{$sl}}
Botman
В сервисе BotMan вам нужно добавить условие в блок Начало и после отправить API-запрос.
Добавьте в блок Начало условие Ключевые слова. Выберите Сообщение содержит и добавьте sl-.
Добавьте блок Действия после стартового.
В нем выберите Внешний запрос. Укажите тип запроса GET.
URL запроса:
https://app.telegraphyx.ru/api/bot/start?start={{start_command}}
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Для ботов MAX сервис BotMan пока не поддерживается.
Боты на своем коде
Наш сервис добавляет параметр start в ссылку бота для каждого посетителя лендинга. Ссылка будет вида t.me/name_bot?start=sl-7b33…33317d, где sl-7b33…33317dс будет уникальным.
Вам нужно отправить Webhook в Телеграфикс с типом GET, передав нам данные из параметра start.
URL для Webhook:
https://app.telegraphyx.ru/api/bot/start?start={start}
в {start} вы добавляете параметр, который появился у каждого пользователя
После настройки проверьте отправку конверсий. Если все успешно, то все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Если у вас бот MAX, ссылка будет вида max.ru/name_bot?start=sl-7b33…33317d, а Webhook нужно отправлять на https://max.tgryx.ru/api/max/bot/start?start={start}
