Discord

Send Parseable alerts to Discord channels for team notifications and incident awareness.

Overview

Integrate Parseable with Discord to:

Server Notifications - Alert your team in dedicated channels
Rich Embeds - Send formatted messages with alert details
Bot Integration - Use Discord bots for advanced features
Mobile Alerts - Receive notifications on any device

Prerequisites

Discord server with admin access
Discord Webhook URL
Parseable instance with alerting configured

Setting Up Discord Webhook

Create a Webhook

Open Discord and go to your server
Navigate to the channel for alerts
Click Edit Channel (gear icon)
Go to Integrations → Webhooks
Click New Webhook
Name your webhook (e.g., "Parseable Alerts")
Copy the Webhook URL

Webhook Integration

Create a webhook service to transform Parseable alerts to Discord format:

// webhook-to-discord.js
const express = require('express');
const axios = require('axios');

const app = express();
app.use(express.json());

const DISCORD_WEBHOOK_URL = process.env.DISCORD_WEBHOOK_URL;

app.post('/webhook', async (req, res) => {
  const alert = req.body;
  
  const discordMessage = {
    username: "Parseable Alerts",
    avatar_url: "https://parseable.com/logo.png",
    embeds: [{
      title: `🚨 ${alert.name || 'Alert Triggered'}`,
      description: alert.message || `Alert triggered on dataset ${alert.dataset}`,
      color: getColor(alert.severity),
      fields: [
        {
          name: "Stream",
          value: alert.dataset || 'N/A',
          inline: true
        },
        {
          name: "Severity",
          value: alert.severity || 'Unknown',
          inline: true
        },
        {
          name: "Current Value",
          value: String(alert.value || 'N/A'),
          inline: true
        },
        {
          name: "Threshold",
          value: String(alert.threshold || 'N/A'),
          inline: true
        }
      ],
      timestamp: new Date().toISOString(),
      footer: {
        text: "Parseable Alert System"
      }
    }]
  };

  try {
    await axios.post(DISCORD_WEBHOOK_URL, discordMessage);
    res.status(200).json({ status: 'sent' });
  } catch (error) {
    console.error('Error sending to Discord:', error);
    res.status(500).json({ error: 'Failed to send to Discord' });
  }
});

function getColor(severity) {
  const colors = {
    'critical': 0xFF0000,  // Red
    'high': 0xFFA500,      // Orange
    'medium': 0xFFFF00,    // Yellow
    'low': 0x00FF00,       // Green
    'info': 0x0000FF       // Blue
  };
  return colors[severity?.toLowerCase()] || 0xFFA500;
}

app.listen(3000);

With Mentions

Add role or user mentions for critical alerts:

const discordMessage = {
  content: alert.severity === 'critical' ? '<@&ROLE_ID> Critical Alert!' : '',
  embeds: [{
    // ... embed content
  }]
};

Docker Compose

version: '3.8'
services:
  webhook-to-discord:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...

Configuration Options

Embed Colors

Severity	Color	Hex
critical	Red	0xFF0000
high	Orange	0xFFA500
medium	Yellow	0xFFFF00
low	Green	0x00FF00
info	Blue	0x0000FF

Best Practices

Use Dedicated Channels - Create separate channels for alerts
Role Mentions - Mention roles for critical alerts only
Rich Embeds - Use embeds for better formatting
Rate Limiting - Discord has rate limits, batch messages if needed

Next Steps

Set up Parseable alerts for automated notifications
Configure Slack as an alternative
Create dashboards for monitoring

Discord

On this page