Интеграция с Telegram
Получайте уведомления о новых заявках прямо в Telegram — в личные сообщения или групповой чат. Это самый быстрый способ узнать о новом лиде: сообщение приходит через 1-2 секунды после отправки формы.
Что понадобится
Ссылка на раздел «Что понадобится»- Аккаунт в Telegram
- 5-10 минут времени
Шаг 1. Создайте бота в Telegram
Ссылка на раздел «Шаг 1. Создайте бота в Telegram»Бот — это специальный аккаунт Telegram, который будет отправлять вам уведомления. Создать его можно бесплатно.
-
Откройте Telegram и найдите @BotFather (официальный бот для создания ботов)
-
Отправьте команду
/newbot -
Придумайте имя бота (например, «Уведомления с сайта»)
-
Придумайте username бота — должен заканчиваться на
bot(например,mycompany_leads_bot) -
BotFather пришлёт вам токен — длинную строку вида:
Код7234567890:AAHqX1-dfGhJkLmNoPqRsTuVwXyZ12345
Важно: Сохраните этот токен — он понадобится на следующем шаге. Не делитесь им с посторонними.
Шаг 2. Получите Chat ID
Ссылка на раздел «Шаг 2. Получите Chat ID»Chat ID — это адрес чата, куда бот будет отправлять сообщения. Он разный для личных сообщений и групп.
[!WARNING] Chat ID — это не username бота. Это числовой идентификатор чата-получателя сообщений.
Вариант А: Уведомления в личные сообщения
Ссылка на раздел «Вариант А: Уведомления в личные сообщения»- Найдите своего бота в Telegram (по username, который вы придумали)
- Нажмите «Запустить» (или отправьте
/start) - Найдите бота @userinfobot и отправьте ему любое сообщение
- Он ответит вашим Chat ID — число вида
123456789
Вариант Б: Уведомления в групповой чат
Ссылка на раздел «Вариант Б: Уведомления в групповой чат»Если хотите, чтобы уведомления получала вся команда:
- Создайте группу в Telegram (или используйте существующую)
- Добавьте своего бота в группу как участника
- Добавьте в группу бота @RawDataBot
- RawDataBot пришлёт сообщение с информацией о группе
- Найдите строку
"id":— это Chat ID группы (отрицательное число, например-1001234567890) - Удалите RawDataBot из группы (он больше не нужен)
Совет: Chat ID группы всегда начинается с минуса (-).
Шаг 3. Настройте интеграцию в Поптимайзер
Ссылка на раздел «Шаг 3. Настройте интеграцию в Поптимайзер»-
Откройте попап в редакторе
-
Нажмите «Интеграции» в верхнем меню
-
Нажмите «Добавить интеграцию»
-
Выберите «Telegram»
-
Заполните форму:
- Название — как интеграция будет отображаться в списке (например, «Уведомления в чат продаж»)
- Токен бота — вставьте токен из шага 1
- Chat ID — вставьте Chat ID из шага 2
-
Нажмите «Создать»
Шаг 4. Настройте шаблон сообщения
Ссылка на раздел «Шаг 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. Проверьте маппинг полей
Ссылка на раздел «Шаг 5. Проверьте маппинг полей»После настройки шаблона сообщения внизу формы появится блок маппинга полей. Он автоматически проверяет, что переменные из шаблона совпадают с полями формы в попапе:
- Совпадающие поля (зелёная точка) — переменная найдена в форме попапа. Данные будут подставлены корректно.
- Отсутствующие поля (оранжевое предупреждение) — переменная указана в шаблоне, но такого поля нет в попапе. Данные не будут подставлены.
- Неиспользуемые поля (сворачиваемый список) — поля есть в форме попапа, но не упомянуты в шаблоне. Данные не потеряются, но в сообщение не попадут.
Совет:
Если видите оранжевые предупреждения — проверьте, что в попапе есть все нужные поля формы, или уберите лишние переменные из шаблона.
Шаг 6. Протестируйте
Ссылка на раздел «Шаг 6. Протестируйте»- Найдите созданную интеграцию в списке
- Нажмите кнопку «Тест»
- Проверьте Telegram — должно прийти тестовое сообщение
Если сообщение не пришло:
- «Chat not found» — бот не имеет доступа к чату. Для личных сообщений — откройте бота и отправьте
/start. Для групп — добавьте бота в группу - Убедитесь, что Chat ID — это не username бота. Chat ID — это числовой ID чата-получателя (ваш личный ID или ID группы)
- Проверьте правильность токена — он должен быть вида
123456789:ABC-DEF... - Для групп убедитесь, что бот имеет права на отправку сообщений
Готово!
Ссылка на раздел «Готово!»Теперь при каждой отправке формы вы будете получать уведомление в Telegram.
Частые вопросы
Ссылка на раздел «Частые вопросы»Ошибка «Chat not found»
Ссылка на раздел «Ошибка «Chat not found»»Самая частая причина — бот не имеет доступа к указанному чату:
- Для личных сообщений — откройте бота в Telegram и отправьте
/start - Для групп — добавьте бота в группу как участника
- Убедитесь, что в поле Chat ID указан ID чата-получателя, а не username бота. Узнать свой Chat ID можно через @userinfobot
Можно ли отправлять в несколько чатов?
Ссылка на раздел «Можно ли отправлять в несколько чатов?»Да. Создайте несколько Telegram-интеграций с разными Chat ID и привяжите их к попапу.
Сообщения не приходят в группу
Ссылка на раздел «Сообщения не приходят в группу»- Убедитесь, что бот добавлен в группу
- Убедитесь, что бот имеет права на отправку сообщений
- Проверьте Chat ID — для групп он отрицательный
Как изменить формат сообщения?
Ссылка на раздел «Как изменить формат сообщения?»Откройте интеграцию на редактирование и измените шаблон. Изменения применятся сразу.
Что если я удалю бота?
Ссылка на раздел «Что если я удалю бота?»Интеграция перестанет работать. Создайте нового бота и обновите токен в настройках интеграции.
Нужна помощь с настройкой? Напишите нам на support@poptimizer.ru — поможем разобраться.
Следующие шаги:
- Настройка MAX — уведомления в мессенджер MAX
- Настройка Webhook — интеграция с CRM и другими сервисами