Nodul LogoNodul

Тестирование

Перед публикацией сценария обязательно проверьте его работу. Иначе можете отправить 100 сообщений в чат, удалить данные или сломать интеграцию.


Почему это важно

Что может пойти не так:

❌ Сценарий отправляет уведомления не тем людям
❌ Данные записываются в неправильную таблицу
❌ ИИ генерирует некорректный текст
❌ Узел падает с ошибкой из-за неправильных настроек
❌ Сценарий запускается слишком часто и тратит кредиты

Правило:

Всегда тестируйте перед публикацией! Запустите сценарий вручную, проверьте каждый узел, убедитесь что всё работает как надо.


Способы тестирования

1. Run Once (Запустить один раз)

Самый простой способ - запустить весь сценарий целиком.

Как:

  1. Нажмите кнопку "Run Once" в правом верхнем углу
  2. Сценарий выполнится от триггера до последнего узла
  3. Все узлы подсветятся статусами:
    • 🟡 Жёлтый - выполняется
    • 🟢 Зелёный - успешно
    • 🔴 Красный - ошибка
  1. Проверьте результаты:
    • Кликайте на каждый узел
    • Смотрите что он вернул
    • Убедитесь что данные правильные

"Run Once" использует реальные данные. Если триггер - "Новое письмо", он возьмёт последнее письмо из почты.


2. Run Node Once (Запустить один узел)

Можно запустить только один конкретный узел - для отладки.

Как:

  1. Кликните правой кнопкой на узле
  2. Выберите "Run Node Once"
  3. Только этот узел выполнится

Когда использовать:

  • Настраиваете один узел и хотите проверить его отдельно
  • Предыдущие узлы уже выполнены (зелёные), не хотите запускать их снова
  • Отлаживаете проблемный узел

3. Manual Trigger (Ручной триггер)

Некоторые триггеры (например, Webhook, Manual Trigger) позволяют отправить тестовые данные вручную.

Пример с Webhook:

  1. Откройте узел Webhook
  2. Скопируйте URL вебхука
  3. Отправьте тестовый запрос через Postman, curl или браузер
  4. Сценарий запустится с этими данными

Пример с Manual Trigger:

  1. Добавьте триггер Manual Trigger вместо реального
  2. В настройках укажите тестовые данные (JSON)
  3. Запускайте сценарий с этими данными

Проверка результатов

Смотрим данные узла

После выполнения узла:

  1. Кликните на узел (левой кнопкой)
  2. Справа откроется панель с результатами
  3. Проверьте:
    • Input - что узел получил
    • Output - что узел вернул
    • Execution time - сколько времени выполнялся

Проверяем логи

Если узел упал с ошибкой:

  1. Кликните на красный узел
  2. Перейдите на вкладку "Logs" (или "Error")
  3. Прочитайте сообщение об ошибке

Частые ошибки:

  • Undefined field - поле не существует
  • Authorization failed - проблема с подключением
  • Rate limit exceeded - превышен лимит запросов
  • Invalid format - неправильный формат данных

Проверяем внешние системы

После запуска сценария проверьте внешние системы:

Если сценарий отправляет Email:

  • Откройте почту, проверьте что письмо пришло
  • Проверьте тему, текст, отправителя

Если сценарий пишет в Google Sheets:

  • Откройте таблицу, проверьте что строка добавилась
  • Проверьте значения в колонках

Если сценарий отправляет в Telegram:

  • Откройте Telegram, проверьте что сообщение пришло
  • Проверьте текст, форматирование

Если всё работает как ожидается - готово к публикации! Если нет - читайте дальше про отладку.


Отладка ошибок

Шаг 1 - Найдите проблемный узел

Красный узел = ошибка. Кликните на него и читайте сообщение.


Шаг 2 - Читайте ошибку внимательно

Пример ошибки:

Error: Field 'email' is undefined

Что это значит:

Вы пытаетесь использовать поле email, но его нет в данных предыдущего узла.

Решение:

  1. Посмотрите результаты предыдущего узла
  2. Проверьте какие поля он возвращает
  3. Может поле называется по-другому? (e-mail, userEmail, contact_email)
  4. Исправьте название поля

Шаг 3 - Исправляйте по одной ошибке

Не пытайтесь исправить всё сразу. Исправьте одну ошибку, запустите снова, проверьте.

Цикл отладки:

  1. Запустить → ошибка
  2. Прочитать ошибку
  3. Исправить
  4. Запустить снова
  5. Повторять пока не заработает

Частые ошибки и решения

❌ "Узел выполняется бесконечно"

Причина: Узел ждёт внешнего события (например, вебхук) или завис.

Решение:

  • Остановите выполнение (кнопка Stop)
  • Проверьте настройки узла
  • Возможно, нужно отправить тестовые данные

❌ "Все узлы зелёные, но результат неправильный"

Причина: Узлы работают, но логика сценария неправильная.

Решение:

  • Проверьте данные каждого узла
  • Возможно, условие в If настроено неправильно
  • Возможно, данные передаются не те

❌ "Ошибка авторизации (Authorization failed)"

Причина: Подключение устарело или неправильно настроено.

Решение:

  1. Откройте узел с ошибкой
  2. Проверьте подключение (Connection)
  3. Нажмите "Reconnect" если нужно
  4. Пройдите авторизацию заново

❌ "Первый узел работает, второй падает"

Причина: Данные из первого узла переданы неправильно.

Решение:

  1. Посмотрите результат первого узла
  2. Проверьте что второй узел ссылается на правильные поля
  3. Возможно, нужно трансформировать данные (Code узел)

Тестовые данные

Создайте тестовый аккаунт

Для тестирования создайте отдельные тестовые аккаунты/объекты:

  • Gmail: Тестовый email для проверки писем
  • Google Sheets: Тестовая таблица
  • Telegram: Тестовый чат
  • CRM: Тестовый контакт/сделка

Не тестируйте на продакшн данных! Можете случайно удалить или изменить реальные данные.


Используйте Manual Trigger

Вместо реального триггера (Gmail, Webhook) используйте Manual Trigger с тестовыми данными.

Пример:

{
  "email": "[email protected]",
  "name": "Тестовый Пользователь",
  "amount": 50000
}

Так вы контролируете входные данные и можете тестировать разные сценарии.


История выполнений

После запуска сценария (вручную или автоматически) результат сохраняется в истории.

Как посмотреть:

  1. Откройте сценарий
  2. Перейдите на вкладку "Executions" (Выполнения)
  3. Вы увидите список всех запусков

Что показывает история:

  • Дата и время запуска
  • Статус (успех, ошибка)
  • Длительность выполнения
  • Результаты каждого узла

Когда использовать:

  • Проверить выполнялся ли сценарий автоматически
  • Найти ошибки в прошлых запусках
  • Сравнить результаты разных выполнений

Чек-лист перед публикацией

Перед тем как нажать "Publish", проверьте:

  • Запустили сценарий вручную (Run Once)
  • Все узлы выполнились успешно (зелёные)
  • Проверили результаты каждого узла
  • Проверили внешние системы (почта, таблицы, чаты)
  • Протестировали на тестовых данных (не на продакшене)
  • Ошибок нет, результат правильный

Если все галочки стоят - можно публиковать!


Что дальше?

Теперь вы знаете как тестировать сценарии. Следующий шаг - научиться публиковать и запускать их в продакшн:

Публикация

Или вернитесь к основам:

Создание первого сценария