← Назад к интеграциям

🤖 Telegram Bot Integration

Уведомления и эскалация через Telegram для всех типов AI-ассистентов

✅ Доступно для: Всех типов агентов (Creator, Service, E-commerce)

Возможности

  • ✅ Уведомления об эскалации (когда ИИ передаёт диалог человеку)
  • ✅ Уведомления об оплатах
  • ✅ Дублирование уведомлений в канал
  • ✅ Проверка прав бота в канале
  • ✅ Webhook для получения сообщений

Настройка

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

  1. Откройте @BotFather в Telegram
  2. Отправьте команду /newbot
  3. Введите имя бота (например, MyShop Assistant)
  4. Введите username бота (например, myshop_assistant_bot)
  5. Скопируйте Bot Token

Шаг 2: Узнайте свой User ID

  1. Откройте @userinfobot в Telegram
  2. Нажмите Start
  3. Скопируйте свой User ID

Шаг 3: Настройте канал (опционально)

  1. Создайте канал в Telegram
  2. Добавьте бота в канал как администратора
  3. Дайте права на отправку сообщений
  4. Скопируйте Channel ID (например, @mychannel или -1001234567890)

Шаг 4: Включите интеграцию

  1. Откройте страницу агента → вкладка Интеграции
  2. Заполните поля:
    • Bot Token - токен от @BotFather
    • User ID - ваш ID для уведомлений
    • Channel ID (опционально) - канал для дублирования
  3. Нажмите Проверить для проверки прав бота в канале
  4. Нажмите Сохранить интеграции

API Reference

Webhook Endpoint

POST /api/v1/telegram/:agentId/webhook

Получение сообщений от Telegram

GET /api/v1/telegram/:agentId/check-channel-admin

Проверка прав бота в канале

Типы уведомлений

⚠️ Эскалация

Отправляется когда ИИ не может ответить и передаёт диалог человеку

⚠️ Эскалация диалога

Агент: MyShop Assistant

Клиент: +79991234567

Причина: Повторяющийся вопрос

💳 Оплата

Отправляется при подтверждении оплаты заказа

✅ Заказ оплачен

Заказ №: ORD-20260402-00001

Сумма: 5000 ₽

🐛 Troubleshooting

Бот не отправляет уведомления

Проблема: Уведомления не приходят

Решение: Проверьте Bot Token и User ID, убедитесь что бот активен

Бот не администратор канала

Проблема: Ошибка проверки прав

Решение: Добавьте бота в канал как администратора с правом отправки сообщений

Webhook не работает

Проблема: Telegram не доставляет сообщения

Решение: Проверьте что webhook URL доступен из интернета (не localhost)

← Все интеграцииЭскалация →