Чтобы подключить бота к сервису вам понадобится API токен вашего бота. После вам нужно настроить сервис, в котором у вас сделан бот. Поддерживаемые сервисы: BotHelp, SaleBot, Leadtex, CleverApp, BotMan, Боты на своем коде.
Подключение бота к сервису
1. Откройте главное меню @tgraphyx_bot через команду /start
2. В главном меню выберите 📂 Каналы, группы и боты
3. Выберите 🤖Подключить бота
4. Пришлите API токен вашего бота
API токен можно узнать в @Botfather. Он доступен владельцу бота.
5. Выберите в каком сервисе сделан ваш бот
Поддерживаемые сервисы ботов
В данный момент мы поддерживаем интеграцию с сервисами:
BotHelp
В сервисе BotHelp вам нужно сначала добавить поле sl, а после отправить его через WebHook в Телеграфикс.
Откройте настройки, выберите раздел Настраиваемые поля и нажмите кнопку Добавить новое поле.
Имя настраиваемого поля укажите sl. Тип поля выберите Текст.
В боте добавьте блок Действия. В нем добавьте действие Отправить данные подписчика через Webhook.
В поле WebHook укажите:
https://app.telegraphyx.ru/api/bot/start/bothelp
Установите блок сразу после Старт.
SaleBot
В сервисе SaleBot вам нужно добавить условие в стартовый блок и после отправить API-запрос.
Добавьте блок Состояние диалога после стартового.
В нем нажмите включите API-запрос. Укажите тип запроса GET.
URL запроса:
https://app.telegraphyx.ru/api/bot/start?start=#{tag}
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
LeadTex
В сервисе LeadTex вам нужно отправлять HTTP-запрос с параметром sl в Телеграфикс.
Для этого добавьте блок HTTP-запрос в сценарий.
В поле URL вставьте:
https://app.telegraphyx.ru/api/bot/start/leadtex?sl={{$sl}}
Поставьте блок HTTP-запрос сразу после блока Старт
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
CleverApp
В сервисе CleverApp вам нужно отправлять HTTP-запрос с параметром sl в Телеграфикс.
Для этого добавьте блок HTTP-запрос в сценарий.
В поле URL вставьте:
https://app.telegraphyx.ru/api/bot/start/cleverapp?sl={{$sl}}
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Botman
В сервисе BotMan вам нужно добавить условие в блок Начало и после отправить API-запрос.
Добавьте в блок Начало условие Ключевые слова. Выберите Сообщение содержит и добавьте sl-.
Добавьте блок Действия после стартового.
В нем выберите Внешний запрос. Укажите тип запроса GET.
URL запроса:
https://app.telegraphyx.ru/api/bot/start?start={{start_command}}
Интеграция настроена. Теперь все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
Боты на своем коде
Наш сервис добавляет параметр 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} вы добавляете параметр, который появился у каждого пользователя
После настройки проверьте отправку конверсий. Если все успешно, то все пользователи пришедшие с лендинга и стартовавшие бота будут переданы в Яндекс Метрику как успешное достижение цели.
