n8n-nodes-teletype-app

n8n-nodes-teletype-app

Teletype Public API → n8n Community Nodes

Набор нод для n8n, который подключает Public API от сервиса teletype.app для работы с такими мессенджерами и соц.сетями как WhatsApp, WABA, Telegram, Max, Instagram, Facebook, Чат на сайт, VK, Avito, Viber, Email.

Что умеет

• ✅ Actions: операции Teletype API в виде нод n8n
• 🔔 Trigger: принимает события из Teletype по Webhook URL
• 🧩 Установка как Community Nodes
• 📝 Подсказки/описания в нодах — на русском

Требования

• У вас должен быть доступ к n8n (самостоятельно установленный / корпоративный / Docker / сервер).
• У вас должен быть доступ к проекту Teletype, где можно открыть Public API и взять API Token.
• Для Trigger: ваш n8n должен быть доступен из интернета (HTTPS, без basic-auth на webhook, без блокировок).

Если у вас нет доступа к настройкам n8n — попросите администратора разрешить и установить Community Nodes.

Установка (через интерфейс n8n)

• Откройте Settings → Community Nodes
• Нажмите Install
• Введите имя пакета: n8n-nodes-teletype-app
• Подтвердите установку
• Перезапустите n8n (если попросит)

Настройка в Teletype (API Token + Webhook + события)

В Teletype вам нужно:

• взять API Token проекта
• указать Webhook URL (для событий)
• включить нужные события (галочки)

Авторизация в n8n (Credentials)

• Внутри любой ноды Teletype откройте Credentials
• Нажмите Create new
• Выберите Teletype API
• Вставьте API Token и сохраните

Webhook URL в Teletype — один на все события (важно)

В Teletype все события отправляются на один Webhook URL (в настройках Public API).

Это значит:

• Если вы хотите обрабатывать события в одном workflow — просто используйте один Teletype Trigger.
• Если вам нужно разнести обработку на несколько сценариев — лучше сделать один входной workflow с Trigger и дальше маршрутизировать события внутри n8n (Switch/IF), либо вызывать другие workflow через Execute Workflow.

Рекомендация: держите один Teletype Trigger как “входную точку”, а дальнейшую логику разносите по отдельным workflow.

Быстрый старт

1) Проверка Actions (без триггера)

• Создайте credential Teletype API
• Добавьте ноду Teletype
• Выберите нужный Resource и Operation
• Запустите workflow

2) Подключение Trigger (получение событий из Teletype)

• В n8n добавьте Teletype Trigger
• Откройте ноду Trigger и скопируйте Webhook URL:
  • Test URL — подходит для тестов, когда вы нажимаете “Listen for test event” в редакторе
  • Production URL — используется для реальных событий, когда workflow активирован (Activate)

• Вставьте нужный URL в Teletype:

  • для тестов можно использовать Test URL
  • для продакшена используйте Production URL (и обязательно активируйте workflow в n8n)

• В Teletype включите нужные события (галочки)

• Запустите проверку:

  • Тестовый режим: в n8n нажмите “Listen for test event”, затем отправьте сообщение в чат
  • Продакшен: нажмите “Activate” у workflow и отправьте сообщение в чат

Troubleshooting

Ноды не появились после установки

• Перезапустите n8n
• Проверьте, что установка community nodes разрешена в вашей сборке
• Посмотрите логи n8n: иногда там видно причину, почему пакет не загрузился

Trigger не ловит события

Проверьте по шагам:

• Проверьте, какой URL вы вставили в Teletype:

  • если workflow НЕ активирован, а вы ждёте реальные события — Production URL не будет работать как ожидается
  • если workflow активирован, но в Teletype стоит Test URL — события не будут доходить в прод-режиме

• Webhook URL настроен в Teletype (вставлен правильный адрес из Teletype Trigger)

• В Teletype включены нужные события (поставлены галочки на те события, которые вы ждёте)

• URL доступен из интернета:

  • HTTPS
  • без авторизации на уровне прокси / basic-auth
  • без блокировок firewall

• Откройте Executions в n8n и проверьте, приходят ли запросы на webhook

• Workflow в n8n активирован (Activate), если вы используете Production URL