Перейти к содержанию
Разделы документации

Интеграция с Telegram

Получайте уведомления о новых заявках прямо в Telegram — в личные сообщения или групповой чат. Это самый быстрый способ узнать о новом лиде: сообщение приходит через 1-2 секунды после отправки формы.

  • Аккаунт в Telegram
  • 5-10 минут времени

Бот — это специальный аккаунт Telegram, который будет отправлять вам уведомления. Создать его можно бесплатно.

  1. Откройте Telegram и найдите @BotFather (официальный бот для создания ботов)

  2. Отправьте команду /newbot

  3. Придумайте имя бота (например, «Уведомления с сайта»)

  4. Придумайте username бота — должен заканчиваться на bot (например, mycompany_leads_bot)

  5. BotFather пришлёт вам токен — длинную строку вида:

    Код
    7234567890:AAHqX1-dfGhJkLmNoPqRsTuVwXyZ12345

Важно: Сохраните этот токен — он понадобится на следующем шаге. Не делитесь им с посторонними.

Chat ID — это адрес чата, куда бот будет отправлять сообщения. Он разный для личных сообщений и групп.

[!WARNING] Chat ID — это не username бота. Это числовой идентификатор чата-получателя сообщений.

Вариант А: Уведомления в личные сообщения

Ссылка на раздел «Вариант А: Уведомления в личные сообщения»
  1. Найдите своего бота в Telegram (по username, который вы придумали)
  2. Нажмите «Запустить» (или отправьте /start)
  3. Найдите бота @userinfobot и отправьте ему любое сообщение
  4. Он ответит вашим Chat ID — число вида 123456789

Вариант Б: Уведомления в групповой чат

Ссылка на раздел «Вариант Б: Уведомления в групповой чат»

Если хотите, чтобы уведомления получала вся команда:

  1. Создайте группу в Telegram (или используйте существующую)
  2. Добавьте своего бота в группу как участника
  3. Добавьте в группу бота @RawDataBot
  4. RawDataBot пришлёт сообщение с информацией о группе
  5. Найдите строку "id": — это Chat ID группы (отрицательное число, например -1001234567890)
  6. Удалите RawDataBot из группы (он больше не нужен)

Совет: Chat ID группы всегда начинается с минуса (-).

Шаг 3. Настройте интеграцию в Поптимайзер

Ссылка на раздел «Шаг 3. Настройте интеграцию в Поптимайзер»
  1. Откройте попап в редакторе

  2. Нажмите «Интеграции» в верхнем меню

  3. Нажмите «Добавить интеграцию»

  4. Выберите «Telegram»

  5. Заполните форму:

    • Название — как интеграция будет отображаться в списке (например, «Уведомления в чат продаж»)
    • Токен бота — вставьте токен из шага 1
    • Chat ID — вставьте Chat ID из шага 2
  6. Нажмите «Создать»

По умолчанию сообщение выглядит так:

Код
🔔 Новая заявка!

test@example.com
Иван Иванов
+7 999 123-45-67

⏰ 26.01.2025, 15:30

Вы можете изменить шаблон. Доступные переменные:

ПеременнаяЧто подставится
{{data.email}}Email из формы
{{data.name}}Имя из формы
{{data.phone}}Телефон из формы
{{timestamp}}Дата и время

Пример кастомного шаблона:

Код
🎯 Новый лид с сайта!

👤 {{data.name}}
📧 {{data.email}}
📱 {{data.phone}}

💬 Комментарий: {{data.message}}

Время: {{timestamp}}

Совет: Названия переменных должны совпадать с атрибутом name полей в вашей форме.

После настройки шаблона сообщения внизу формы появится блок маппинга полей. Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:

  • Совпадающие поля (зелёная точка) — переменная найдена в форме попапа. Данные будут подставлены корректно.
  • Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе. Данные не будут подставлены.
  • Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне. Данные не потеряются, но в сообщение не попадут.

Совет:

Если видите оранжевые предупреждения — проверьте, что в попапе есть все нужные поля формы, или уберите лишние переменные из шаблона.

  1. Найдите созданную интеграцию в списке
  2. Нажмите кнопку «Тест»
  3. Проверьте Telegram — должно прийти тестовое сообщение

Если сообщение не пришло:

  • «Chat not found» — бот не имеет доступа к чату. Для личных сообщений — откройте бота и отправьте /start. Для групп — добавьте бота в группу
  • Убедитесь, что Chat ID — это не username бота. Chat ID — это числовой ID чата-получателя (ваш личный ID или ID группы)
  • Проверьте правильность токена — он должен быть вида 123456789:ABC-DEF...
  • Для групп убедитесь, что бот имеет права на отправку сообщений

Теперь при каждой отправке формы вы будете получать уведомление в Telegram.


Самая частая причина — бот не имеет доступа к указанному чату:

  1. Для личных сообщений — откройте бота в Telegram и отправьте /start
  2. Для групп — добавьте бота в группу как участника
  3. Убедитесь, что в поле Chat ID указан ID чата-получателя, а не username бота. Узнать свой Chat ID можно через @userinfobot

Можно ли отправлять в несколько чатов?

Ссылка на раздел «Можно ли отправлять в несколько чатов?»

Да. Создайте несколько Telegram-интеграций с разными Chat ID и привяжите их к попапу.

  1. Убедитесь, что бот добавлен в группу
  2. Убедитесь, что бот имеет права на отправку сообщений
  3. Проверьте Chat ID — для групп он отрицательный

Откройте интеграцию на редактирование и измените шаблон. Изменения применятся сразу.

Интеграция перестанет работать. Создайте нового бота и обновите токен в настройках интеграции.


Нужна помощь с настройкой? Напишите нам на support@poptimizer.ru — поможем разобраться.


Следующие шаги:

Статья помогла?

Обновлено . Нашли ошибку? Напишите на support@poptimizer.ru.