Notifications

Multi-channel notification hub for XActions alerts. Send notifications via Email, Slack, Discord, and Telegram when events occur — follower changes, workflow completions, scheduled job results, and more.

Architecture

src/notifications/
└── notifier.js   # Multi-channel notification sender

Configuration: ~/.xactions/config.json under the notifications key.

Quick Start

Node.js

import { Notifier } from 'xactions/src/notifications/notifier.js';

const notifier = new Notifier();
await notifier.load();  // Load config from ~/.xactions/config.json

// Configure channels
notifier.configure({
  email: { enabled: true, to: 'you@example.com', smtp: { host: 'smtp.gmail.com', port: 587, user: '...', pass: '...' } },
  slack: { enabled: true, webhookUrl: 'https://hooks.slack.com/services/...' },
  discord: { enabled: true, webhookUrl: 'https://discord.com/api/webhooks/...' },
  telegram: { enabled: true, botToken: '...', chatId: '...' }
});

// Send a notification
await notifier.send({
  type: 'follower_alert',
  title: 'Unfollower Detected',
  message: '@user123 unfollowed you',
  data: { username: 'user123', action: 'unfollow' },
  severity: 'warning'  // info | warning | critical
});

CLI

xactions notify send "Test notification" --title "Hello" --severity info
xactions notify test slack
xactions notify configure

REST API

Routes prefixed with /api/notifications. Requires authentication.

Send a notification

curl -X POST http://localhost:3001/api/notifications/send \
  -H "Content-Type: application/json" \
  -d '{"message": "5 new unfollowers detected", "title": "Unfollower Alert", "severity": "warning"}'

Test a channel

curl -X POST http://localhost:3001/api/notifications/test/slack

Channels

Email

{
  email: {
    enabled: true,
    to: 'you@example.com',
    from: 'xactions@example.com',     // optional
    smtp: {
      host: 'smtp.gmail.com',
      port: 587,
      user: 'your-email@gmail.com',
      pass: 'app-password'
    }
  }
}

Slack

{
  slack: {
    enabled: true,
    webhookUrl: 'https://hooks.slack.com/services/T.../B.../xxx'
  }
}

Create a webhook at api.slack.com/apps → Incoming Webhooks.

Discord

{
  discord: {
    enabled: true,
    webhookUrl: 'https://discord.com/api/webhooks/123/abc'
  }
}

Create a webhook in Discord → Server Settings → Integrations → Webhooks.

Telegram

{
  telegram: {
    enabled: true,
    botToken: '123456:ABC-DEF',
    chatId: '-1001234567890'
  }
}

Create a bot via @BotFather. Get your chat ID by messaging the bot and checking /getUpdates.

Severity Levels

Integration with Other Modules

Notifications integrate with:

• Streams — Alert on follower changes, new mentions
• Workflows — Notify on step completion/failure
• Scheduler — Report job execution results
• Bulk operations — Summary after batch completes

Workflow Step Example

{
  action: 'send_notification',
  params: {
    title: 'Workflow Complete',
    message: 'Found {{steps.0.result.count}} new leads',
    severity: 'info'
  }
}