notification-sender

Custom n8n node for sending predefined notification events to Integration Service via HTTP API

Package Information

Downloads: 1,281 weekly / 1,281 monthly
Latest Version: 1.0.12
Author: progredis

Documentation

Notification Event Sender — n8n Custom Node

Кастомный компонент для n8n, который позволяет отправлять уведомления в Integration Service через HTTP API.


📦 Установка

Способ 1: Через npm (рекомендуется)

npm install @progredis/n8n-nodes-notification-sender@latest

Способ 2: Через UI

  1. Откройте n8n → SettingsWorkflowManage
  2. Нажмите "Import .js file"
  3. Выберите файл dist/index.js из собранного пакета
  4. Поставьте галочку "Use this node definition"
  5. Сохраните

🎯 Использование в Workflow

{
  "name": "Отправка уведомления",
  "nodes": [
    {
      "parameters": {},
      "id": "trigger-node"
    },
    {
      "parameters": {
        "message": ["Ошибка выполнения интеграции: неверные данные для авторизации"]
      },
      "type": "n8n-nodes-notification-sender.notificationEventSender",
      "position": [300, 240]
    }
  ],
  "connections": {}
}

📋 Параметры ноды

Параметр Тип Описание Обязательный Пример
Message* String Сообщение для отправки в Integration Service Да Ошибка выполнения интеграции: неверные данные для авторизации

* — обязательный параметр


🔗 Интеграция с Integration Service

Endpoint:

POST /api/v1/notifications/send

Пример запроса:

curl -X POST "http://integration-service.local/api/v1/notifications/send" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Ошибка выполнения интеграции: неверные данные для авторизации"
  }'

# Ожидается ответ:
# {
#   "status": "success"
# }

Архитектура:

┌─────────────┐     ┌──────────────────────────┐     ┌─────────────┐
│   n8n       │────>│ Notification Event Sender│────>│  Integration│
│   Workflow   │     │      (Custom Node)      │     │  Service    │
└─────────────┘     └──────────────────────────┘     └─────────────┘
                                                         ↓
                                                  HTTP API: POST /api/v1/notifications/send

Настройка окружения для Integration Service:

Добавьте в Deployment YAML для n8n:

env:
  - name: INTEGRATION_SERVICE_URL
    value: "http://integration-service.local/api/v1/notifications/send"

Или через ConfigMap:

apiVersion: v1
kind: ConfigMap
metadata:
  name: n8n-config
  namespace: pp
data:
  INTEGRATION_SERVICE_URL: "http://integration-service.local/api/v1/notifications/send"

🐛 Отладка и логирование

Проверка отправки событий через curl

curl -X POST "http://integration-service.local/api/v1/notifications/send" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Тестовое сообщение"
  }'

# Ожидается ответ:
# {
#   "status": "success"
# }

Проверка логов в Integration Service

tail -f /var/log/dataserver/integration-service.log | grep "notification-event"

📞 Поддержка

  • GitHub Issues: [progredis/notification-sender-node-docs](TODO: добавить)

Discussion