telegram-bot-gridasov

Package Information

Released: 7/16/2025
Downloads: 0 weekly / 0 monthly
Latest Version: 1.1.0
Author: xoldxold2

Available Nodes

Telegram Bot icon
Telegram Bot
Fetch messages from Telegram bot

Documentation

n8n-nodes-telegram-bot

Это community node для n8n, который позволяет получать сообщения из Telegram бота.

Установка

  1. Откройте n8n
  2. Перейдите в Settings > Community Nodes
  3. Установите пакет: n8n-nodes-telegram-bot

Настройка

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

  1. Найдите @BotFather в Telegram
  2. Отправьте команду /newbot
  3. Следуйте инструкциям для создания бота
  4. Сохраните полученный токен

Настройка credentials в n8n

  1. В n8n создайте новые credentials типа "Telegram Bot API"
  2. Введите токен вашего бота в поле "Bot Token"
  3. Протестируйте соединение

Использование

Базовый workflow

  1. Добавьте триггер "Schedule Trigger" для периодического выполнения
  2. Добавьте ноду "Telegram Bot"
  3. Выберите операцию "Get Updates"
  4. Настройте параметры:
    • Limit: количество сообщений для получения (по умолчанию 100)
    • Offset: ID первого обновления для получения
    • Timeout: таймаут для long polling

Параметры

  • Limit: Максимальное количество получаемых обновлений (1-100)
  • Timeout: Таймаут в секундах для long polling (0-50). Большие значения уменьшают количество API запросов
  • Auto Confirm Updates: Автоматически подтверждать полученные обновления (рекомендуется)

Пример workflow

Schedule Trigger (каждые 5 минут)
    ↓
Telegram Bot (Get New Updates)
    ↓
IF (проверка типа сообщения)
    ↓
Обработка сообщений

Автоматическое управление offset

Нода автоматически отслеживает последние обработанные сообщения:

  • ✅ Не нужно вручную настраивать offset
  • ✅ Автоматически избегает дублирования сообщений
  • ✅ Сохраняет состояние между запусками workflow
  • ✅ Подтверждает обработанные обновления в Telegram

Структура данных

При наличии новых сообщений:

{
  "update_id": 123456789,
  "message": {
    "message_id": 1,
    "from": {
      "id": 123456789,
      "is_bot": false,
      "first_name": "John",
      "username": "john_doe"
    },
    "chat": {
      "id": 123456789,
      "first_name": "John",
      "username": "john_doe",
      "type": "private"
    },
    "date": 1640995200,
    "text": "Hello, bot!"
  }
}

При отсутствии новых сообщений:

{
  "message": "No new updates available",
  "last_offset": 123456790,
  "timestamp": "2025-07-16T08:30:00.000Z"
}

Рекомендации

  1. Используйте timeout > 0 для long polling - это уменьшает нагрузку на API
  2. Оставьте Auto Confirm включенным - это предотвращает повторную обработку сообщений
  3. Настройте Schedule Trigger с интервалом больше timeout для оптимальной работы
  4. Обрабатывайте различные типы обновлений (сообщения, callback queries, inline queries)

Лицензия

MIT

Discussion