n8n-nodes-telegram-gramjs-lite

Это кастомная нода для n8n, которая обеспечивает интеграцию с Telegram через GramJS (упрощенная Lite версия) вместо Bot API. Это позволяет использовать расширенные возможности и доступ к пользовательскому аккаунту.

⚠️ Это Lite версия (v1.0.7) - демонстрационная версия с ограниченным набором API методов.

Для получения полной PRO версии с расширенными функциями обратитесь в Telegram @n8nsupport ❤️

🚀 Возможности (Lite версия)

• Демонстрационный доступ к GramJS API: Используйте свой личный аккаунт Telegram
• Отправка текстовых сообщений: Отправляйте сообщения от имени пользователя
• Улучшенное управление сессиями: Постоянная аутентификация без повторного входа
• Расширенное разрешение контактов: Поддержка имен пользователей, ID чатов, групп и каналов
• Полная аутентификация: Поддержка входа с кодом подтверждения и 2FA
• Улучшенная обработка ошибок: Детальные сообщения и рекомендации
• Улучшенное логирование: Подробные логи для отладки
• Настраиваемое отображение сессии: Показ или скрытие строки сессии в результатах

🔥 PRO версия включает:

• Все методы Telegram API (300+ методов)
• Отправку медиа файлов (фото, видео, документы)
• Работу с каналами и группами
• Получение сообщений и чатов
• Расширенные настройки сессий
• Форвардинг сообщений
• Управление участниками

📋 Требования

1. Учетные данные Telegram API: Получите свои api_id и api_hash на my.telegram.org/apps
2. Номер телефона: Номер телефона, привязанный к вашему аккаунту Telegram
3. Версия n8n: Протестировано на n8n v1.93.0

🔧 Установка

Через Community Nodes (Рекомендуется)

1. Перейдите в Настройки → Community Nodes в вашем экземпляре n8n
2. Нажмите Install и введите: n8n-nodes-telegram-gramjs-lite
3. Нажмите Install

Ручная установка

# В директории установки n8n
npm install n8n-nodes-telegram-gramjs-lite

⚙️ Настройка и аутентификация

Шаг 1: Получение учетных данных Telegram API

1. Перейдите на my.telegram.org/apps
2. Войдите, используя свой номер телефона
3. Создайте новое приложение
4. Скопируйте свои api_id и api_hash

Шаг 2: Настройка учетных данных в n8n

1. В n8n создайте новые учетные данные Telegram GramJS API
2. Заполните:
   • API ID: Ваш api_id из Telegram
   • API Hash: Ваш api_hash из Telegram
   • Номер телефона: Ваш номер телефона (в международном формате: +1234567890)
   • Строка сессии: Оставьте пустым при первой аутентификации
   • Пароль 2FA: Оставьте пустым в Lite версии

Шаг 3: Первая аутентификация

1. Создайте рабочий процесс с нодой Telegram GramJS
2. Установите операцию "Аутентификация"
3. Настройте параметры управления сессией:
   • Отображать строку сессии в результате - включите для просмотра строки сессии
   • Автоматически сохранять сессию - включите для автоматического сохранения (будет реализовано в будущих версиях)
4. Выполните ноду - вы получите ответ с запросом кода подтверждения
5. Проверьте приложение Telegram на наличие кода подтверждения
6. Введите код в поле "Код подтверждения"
7. Выполните снова - вы получите результат аутентификации и строку сессии
8. Скопируйте строку сессии и вставьте ее в учетные данные в поле "Строка сессии"
9. Сохраните учетные данные

🔑 Улучшенное управление сессиями

В версии 1.0.7 мы добавили улучшенное управление сессиями:

Параметры управления сессией

• Отображать строку сессии в результате - Вы можете выбрать, отображать ли строку сессии в результате операции. Это полезно, если вы хотите скрыть чувствительную информацию.
• Автоматически сохранять сессию - Предварительная поддержка для будущей функциональности, которая позволит автоматически сохранять сессию.

Формат вывода сессии

При включенном отображении строки сессии, в результате вы получите:

{
  "sessionString": "1BAAHqwrpOhz3k...длинная строка...Rqwe12==",
  "sessionStringFormatted": {
    "full": "1BAAHqwrpOhz3k...длинная строка...Rqwe12==",
    "length": 648,
    "preview": "1BAAHqwrpOhz3k...Rqwe12=="
  }
}

Это позволяет:

• Легко копировать полную строку
• Видеть длину строки для проверки целостности
• Получать краткий предпросмотр для быстрой идентификации

Шаг 4: Отправка сообщений

1. Измените операцию на "Отправить сообщение"
2. Введите ID чата (имя пользователя @username, телефон +1234567890 или числовой ID)
3. Введите ваше Сообщение
4. Выполните!

📝 Примеры использования

Базовая отправка сообщений

{
  "operation": "sendMessage",
  "chatId": "@username",
  "message": "Привет из n8n через GramJS Lite!"
}

Использование номеров телефонов

{
  "operation": "sendMessage", 
  "chatId": "+1234567890",
  "message": "Сообщение отправлено на номер телефона"
}

Использование числового ID чата

{
  "operation": "sendMessage",
  "chatId": "123456789", 
  "message": "Сообщение отправлено по ID чата"
}

🔐 Управление сессиями

• Строка сессии: После первой аутентификации сохраните строку сессии в учетных данных
• Постоянный вход: С сохраненной сессией нет необходимости в повторной аутентификации
• Безопасность: Строки сессий зашифрованы и безопасно хранятся в n8n
• Истечение срока: Сессии могут истекать, требуя повторной аутентификации

⚠️ Важные замечания

Процесс аутентификации

1. Первый запуск: Операция "Аутентификация" без кода → код отправлен в Telegram
2. Второй запуск: Операция "Аутентификация" с кодом → возвращена строка сессии
3. Сохранение сессии: Скопируйте строку сессии в учетные данные для будущего использования

Форматы ID чатов (в Lite версии)

• Имя пользователя: @username (рекомендуется)
• ID чата: 123456789 (числовой ID пользователя)

⚠️ В Lite версии поддержка телефонных номеров ограничена. Используйте @username или числовой ID.

Обработка ошибок

• "Не аутентифицирован": Сначала выполните операцию аутентификации
• "Невозможно разрешить контакт": Проверьте формат ID чата, используйте @username
• "Ограниченная функциональность": В Lite версии доступны не все методы API (демонстрационная версия)

🔧 Устранение неполадок

Распространенные проблемы

1. "Неверный номер телефона"

   • Используйте международный формат: +1234567890
   • Включите код страны

2. "Сессия истекла"

   • Очистите строку сессии из учетных данных
   • Повторите процесс аутентификации

3. "Не удается разрешить имя пользователя"

   • Убедитесь, что имя пользователя существует и публично
   • Попробуйте использовать номер телефона вместо этого

4. "Требуется двухфакторная аутентификация"

   • Введите пароль 2FA в поле "Пароль 2FA" в учетных данных
   • Убедитесь, что это ваш облачный пароль, а не PIN-код приложения
   • 2FA полностью поддерживается в Lite версии

5. "Ограниченная функциональность"

   • Lite версия содержит ограниченный набор API методов
   • Для доступа ко всем 300+ методам API используйте PRO версию
   • Обратитесь в @n8nsupport для получения PRO версии

📚 Справочник API

Операции

Аутентификация

• Назначение: Вход в систему и получение строки сессии
• Параметры: Код подтверждения (когда требуется)
• Возвращает: Строка сессии для учетных данных

Отправить сообщение

• Назначение: Отправка текстового сообщения
• Параметры: ID чата, Сообщение
• Возвращает: Детали сообщения и ID

🐛 Ограничения Lite версии

• Ограниченный набор API методов: Доступны только базовые операции для демонстрации
• Только текстовые сообщения: Медиа-сообщения доступны в PRO версии
• Базовая работа с чатами: Расширенные операции с группами/каналами в PRO версии
• Демонстрационное назначение: Lite версия предназначена для ознакомления с возможностями
• Медиа-сообщения: Только текст (медиа доступно в PRO версии)
• Групповые чаты: Базовая поддержка отправки сообщений
• Номера телефонов: Ограниченная поддержка разрешения по номеру телефона
• Расширенные функции: Доступны только в PRO версии

🔥 Хотите больше возможностей? Получите PRO версию: @n8nsupport

🤝 Поддержка

Если у вас возникли вопросы или проблемы с использованием этой ноды, присоединяйтесь к нашему каналу поддержки: t.me/n8nsupport

Получите PRO версию с расширенными возможностями!

Мы рады помочь вам с настройкой и использованием GramJS интеграции!

🔗 Ссылки

• n8n Community Nodes
• Документация gramjs Core
• Документация Telegram API
• Получить учетные данные Telegram API

---

Протестировано с n8n v1.93.0 | Сделано с ❤️ для сообщества n8n