Переписки Telegram могут быть частью не только разговора с ИИ. REST API Telepath подключает этот контекст к инструментам автоматизации и вашим приложениям.

Используйте наш узел сообщества n8n как готовую отправную точку или создайте HTTP-интеграцию для Make и подобных инструментов. API использует OAuth: каждый человек подключает собственный аккаунт Telepath и разрешает доступ к нему.

Что можно создать

  • Сводку переписок: прочитайте доступные сообщения выбранных чатов, обобщите выбранным ИИ и сохраните результат.
  • Работу с запросами клиентов: найдите диалог, извлеките запрос и создайте заметку или задачу.
  • Помощника для ответов: подготовьте черновик, проверьте его и отправьте через разрешённое подключение Telegram.
  • Сценарий для канала: подготовьте материал и опубликуйте в подключённый канал с нужными разрешениями.

API также предоставляет доступные расшифровки, поддерживаемые медиа, Notes и напоминания. Доступ зависит от подключений, сохранённых данных и разрешений аккаунта.

Подключите Telepath к n8n

Пакет n8n-nodes-telepath содержит операции чатов, сообщений, медиа, каналов, Notes и напоминаний, а также учётные данные Telepath OAuth2 API.

  1. В n8n на своём сервере откройте Settings → Community Nodes и установите n8n-nodes-telepath.
  2. Добавьте узел Telepath и создайте учётные данные Telepath OAuth2 API. Используйте актуальную версию n8n с динамической регистрацией OAuth-клиентов.
  3. Нажмите Connect my account и завершите вход через Telegram. Учётные данные обрабатывают регистрацию, PKCE и используют обновление токенов n8n.
  4. Убедитесь, что сбор Telegram подключён: по инструкции для устройства разрешите личные чаты в Chat Automation. Вход и доступность истории — разные шаги.
  5. Запустите Chat → List Telegram chats, затем Read chat messages, чтобы проверить данные до автоматизации.

Используете n8n Cloud? Установка зависит от проверки и наличия в каталоге узлов n8n. Публикация в npm сама по себе не делает пакет доступным в Cloud. См. правила установки узлов сообщества n8n; эта инструкция начинается с установки на свой сервер.

В репозитории есть примеры сценариев: список чатов и сбор ограниченного окна сообщений в n8n Data Table. Выберите свои учётные данные и проверьте чат перед запуском расписания.

А что с Make?

HTTP-приложение Make вызывает API без отдельного модуля приложения. Это возможный путь для Telepath; здесь не описывается нативное приложение Telepath в Make.

Сначала настройте авторизацию. Telepath требует Authorization Code с S256 PKCE, зарегистрированный callback URL и обновление токенов. Make описывает OAuth 2.0-подключение, но наличие обычного OAuth не доказывает совместимость. Полный цикл входа и обновления Make для этой инструкции не проверялся.

Если подключение Make не умеет генерировать и обменивать PKCE, нужен совместимый OAuth-посредник или собственная интеграция. Перед разработкой свяжитесь с нами. При рабочем OAuth запросы используют базовый URL ниже, JSON при необходимости и Bearer-токен. Храните учётные данные в настройках подключения платформы, не в промптах и сообщениях.

Авторизация API и примеры

Все методы, параметры, ответы и ошибки — в полном справочнике REST API Telepath. Также можно скачать спецификацию OpenAPI 3.1.

Базовый URL: https://telepath.lemma.company/api/v1

Собственные клиенты получают адреса авторизации, токенов и регистрации из OAuth-метаданных Telepath. Зарегистрируйте точный redirect URI, используйте S256 PKCE и запрашивайте telegram.read для чтения, telegram.write — для действий. Идентификатор ресурса OAuth — https://telepath.lemma.company/mcp, в том числе для REST.

После OAuth передавайте Authorization: Bearer <access_token>. Токен Telegram-бота не является токеном Telepath. Обрабатывайте истечение через OAuth refresh, не копируйте временный токен в постоянный сценарий.

Получить список чатов

Запрос только для чтения использует тот же метод, что и проверка учётных данных n8n. Переменная оболочки ниже — ваш действующий токен доступа.

curl 'https://telepath.lemma.company/api/v1/chats/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

Прочитать один чат

Замените CHAT_ID на ID, полученный для вашего архива.

curl 'https://telepath.lemma.company/api/v1/chats/CHAT_ID/messages?limit=20' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

Отправить разрешённый ответ

При действующих токене, ID чата и разрешениях запрос отправляет настоящее сообщение. Сначала проверьте адресата и текст.

curl 'https://telepath.lemma.company/api/v1/chats/CHAT_ID/messages' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Thanks for your message. I will get back to you shortly."}'

Для личных Business-чатов Telegram нужны разрешение отвечать и входящее сообщение в этом чате за последние 24 часа. Публикация в каналах использует отдельные операции и права.

Начните с небольшого сценария по расписанию

  1. Настройте расписание, для начала раз в пять минут.
  2. Читайте ограниченное окно сообщений выбранного чата.
  3. Отфильтруйте входящие и удалите повторы по ID чата + ID сообщения в постоянном хранилище.
  4. Подготовьте сводку или черновик с выбранным ИИ.
  5. Проверяйте ответы до отправки и сохраняйте результат, чтобы не повторять действия.

Это опрос, а не webhook входящих сообщений. Сейчас API Telepath не выдаёт исходящее событие для каждого нового сообщения. Ограниченное чтение может пропустить сообщения при высокой активности или простое. Периодический снимок не гарантирует полный сбор.

REST-шлюз разрешает 120 запросов в минуту на аккаунт, общих для учётных данных и сценариев. Действуют лимиты Telegram и тарифов. Соблюдайте 429 и Retry-After. При тайм-ауте отправки или неопределённой ошибке проверьте чат перед повтором: сообщение могло уже прийти.

Сначала сделайте историю доступной

OAuth даёт сценарию доступ к аккаунту Telepath, но не импортирует все переписки Telegram. Chat Automation сохраняет новые сообщения разрешённых личных чатов. Для старой истории отправьте /import боту Telepath и следуйте инструкции экспорта. Для групп и каналов нужны свои настройки и разрешения.

Начните с одного чата и сценария только для чтения. Убедитесь, что нужные сообщения видны, затем добавляйте следующий шаг. Если нужна помощь с выбором n8n или интеграции Make, расскажите, что хотите автоматизировать.