Создаём телеграм-бота для получения статистики по лидам из Кейтаро

Если вы хоть раз настраивали интеграцию трекера и ПП, то вы в курсе, что у трекера есть такая штука как постбэк: когда в ПП падает лид (либо когда у лида меняется статус), движок ПП (Cake,Affise,HasOffers и т.п.) шлёт трекеру запрос, в котором указаны все данные по произошедшим изменениям. Трекер этот запрос обрабатывает, обновляет данные и рисует вам красивую (или не очень) статку.

Трекер в данном случае — принимающая запрос сторона. Но (сурпрайз, мазефака!), если приглядеться к настройкам любой кампании Кейтаро или к настройкам источников трафика там же, то мы увидим там такую штуку как S2S-postback. S2S, есличё, расшифровывается как «server to server».

Что же это за зверь? Оказывается, трекер после приёма постбэка от ПП может сам отправить (грубо говорят продублировать) постбэк по указанному в поле выше адресу! «И нахрен мне это нужно?» ,-спросите вы.

Вообще, обычно эта херня нужна для отправки данных В ИСТОЧНИК трафика. Да-да, некоторые источники трафа умеют оптимизировать кампании на основе полученных от вашего трекера данных, навроде того, как фб оптимизирует траф на основе данных, полученных от пикселя.

Но мы будем использовать эту фичу не совсем по назначению: создадим бота в телеге, который будет нам писать каждый раз, когда что-то будет происходить с нашими лидами.

Дальше идёт практически копипейст мануала Кейтаро, но кто читает мануалы?? Поехали!

1. Идём в телегу, ищем там бота @BotFather и создаём нового бота, используя команду /newbot
2. Задаем имена и сохраняем полученный токен
3. Открываем диалог со своим ботом, пишем ему любое сообщение.
4. Если вы в РФ, то запускаем Tor Browser. Если нет, то пойдёт любой другой.
5. Нам надо получить id чата с нашим ботом. Для этого делаем запрос на бота, написав в адресной строке браузера следующее:
   api.telegram.org/botREPLACE/getUpdates
   где, вместо REPLACE нужно вставить API token бота в формате 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
6. Ищем в полученной строке идентификатор чата message«:{«message_id»:X,»from«:{«id»:ID где, вместо ID будет ваш реальный id
7. Отправляем боту сообщение через API , введя в адресной строке браузера команду api.telegram.org/botREPLACE/sendMessage?chat_id=ID&text=text
   где, вместо REPLACE нужно вставить API token бота, а вместо ID – полученный id чата
8. Если все ок и сообщение пришло, то можно использовать полученный адрес в качестве S2S postback в настройках кампании трекера или, если хотите сделать постбэк для всех кампаний, то в Источнике трафика. Примерный шаблон S2S postback может выглядеть следующим образом:
   https://api.telegram.org/botREPLACE/sendMessage?chat_id=ID&text={campaign_name}:{status}:{conversion_revenue}
   где
   {campaign_name} — имя кампании в трекере,
   {status} — статус конверсии,
   {conversion_revenue} — выплата по конверсии.

Полный набор макросов, которые можно передавать в таком постбэке можно посмотреть вот тут.

Ну вот и всё! Теперь можно меньше переживать за стату и больше времени уделять подходам и воронке.

А с вами был Жёлтый веб, лейте в плюс и шлите донатики! Всех обнял.

P.S. Кстати, недавно сделал такого же бота для трекера Binom, чекайте вот тут.