Slack Integration

Receive real-time backup notifications directly in your Slack workspace. Get instant alerts for backup completions, failures, security events, and health warnings.

v1.0.0Updated 2026-01-01

Features

Real-time notifications via Slack webhooks
Rich message formatting with Slack Block Kit
Customizable event types (success, failures, security alerts)
Channel override for routing to specific channels
Interactive buttons for quick actions
Test webhook before saving configuration

Quick Setup

Step 1: Create Slack Webhook

Go to api.slack.com/apps
Click "Create New App" → "From scratch"
Name it "LOX Backups" and select your workspace
Go to "Incoming Webhooks" in the sidebar
Toggle "Activate Incoming Webhooks" to On
Click "Add New Webhook to Workspace"
Select the channel for notifications and click "Allow"
Copy the webhook URL (starts with https://hooks.slack.com/...)

Step 2: Configure in LOX

Go to Settings → Notifications in your LOX dashboard
Paste your Slack webhook URL
Select which events you want to receive
Click "Test Webhook" to verify it works
Enable the integration and save

Pro Tip

Create a dedicated #lox-backups channel to keep backup notifications organized and easy to monitor.

Event Types

Event	Description
backup_completed	Backup finished successfully
backup_failed	Backup failed with error
verification_passed	Backup integrity verified
verification_failed	Backup verification failed
quarantine	Backup quarantined (malware/threat detected)
health_warning	Health score dropped below threshold
restore_ready	Backup is ready for download/restore

API Configuration

You can also configure Slack notifications via the API:

Get Current Configuration

curl -X GET "https://backlox.com/api/v1/notifications/slack" \
  -H "Authorization: Bearer ${LOX_API_KEY}"

Update Configuration

curl -X PUT "https://backlox.com/api/v1/notifications/slack" \
  -H "Authorization: Bearer ${LOX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://hooks.slack.com/services/T.../B.../...",
    "channel": "#lox-backups",
    "enabled": true,
    "events": ["backup_completed", "backup_failed", "quarantine", "health_warning"]
  }'

Test Webhook

curl -X POST "https://backlox.com/api/v1/notifications/slack/test" \
  -H "Authorization: Bearer ${LOX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://hooks.slack.com/services/T.../B.../...",
    "channel": "#lox-backups"
  }'

Message Examples

Backup Completed

:white_check_mark: Backup Completed

Backup: wordpress-daily-20251225

Size: 156.42 MB

Status: completed

Distributed: Yes

UUID: abc123... | Tenant: My Company

Quarantine Alert

:biohazard_sign: Backup Quarantined

:rotating_light: Security Alert

Backup suspicious-file-20251225 has been quarantined.

Reason: Malware detected (Eicar-Test-Signature)

Malware Scan: Failed

Integrity Check: Passed

Tenant: My Company | Action Required: Review this backup immediately

Health Warning

:warning: Health Score Warning

Your backup health score has dropped to 65/100

Issues Detected:

No backup in last 48 hours
Storage usage at 85%

View Dashboard

Best Practices

Avoid notification fatigue

Consider only enabling failure and security events in production. Backup completed events can be noisy for frequent backups.

Use dedicated channels

Route LOX notifications to a dedicated channel like #ops-backupsor #alerts-lox.

Keep webhook URL secure

Treat your webhook URL like a password. Anyone with the URL can post to your channel. Rotate it if compromised.

Troubleshooting

Messages not appearing

Verify the webhook URL is correct and the Slack app is still active. Use the test endpoint to verify connectivity.

channel_not_found error

The channel override you specified doesn't exist or the bot doesn't have access. Make sure to include the # prefix.

Rate limits

Slack webhooks have rate limits (1 message per second). LOX batches notifications to avoid hitting limits.

← Docker MySQL Agent →