Документация / Интеграция с Telegram / Уведомления в Telegram из других сервисов

Уведомления в Telegram из других сервисов

telegram

Интеграция с Telegram позволяет автоматически отправлять уведомления в Telegram — например менеджерам или техспецам в личку или в группу. Работает в трёх сценариях: при регистрации, после вебинара и при заказе/оплате.

Подключение

  1. В Vakas-tools перейдите в Сервисы и доступы → Добавить сервис → Telegram уведомления.
  2. Укажите название подключения (произвольное, для вашего удобства).
  3. Введите токен бота от @BotFather.
  4. Нажмите «Добавить сервис».
  5. Система проверит токен и, если бот найден, покажет сообщение «Бот успешно подключен: @имя_бота».

Как получить токен бота

  1. Напишите боту @BotFather в Telegram.
  2. Отправьте команду /newbot (для создания нового бота) или /mybots (для существующего).
  3. Скопируйте токен вида: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11.

Токен не истекает, пока вы не отзовёте его через @BotFather. Если вы уже подключили этот бот в разделе Telegram Bot (для чат-бота), тот же токен можно использовать здесь — бот один, сервисы разные.

Важно! пользователь должен нажать /start Telegram запрещает ботам писать первыми. Прежде чем бот сможет отправить сообщение, получатель должен открыть бота и нажать /start. Без этого сообщение не дойдёт.

Правила, Условия, Действия

Интеграция работает через связку Правило → Условие → Действие.

1 Создайте Правило

Нажмите ➕ Добавить правило. Это «папка» для ваших настроек.

  • Хотите уведомлять обо всех событиях? → Оставьте правило без условий.
  • Нужны только определённые? → Добавьте условие внутри.

2 Настройте Условия (по желанию)

Условие — это проверка: «О каких событиях мы уведомляем?».

Например, вы хотите получать уведомление только когда купили VIP-тариф:

  • Условие: Название тарифасодержитVIP
  • Теперь уведомление придёт только при оплате тарифа со словом «VIP» в названии. Остальные оплаты бот пропустит.

Ещё примеры:

  • Статус платежаравноОплачено → уведомлять только об успешных оплатах
  • Был на вебинареравноНет → уведомлять о тех, кто не пришёл

3 Назначьте Действия

Нажмите Действия. Пока вы не добавите конкретное действие, система просто пропустит событие и ничего не произойдёт.

Частая ошибка: если вы выбрали «содержит», но оставили поле значения пустым — правило не выполнится. Пустое поле значения = ошибка передачи.

Настройка сообщений через Telegram уведомления

Отправить сообщение

Отправляет текстовое сообщение в один или несколько чатов Telegram.

Поле Обязательное Описание
Chat ID получателей (кому будут отправляться сообщения) Да Числовой ID чата или несколько через запятую. Поддерживает шорткоды.
Текст сообщения Да Текст уведомления. Поддерживает шорткоды и форматирование.

Свой Chat ID можно узнать через ботов @getmyidx_bot или @myidbot.

Можно добавить несколько действий «Отправить сообщение» — каждое отправится отдельно (разным получателям, с разным текстом).

Виды Chat ID

Тип получателя Формат Chat ID Пример
Личное сообщение Положительное число 123456789
Группа Отрицательное число (начинается с -100) -1001234567890
Канал @username или отрицательное число @mychannel
Несколько получателей Через запятую 123456789,987654321

В Vakas-tools вы настраиваете Telegram уведомления в одном из трёх разделов (Вкладки Регистрации/Отчеты/Оплаты) — в зависимости от того, откуда приходят данные. От этого зависит, какие шорткоды можно использовать в полях.

Раздел «Регистрации»

Сюда попадают данные, когда человек зарегистрировался — на вебинар, курс, через форму на сайте.

Что можно подставить в поля:

Шорткод Что подставится
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#vebinar_time#} Дата и время вебинара
{#vebinar_time_hi#} Время вебинара (чч:мм)
{#vebinar_time_date#} Дата вебинара
{#bizon_url#} Индивидуальная ссылка Bizon365
{#utm_source#}, {#utm_medium#}, {#utm_campaign#} UTM-метки
{#reg_field_ИМЯ_ПОЛЯ#} Любое поле из формы регистрации

Пример — уведомить менеджера о новой регистрации:

  • Отправить сообщение
    • Chat ID: 123456789 (Chat ID менеджера)
    • Текст: Новая регистрация!\nИмя: {#name#}\nEmail: {#email#}\nТелефон: {#phone#}\nUTM: {#utm_source#}
    • Формат: HTML

Раздел «Отчёты»

Сюда попадают данные после вебинара — кто был, сколько смотрел, кликал ли по кнопке.

Что можно подставить в поля:

Шорткод Что подставится
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#city#} Город
{#vizit_vebinar#} Был на вебинаре (да/нет)
{#bil_minut#} Сколько минут был на вебинаре
{#finished#} Досмотрел до конца
{#clickFile#} Кликал по кнопке
{#clickBanner#} Кликал по баннеру
{#but_text#} Текст на кнопке
{#comments#} Комментарии на вебинаре
{#webinarId#} ID вебинарной комнаты
{#view_date_data#} Дата вебинара
{#view_date_data_hi#} Время вебинара
{#view#} / {#viewTill#} Смотрел с / досмотрел до (Unix)
{#view_date#} / {#viewTill_date#} Смотрел с / досмотрел до (текст)
{#web_p1#}, {#web_p2#}, {#web_p3#} Параметры Bizon365
{#comments_tag#} Метка: писал комментарий
{#clickFile_tag#} Метка: нажал кнопку
{#clickBanner_tag#} Метка: нажал баннер
{#finished_tag#} Метка: досмотрел до конца
{#report_field_ИМЯ_ПОЛЯ#} Любое поле из отчёта

Пример — уведомить о поведении участника на вебинаре:

  • Отправить сообщение
    • Chat ID: 123456789,987654321 (Chat ID менеджеров)
    • Текст: Участник: {#name#}\nБыл {#bil_minut#} мин.\nГород: {#city#}\nКликнул кнопку: {#clickFile#}\nДосмотрел: {#finished#}
    • Формат: HTML

Раздел «Оплаты»

Сюда попадают данные, когда человек оплатил или оформил заказ.

Что можно подставить в поля:

Шорткод Что подставится
{#name#} Имя
{#email#} Email
{#phone#} Телефон
{#payment_number#} Номер заказа
{#positions#} Название тарифа/продукта
{#costMoney#} Стоимость
{#leftCostMoney#} Осталось оплатить
{#payedMoney#} Уже оплачено
{#payment_status#} Статус платежа
{#paymentLink#} Ссылка на оплату
{#utm_source#}, {#utm_medium#}, {#utm_campaign#} UTM-метки
{#pay_field_ИМЯ_ПОЛЯ#} Любое поле из данных оплаты

Пример — уведомить об оплате в группу:

  • Отправить сообщение
    • Chat ID: -1001234567890 (Chat ID группы)
    • Текст: <b>Оплата!</b>\n{#name#} оплатил {#costMoney#} руб.\nТариф: {#positions#}\nСтатус: {#payment_status#}
    • Формат: HTML

Готовые примеры настройки

Регистрация → уведомление менеджеру

Раздел: Регистрации

Действие Поля
Отправить сообщение Chat ID: 123456789, Текст: Новая заявка!\nИмя: {#name#}\nТелефон: {#phone#}\nEmail: {#email#}, Формат: HTML

После вебинара → уведомление в группу

Раздел: Отчёты

Действие Поля
Отправить сообщение Chat ID: -1001234567890, Текст: {#name#} был на вебинаре {#bil_minut#} мин.\nКнопка: {#clickFile#}, Досмотрел: {#finished#}, Формат: HTML

Оплата → уведомления менеджерам и в группу

Раздел: Оплаты

Действие Поля
Отправить сообщение (1) Chat ID: 111111111,222222222 (менеджеры), Текст: Оплата от {#name#}!\n{#costMoney#} руб. — {#positions#}\nТел: {#phone#}, Формат: HTML
Отправить сообщение (2) Chat ID: -1001234567890 (группа), Текст: <b>+{#costMoney#} руб.</b> — {#positions#}, Формат: HTML

Неоплаченный заказ → напоминание менеджеру

Раздел: Оплаты

Условие: payment_statusсодержитОжидает оплаты (или другой статус неоплаченного заказа)

Действие Поля
Отправить сообщение Chat ID: 123456789 (менеджер), Текст: Неоплаченный заказ!\n{#name#} — {#positions#}\nСумма: {#costMoney#} руб.\nОсталось: {#leftCostMoney#} руб.\nСсылка на оплату: {#paymentLink#}, Формат: HTML

Используйте условие в правиле, чтобы отфильтровать только неоплаченные заказы по {#payment_status#}.

Персональное уведомление клиенту (динамический Chat ID)

Раздел: Оплаты

Действие Поля
Отправить сообщение Chat ID: {#telegram_id#} (шорткод из данных клиента), Текст: Здравствуйте, {#name#}! Ваш заказ #{#payment_number#} подтверждён., Формат: HTML

Chat ID можно передавать через шорткод, если он хранится в данных клиента (например, в CRM).

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

Как узнать свой Chat ID?
Напишите боту @getmyidx_bot или @myidbot — он покажет ваш числовой ID.
Как узнать Chat ID группы?
Добавьте бота @getmyidx_bot в вашу группу. Бот сразу напишет в группу её числовой ID (отрицательное число, начинается с -100, например -1001234567890). Скопируйте этот ID и вставьте в поле Chat ID в действии. После этого бота-помощника можно удалить из группы — он больше не нужен. Не забудьте также добавить в эту группу вашего бота (тот, чей токен указан в сервисе) — иначе сообщения не дойдут.
Сообщение не отправляется
Проверьте, что получатель начал диалог с ботом (нажал /start). Бот не может написать первым.
Ошибка «chat not found»
Проверьте Chat ID: для пользователей — положительное число, для групп — отрицательное (начинается с -100). Убедитесь, что бот добавлен в группу.
Часть сообщений дошла, часть нет
Система отправляет каждому получателю отдельно. Если один Chat ID невалиден — для него будет ошибка, остальные получат сообщение. Проверьте, все ли получатели нажали /start.
Теги отображаются как текст
Проверьте, что выбран правильный формат: для <b>текст</b> нужен HTML, для *текст* — Markdown. Незакрытые теги приведут к отправке как обычный текст.
Как отправить в канал?
Добавьте бота администратором в канал. В Chat ID укажите @username канала или его числовой ID.
Сообщение слишком длинное
Telegram ограничивает длину сообщения 4096 символами. Разделите текст на несколько действий.
Можно ли отправлять файлы?
Нет, Telegram уведомления поддерживает только текстовые сообщения.
Ошибка при подключении
Проверьте токен бота. Получите актуальный через @BotFather → /mybots → API Token.
Чем отличается от Telegram Bot?
Telegram уведомления — для односторонних уведомлений по триггерам. Telegram Bot — для чат-ботов (приём и обработка сообщений, двусторонний диалог).
Какой шорткод использовать?
Нажмите {--} рядом с полем — откроется список всех доступных шорткодов для вашего типа интеграции.
×