Notification Channels

Configure where and how you receive alert notifications and scheduled reports.

Available Channels

Email

Send notifications to individual email addresses or distribution lists. Supports HTML templates.

Slack

Post alerts to Slack channels with rich formatting, metric values, and direct links to dashboards.

Webhook

Send JSON payloads to custom endpoints for integration with PagerDuty, OpsGenie, or custom systems.

Microsoft Teams

Post alert cards to Teams channels using incoming webhooks.

Email Configuration

{
  "channel": "email",
  "config": {
    "recipients": [
      "analytics-team@company.com",
      "john.doe@company.com"
    ],
    "subject_template": "[{{severity}}] {{alert_name}}",
    "include_chart": true
  }
}

Slack Configuration

Create a Slack app at api.slack.com/apps
Enable Incoming Webhooks
Add a webhook to your desired channel
Copy the webhook URL

{
  "channel": "slack",
  "config": {
    "webhook_url": "https://hooks.slack.com/services/T00/B00/xxx",
    "channel": "#analytics-alerts",
    "mention_users": ["@oncall"],
    "include_chart_preview": true
  }
}

Webhook Configuration

{
  "channel": "webhook",
  "config": {
    "url": "https://your-endpoint.com/alerts",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer your-token",
      "Content-Type": "application/json"
    }
  }
}

// Webhook payload structure:
{
  "alert_id": "alt_abc123",
  "alert_name": "Low Revenue Alert",
  "severity": "critical",
  "status": "firing",
  "metric_name": "daily_revenue",
  "current_value": 8500,
  "threshold": 10000,
  "triggered_at": "2024-01-15T10:30:00Z",
  "dashboard_url": "https://app.lucaro.dev/dashboards/..."
}

Recipient Groups

Create groups to easily manage notification recipients:

curl -X POST "https://api.lucaro.dev/v2/recipient-groups" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Analytics Team",
    "members": [
      {"email": "alice@company.com"},
      {"email": "bob@company.com"},
      {"email": "charlie@company.com"}
    ]
  }'