🎮 Discord Integration

Connect Datix xAgents to Discord to receive notifications, run queries, and collaborate with your community.

Overview

Discord Integration enables:

Real-time notifications in Discord channels
Run queries using bot commands
Share data insights with community
Agent execution alerts
Workflow completion notifications
Interactive embeds with rich formatting

📦 Plan Requirement

Discord Integration is available in Growth plan and above.

Setup

1. Create Discord Bot

Go to Discord Developer Portal
Click "New Application"
Name: "Datix xAgents Bot"
Go to "Bot" section
Click "Add Bot"
Copy the Bot Token

2. Configure Bot Permissions

Required permissions:

Permissions:
- Read Messages/View Channels
- Send Messages
- Send Messages in Threads
- Embed Links
- Attach Files
- Read Message History
- Use Slash Commands
            

Permission Integer: 326417525824

3. Enable Intents

In Bot settings, enable:

✅ Presence Intent
✅ Server Members Intent
✅ Message Content Intent

4. Invite Bot to Server

Generate OAuth2 URL:

https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=326417525824&scope=bot%20applications.commands
            

Go to "OAuth2 → URL Generator"
Select scopes: bot and applications.commands
Select permissions listed above
Copy generated URL
Open URL in browser
Select server and authorize

5. Configure in Datix xAgents

Navigate to Settings → Integrations
Click "Add Integration"
Select "Discord"
Paste Bot Token
Enter Server ID and default Channel ID
Click "Save"

POST /api/integrations
{
    "provider": "discord",
    "config": {
        "bot_token": "your-bot-token",
        "server_id": "123456789012345678",
        "default_channel_id": "987654321098765432",
        "notify_query_completion": true,
        "notify_agent_execution": true,
        "notify_workflow_completion": true
    }
}
            

Features

Notifications

Receive embeds for:

Query Completion: When queries finish
Agent Execution: Autonomous agent results
Workflow Completion: Workflow status updates
Anomaly Detection: AI insights found
Approval Requests: Actions needing approval
Error Alerts: Failed executions

Rich Embeds

Notifications use Discord's rich embed format:

{
    "embeds": [{
        "title": "📊 Query Completed",
        "description": "Monthly Sales Analysis",
        "color": 5814783,
        "fields": [
            { "name": "Status", "value": "✅ Success", "inline": true },
            { "name": "Rows", "value": "1,247", "inline": true },
            { "name": "Duration", "value": "3.2s", "inline": true }
        ],
        "footer": { "text": "Datix xAgents" },
        "timestamp": "2024-01-10T15:30:00Z"
    }]
}
            

Bot Commands

Run queries from Discord:

!datix query What were our top products last month?
!datix status Check status of agent #123
!datix template Run monthly report template
!datix help Show available commands
            

Slash Commands

Modern Discord slash commands:

/datix query question:[your question]
/datix status agent_id:123
/datix template template_id:456
/datix help
            

Configuration Options

Channel Routing

Send different notifications to different channels:

{
    "channels": {
        "query_completion": "987654321098765432",
        "agent_execution": "876543210987654321",
        "anomaly_detection": "765432109876543210",
        "errors": "654321098765432109",
        "approvals": "543210987654321098"
    }
}
            

Notification Filters

Control what gets sent to Discord:

Minimum Duration: Only notify for queries >30s
Query Types: Only multi-database queries
Priority Only: High-priority agents only
Error Level: Only critical errors

Embed Customization

Customize embed appearance:

Color: Different colors for different statuses
Thumbnail: Add custom bot avatar
Footer: Custom footer text
Author: Show who triggered action

{
    "embed_colors": {
        "success": 5814783,    // Green
        "warning": 16776960,   // Yellow
        "error": 15158332,     // Red
        "info": 3447003        // Blue
    }
}
            

Interactive Components

Buttons

Embeds include action buttons:

{
    "components": [{
        "type": 1,
        "components": [
            {
                "type": 2,
                "style": 5,
                "label": "View Results",
                "url": "https://app.datixlab.com/queries/123"
            },
            {
                "type": 2,
                "style": 1,
                "label": "Approve",
                "custom_id": "approve_action_456"
            },
            {
                "type": 2,
                "style": 4,
                "label": "Reject",
                "custom_id": "reject_action_456"
            }
        ]
    }]
}
            

Dropdown Menus

For selecting from options:

Select template to execute
Choose data source
Pick time range

Approval Workflows

Approve Actions in Discord

When an agent requires approval:

Embed sent to approvals channel
Shows action details with context
Buttons: "Approve" or "Reject"
Click button to respond
Agent continues based on response
Updates embed to show decision

Query Results

Result Preview in Embeds

Discord embeds show data preview:

First 5 rows in field format
Total row count
Key metrics highlighted
Link to full results

File Attachments

Send result data as files:

CSV export attached to message
Chart images from visualizations
PDF reports

POST /api/integrations/discord/notify
{
    "channel_id": "987654321098765432",
    "message": "Daily report completed",
    "file_path": "/exports/daily_report.csv",
    "embed": {...}
}
            

Role Mentions

Notify Specific Roles

Tag roles in notifications:

{
    "content": "<@&role_id> Anomaly detected!",
    "allowed_mentions": {
        "roles": ["123456789012345678"]
    }
}
            

User Mentions

Mention specific users:

Map Datix users to Discord users
By username or email
Manual mapping in settings

Webhooks

Discord Webhooks

Alternative to bot - simpler setup:

Right-click channel → Edit Channel
Go to Integrations → Webhooks
Click "New Webhook"
Name: "Datix Notifications"
Copy Webhook URL
Add to Datix integration settings

POST https://discord.com/api/webhooks/ID/TOKEN
{
    "username": "Datix xAgents",
    "avatar_url": "https://datixlab.com/logo.png",
    "embeds": [{
        "title": "Query Completed",
        "description": "Results are ready",
        "color": 5814783
    }]
}
            

Webhook vs Bot

Webhooks:

✅ Simpler setup
✅ No permissions needed
❌ One-way only (send messages)
❌ No commands

Bot:

✅ Two-way interaction
✅ Commands and slash commands
✅ Button interactions
❌ More complex setup

Best Practices

Dedicated Channels: Create separate channels for different notification types
Role Mentions: Use role mentions sparingly to avoid spam
Use Threads: Keep main channel clean by using threads
Rich Embeds: Use embeds for better formatting and readability
Files for Large Data: Attach CSV instead of embedding large datasets
Test Channel: Use a test channel before production

⚠️ Token Security

Keep your Bot Token secret. Never share it publicly or commit to version control. Regenerate if exposed.

Troubleshooting

Bot Not Responding

Verify bot has correct permissions
Check bot is online (green status)
Ensure Message Content Intent is enabled
Check token is valid

Messages Not Appearing

Verify channel ID is correct
Check bot can see channel
Ensure "Send Messages" permission
Check integration status in Datix

Slash Commands Not Working

Wait up to 1 hour for commands to sync
Kick and re-invite bot
Verify applications.commands scope
Check bot has slash command permissions

Common Errors

50001: Missing Access
  → Bot cannot see channel

50013: Missing Permissions
  → Bot lacks required permissions

10008: Unknown Message
  → Message deleted or doesn't exist

40060: Interaction Already Acknowledged
  → Don't respond to interaction twice
            

Rate Limits

Discord enforces rate limits:

Messages: 5 per 5 seconds per channel
Embeds: Unlimited (same as messages)
Files: Max 8MB per file (25MB with Nitro)
Global: 50 requests per second
Datix automatically handles rate limiting

Advanced Features

Scheduled Messages

Send recurring reports:

Daily digest at 9 AM
Weekly summary every Monday
Monthly reports on 1st of month

Conditional Notifications

Only notify when conditions met:

Sales drop >10%
Query takes >1 minute
Anomaly confidence >90%

Thread Management

Organize notifications in threads:

One thread per workflow
One thread per agent
Archive old threads automatically

Permissions

To configure Discord integration:

Admin role in Datix xAgents
Manage Server permission in Discord
Growth plan or above

💡 Need Help?

Having trouble setting up Discord integration? Check our video tutorial or contact support.

← Previous: Slack Integration Documentation Home →