поптимайзер Docs

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

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

Что понадобится

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

Шаг 1. Создайте бота в Telegram

Бот — это специальный аккаунт Telegram, который будет отправлять вам уведомления. Создать его можно бесплатно.
  1. Откройте Telegram и найдите @BotFather (официальный бот для создания ботов)
Поиск BotFather в Telegram Скриншот: Поиск @BotFather в Telegram — показан верифицированный аккаунт с синей галочкой
  1. Отправьте команду /newbot
  2. Придумайте имя бота (например, «Уведомления с сайта»)
  3. Придумайте username бота — должен заканчиваться на bot (например, mycompany_leads_bot)
  4. BotFather пришлёт вам токен — длинную строку вида:
    7234567890:AAHqX1-dfGhJkLmNoPqRsTuVwXyZ12345
Получение токена от BotFather Скриншот: Диалог с BotFather — сообщение с токеном бота (токен выделен или подчёркнут)
Важно: Сохраните этот токен — он понадобится на следующем шаге. Не делитесь им с посторонними.

Шаг 2. Получите Chat ID

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

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

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

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

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

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

  1. Откройте попап в редакторе
  2. Нажмите «Интеграции» в верхнем меню
  3. Нажмите «Добавить интеграцию»
  4. Выберите «Telegram»
Выбор Telegram интеграции Скриншот: Форма создания интеграции с выбранной карточкой «Telegram»
  1. Заполните форму:
    • Название — как интеграция будет отображаться в списке (например, «Уведомления в чат продаж»)
    • Токен бота — вставьте токен из шага 1
    • Chat ID — вставьте Chat ID из шага 2
Форма настройки Telegram интеграции Скриншот: Заполненная форма Telegram интеграции — поля «Название», «Токен бота», «Chat ID» и шаблон сообщения
  1. Нажмите «Создать»

Шаг 4. Настройте шаблон сообщения

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

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 полей в вашей форме.

Шаг 5. Проверьте маппинг полей

После настройки шаблона сообщения внизу формы появится блок маппинга полей. Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:
  • Совпадающие поля (зелёная точка) — переменная найдена в форме попапа. Данные будут подставлены корректно.
  • Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе. Данные не будут подставлены.
  • Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне. Данные не потеряются, но в сообщение не попадут.
Маппинг полей интеграции Скриншот: Блок маппинга полей — зелёные совпадения, оранжевые предупреждения об отсутствующих полях и сворачиваемый список неиспользуемых полей
[!TIP] Если видите оранжевые предупреждения — проверьте, что в попапе есть все нужные поля формы, или уберите лишние переменные из шаблона.

Шаг 6. Протестируйте

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

Готово!

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

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

Ошибка «Chat not found»

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

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

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

Сообщения не приходят в группу

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

Как изменить формат сообщения?

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

Что если я удалю бота?

Интеграция перестанет работать. Создайте нового бота и обновите токен в настройках интеграции.
Нужна помощь с настройкой? Напишите нам на support@poptimizer.ru — поможем разобраться.
Следующие шаги: