close

Настройка интеграции с Telegram Bot

Создание бота в Telegram

  • Откройте Telegram и в поиске найдите бота @BotFather
  • Отправьте команду /newbot
  • Введите название бота (например, "My Company Leads")
  • Придумайте и введите username для бота. Он должен:
    • заканчиваться на "bot" (например, mycompany_leads_bot)
    • быть уникальным
    • содержать только латинские буквы, цифры и подчеркивания

После создания бота вы получите токен — длинную строку наподобие:

5485731425:AAHg4RLpkfK7B3nx8kWqBHbE1QnX5yJqZnQ

Важно! Сохраните этот токен, он понадобится для настройки интеграции. Не передавайте его посторонним лицам, так как он предоставляет полный доступ к управлению ботом.

Дополнительно рекомендуется:

  • Установить аватар бота командой /setuserpic
  • Добавить описание бота командой /setdescription
  • Настроить приветственное сообщение командой /setdescription

Получение ID чата

Есть два варианта получения уведомлений:

Вариант 1: Личные сообщения от бота

  • Найдите в поиске созданного бота по его username
  • Напишите ему любое сообщение
  • Откройте в браузере ссылку (подставьте свой токен):
    https://api.telegram.org/bot{ВАШ_ТОКЕН}/getUpdates
  • В ответе найдите поле "chat" -> "id". Это будет ваш ID чата

Вариант 2: Группа или канал

  • Создайте группу/канал в Telegram
  • Добавьте в неё вашего бота (он должен быть администратором)
  • Отправьте в группу любое сообщение
  • Откройте ту же ссылку:
    https://api.telegram.org/bot{ВАШ_ТОКЕН}/getUpdates
  • Найдите ID в ответе. Для группы это будет отрицательное число

Примечание: Если в ответе пусто, отправьте еще одно сообщение в чат с ботом или группу.

Теперь у вас есть токен бота и ID чата — эти данные понадобятся для настройки интеграции в административной панели IWW.RU.

Настройка интеграции со стороны iww.ru

  • Зайдите в административную панель manager.iww.ru
  • Перейдите в раздел "Интеграции" для лидов (1)
  • Нажмите кнопку "Добавить" (2)


В открывшемся окне:

  • Выберите тип интеграции "Telegram"
  • Введите произвольное имя интеграции
  • Укажите ID чата Telegram (полученный ранее)
  • Введите токен бота Telegram (полученный от @BotFather)

Настройка шаблонов сообщений

В интеграции доступно два шаблона:

Шаблон сообщения для форм
Используется для уведомлений о заявках из форм обратной связи. Доступные плейсхолдеры:

Основные:
- Имя клиента
+7 8552 786678 - Телефон
info@iww.ru - Email
#COMMENT# - Комментарий

Системные:
#DATE# - Дата и время
#FORM_NAME# - Название формы
#PAGE_URL# - URL страницы

UTM-метки:
#UTM_SOURCE# - Источник
#UTM_MEDIUM# - Тип трафика
#UTM_CAMPAIGN# - Кампания

Шаблон сообщения для заказов
Используется для уведомлений о новых заказах. Доступные плейсхолдеры:

Основные:
- Имя клиента
+7 8552 786678 - Телефон
info@iww.ru - Email
#CLIENT_TYPE# - Тип клиента

Данные заказа:
#ORDER_ID# - Номер заказа
#ORDER_SUM# - Сумма
#PRODUCTS# - Список товаров
#DELIVERY_TYPE#- Способ доставки
#PAYMENT_TYPE# - Способ оплаты

Системные:
#DATE# - Дата и время
#PAGE_URL# - URL страницы

Дополнительные настройки

Идентификатор источника (по умолчанию "WEB")

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

Тестирование интеграции

После настройки обязательно проверьте корректность работы:

  • Перейдите на ваш проект
  • Воспользуйтесь любой формой обратной связи
  • Проверьте получение уведомления в Telegram