Подключение приложений
Большинство узлов требуют подключения к внешним сервисам (Gmail, Google Sheets, CRM, Telegram). Разберёмся как это делается.
Типы подключений
Plug-and-Play узлы (без подключения)
Некоторые узлы работают сразу - без ключей API и авторизации:
- ИИ-узлы: Perplexity, ChatGPT, Claude (встроенные кредиты Nodul)
- Утилиты: Code (JavaScript/Python), HTTP Request, Transform Data
- Расписание: Schedule, Delay, Wait
Plug-and-Play узлы используют кредиты Nodul. Вам не нужны свои ключи API.
OAuth приложения (авторизация через браузер)
Большинство популярных приложений используют OAuth - вы авторизуетесь через их интерфейс.
Примеры:
- Gmail, Google Sheets, Google Drive
- Notion, Airtable
- Slack, Telegram
- Facebook, Instagram
- Shopify, WooCommerce
API Key приложения (ключ API)
Некоторые приложения требуют ввода API-ключа вручную.
Примеры:
- OpenAI (если хотите использовать свой ключ)
- Anthropic (Claude с вашим ключом)
- Stripe, PayPal
- Mailchimp, SendGrid
Как подключить OAuth приложение
Разберём на примере Gmail.
Шаг 1 - Добавление узла
- Создайте или откройте сценарий
- Добавьте узел Gmail (например, триггер "New Email")
Шаг 2 - Создание подключения
- Откройте настройки узла Gmail
- Вы увидите кнопку "Create Authorization" (Создать авторизацию)
- Нажмите "Create Authorization"
Шаг 3 - OAuth авторизация
- Появится окно выбора сервиса
- Нажмите "New Authorization" (Новая авторизация)
- В списке выберите "Gmail"
- Откроется окно авторизации Google
- Выберите аккаунт Google
- Нажмите "Разрешить" (Allow) - дайте Nodul доступ к Gmail
Шаг 4 - Проверка подключения
- Вернитесь в Nodul
- В узле Gmail в поле "Connection" теперь отображается ваше подключение
- Появились поля настройки узла (Labels, Search и т.д.)
Готово! Gmail подключён. Теперь можете настраивать узел и использовать его в сценарии.
Как подключить приложение с API-ключом
Разберём на примере OpenAI (если хотите использовать свой ключ вместо встроенного).
Шаг 1 - Получение API-ключа
- Перейдите на сайт сервиса (например, platform.openai.com)
- Зайдите в раздел API Keys
- Нажмите "Create new secret key"
- Скопируйте ключ (он показывается один раз!)
Сохраните ключ сразу! Большинство сервисов показывают его только один раз. Если потеряете - придётся создавать новый.
Шаг 2 - Ввод ключа в Nodul
- В узле OpenAI нажмите "Create Authorization"
- Выберите "API Key" (или "OpenAI")
- Вставьте скопированный ключ в поле "API Key"
- Нажмите "Save"
- Подключение создано! Теперь узел будет использовать ваш ключ
Управление подключениями
Просмотр всех подключений
- Откройте меню "Settings" (Настройки) или "Connections" (Подключения)
- Вы увидите список всех созданных авторизаций
Переиспользование подключений
Когда добавляете новый узел того же сервиса (например, второй узел Gmail), подключение выбирается автоматически.
Пример:
- Создали узел Gmail (New Email) → подключили Gmail
- Добавили узел Gmail (Send Email) → подключение уже выбрано автоматически
Одно подключение = все узлы сервиса. Не нужно авторизоваться заново для каждого узла.
Удаление подключения
- Откройте список подключений
- Найдите нужное подключение
- Нажмите иконку удаления (корзина)
- Подтвердите удаление
При удалении подключения сценарии, которые его используют, перестанут работать! Удаляйте только если уверены.
Частые проблемы
❌ "OAuth окно не открывается"
Причина: Браузер блокирует всплывающие окна.
Решение:
- Разрешите всплывающие окна для Nodul в настройках браузера
- Попробуйте снова
❌ "Нет нужного приложения в списке"
Причина: Nodul пока не поддерживает это приложение напрямую.
Решение:
- Используйте узел HTTP Request для работы с API приложения
- Или попросите поддержку Nodul добавить интеграцию
❌ "Connection expired" (Подключение устарело)
Причина: OAuth-токены имеют срок действия. Некоторые приложения требуют переавторизацию.
Решение:
- Откройте узел с ошибкой
- Нажмите "Reconnect" (Переподключить)
- Пройдите авторизацию заново
❌ "У меня нет прав доступа к этому приложению"
Причина: Ваш аккаунт не имеет нужных прав (например, вы не админ Slack workspace).
Решение:
- Попросите администратора дать вам права
- Или попросите администратора создать подключение и поделиться им с вами
Безопасность подключений
Где хранятся данные?
Nodul хранит OAuth-токены и API-ключи в зашифрованном виде на серверах. Они не передаются третьим лицам.
Можно ли поделиться подключением?
Да, если вы работаете в команде:
- Создайте подключение
- В настройках подключения включите "Share with team"
- Члены команды смогут использовать это подключение
Будьте осторожны с шарингом! Все, кто имеют доступ к подключению, могут использовать его в своих сценариях.
Что дальше?
Теперь вы знаете как подключать приложения. Следующий шаг - научиться передавать данные между узлами:
Или вернитесь к основам: