Для создания Telegram бот переходим в раздел «Споты»

Нажимаем "Добавить спот" и выбираем “Telegram бот”

Добавление Telegram App шаги:

Шаг 1. Заполните вкладку “Общие”

Название - название бота у нас в системе для вашего удобства

Права на редактирование - выдайте права пользователям, которые имеют право редактировать данный Telegram App, а так же получать ссылку на запуск трафика на Telegram App и просматривать исходящие постбеки.

Права на удаление - выдайте права пользователям, которые имеют право удалять данный Telegram App

Шаг 2. Заполните вкладку “Бот”

Короткое имя 

Юзернейм вашего телеграм бота без символа @ (например myname_bot).

Ссылка для Webhook (рекомендуется)

Данный тип вебхука предназначен для надёжной и точной передачи идентификаторов пользователей с целью последующего отслеживания их действий в системе MVP Project. Он поддерживается большинством популярных платформ для создания Telegram-ботов, включая как конструкторы, так и самописные решения.

Формат URL:

https://thedinator.com/tracker/bot/webhook/QFCkQw83/?user_id={user_id}&subscriber_id={sub_id}

Пояснение параметров:

• user_id — Telegram ID пользователя. Получается на первом слое вашего бота.
• subscriber_id — внутренний идентификатор пользователя на платформе MVPProject. Передаётся в команду /start и приходит в формате /start xxx-xxx-xxx.

Пример запроса:

https://thedinator.com/tracker/bot/webhook/QFCkQw83/?user_id=123456789&subscriber_id=abc-123-xyz

Рекомендуется использовать именно этот способ, так как он прост в реализации и не требует дополнительных операций.

Ссылка для Telegram webhook

Этот вариант используется в случаях, когда платформа не позволяет конфигурировать параметры запроса. Подразумевается, что вы дублируете содержимое стандартного Telegram webhook-запроса (например, update-объект) напрямую, без модификаций. Подходит для продвинутых кастомных решений и редких платформ с прямым доступом к исходящим данным.

Ссылка для отправки:

https://thedinator.com/tracker/bot/telegram/webhook/QFCkQw83/

В теле запроса рекомендуется передавать всю структуру update, полученную от Telegram API.

Если вы используете платформу-конструктор и не уверены, поддерживает ли она передачу параметров в URL, обратитесь к технической поддержке платформы или выберите способ с простым webhook.

Шаг 3. Заполните вкладку “Сделки”

• Укажите, подключена ли CRM к этому каналу (Да/Нет)
• Выберите канал связи, через который будет идти трекинг (предварительно добавьте его здесь)

Шаг 4. Заполните вкладку “Постбэки”

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

Тип постбэка - выберите, куда вы хотите отправлять постбэки. Подробнее о настройке каждого типа постбэка вы можете найти в разделе “Настройка аналитики и трекинга”.

Нажмите «Сохранить»

Ваш Telegram бот, готов к работе! 🥳

📢 Инструкция по редактированию спота Telegram бот

1. Вкладка «Сделки»

• Добавьте постбек-ссылку с параметрами (например: https://google.com?clickid={clickid}&luboe_nazvanie_parametra={tg_id}. Параметр tg_id позволяет передавать Telegram ID пользователя вместе с clickid. Передача tg_id является опциональной и настраивается по желанию.
• New! Добавили возможность передавать UUID спота в сделках, используя макрос spot={spot}, настраивается по желанию. 
• Задайте якорь ссылки и ссылка, отправленная менеджером клиенту будет обернута в этот Якорь. Например менеджер отправляет ссылку клиенту https://thedinator.com/lr/5QM4?otv=1, а клиенту она придет как Platform.
• Задайте макрос, который будет использоваться для быстрой вставки ссылки в сообщениях, а также рассылках/приветственном сообщении/командах, например {link1}.

2. Добавление кастомных макросов

1. Перейдите во вкладку «Переменные»
2. Нажмите кнопку «Добавить переменную»
3. В поле «Переменная» выберите название нужного макроса из выпадающего списка
4. В поле «Значение» укажите текст, который должен подставляться вместо макроса
5. Нажмите кнопку «Внести изменения».

Подробнее о настройке переменных читайте ➡️ здесь 

Давайте разберем основные функции карточки спота Telegram бот.

Карточка Telegram бот

Кнопка 1. Редактировать

Позволяет вам редактировать созданный спот.

Кнопка 2. Подписчики

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

Кнопка 3. Постбэки

Показывает все исходящие (в Facebook, Google, Tiktok) и входящие постбэки связанные с данным спотом.

Кнопка 4. Конверсии

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

Кнопка 5. Сгенерировать ссылки для лендинга

Кнопка получения трекинговой ссылки для данного спота. 

Кнопка 6. Ссылки для постбэков

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

Кнопка 7. Удалить

Кнопка для удаления Telegram бот.