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

Что мы создадим

Простой навык, который принимает текст и возвращает количество слов и символов. Это базовый пример, который покажет весь цикл работы.

Шаг 1: Создайте workflow в n8n

1.1 Откройте n8n

Если у вас ещё нет n8n:

• Облачная версия: n8n.cloud — быстрый старт без установки
• Self-hosted: Документация по установке

1.2 Создайте новый workflow

1. Нажмите "Create Workflow"
2. Назовите его, например, "Word Counter for Polydo"

1.3 Добавьте Webhook триггер

1. Нажмите "+" для добавления ноды

2. Найдите "Webhook" и выберите его

3. Настройте:

   • HTTP Method: POST
   • Path: /word-counter (или любой другой путь)
   • Response: "Immediately" (важно!)

4. Скопируйте Production URL — он понадобится позже

https://your-n8n.cloud/webhook/word-counter

Шаг 2: Добавьте логику обработки

2.1 Добавьте ноду Code

После Webhook добавьте ноду "Code" (JavaScript):

// Получаем данные из запроса
const inputData = $input.first().json;

// Извлекаем текст из входных данных
const text = inputData.body?.inputData?.text || '';

// Считаем статистику
const words = text.trim() ? text.trim().split(/\s+/).length : 0;
const characters = text.length;
const charactersNoSpaces = text.replace(/\s/g, '').length;

// Возвращаем результат
return [{
  json: {
    success: true,
    output: {
      words: words,
      characters: characters,
      charactersNoSpaces: charactersNoSpaces,
      text: text.substring(0, 100) + (text.length > 100 ? '...' : '')
    }
  }
}];

2.2 Добавьте HTTP Request для отправки результата

После Code добавьте ноду "HTTP Request":

1. Method: POST
2. URL: {{ $input.first().json.body.callbackUrl }}
3. Body Content Type: JSON
4. Body:

{
  "success": "{{ $json.success }}",
  "output": "{{ $json.output }}"
}

Или используйте Expression mode и передайте весь JSON:

{{ JSON.stringify($json) }}

Шаг 3: Активируйте workflow

1. Нажмите "Save"
2. Переключите "Inactive" → "Active"
3. Ваш webhook теперь готов принимать запросы

Шаг 4: Создайте навык на Polydo

4.1 Перейдите в Студию

1. Откройте Polydo
2. Нажмите "Создать навык"

4.2 Заполните основную информацию

4.3 Настройте Webhook URL

Вставьте Production URL из n8n:

https://your-n8n.cloud/webhook/word-counter

4.4 Определите входные параметры

Добавьте поле:

4.5 Определите выходные параметры

Шаг 5: Протестируйте навык

1. На странице создания нажмите "Тестировать"
2. Введите тестовый текст: "Привет, это тестовый текст!"
3. Нажмите "Запустить"
4. Проверьте результат:

{
  "words": 4,
  "characters": 28,
  "charactersNoSpaces": 24
}

Шаг 6: Отправьте на модерацию

Если тест прошёл успешно:

1. Нажмите "Отправить на модерацию"
2. Дождитесь одобрения (обычно 1-2 рабочих дня)
3. После одобрения навык появится в каталоге

Что дальше?

Поздравляем! Вы создали свой первый навык. Теперь можно:

• Изучить подробнее работу с webhooks
• Добавить обработку ошибок
• Настроить монетизацию

Полезные советы

Отладка

Если навык не работает:

1. Проверьте, что workflow активен в n8n
2. Посмотрите логи выполнения в n8n
3. Убедитесь, что callbackUrl используется корректно
4. Проверьте формат ответа (должен быть JSON с success и output)

Безопасность

• Не храните секреты в коде workflow
• Используйте переменные окружения n8n для API ключей
• Валидируйте входные данные

Производительность

• Ограничивайте время выполнения (рекомендуем до 30 секунд)
• Для длительных операций используйте асинхронную обработку
• Кэшируйте результаты где возможно