Discord Webhook

Discord Webhook Notification

Send messages to Discord channels via webhook HTTP POST. Supports plain text and rich Embed format with multi-webhook routing.

Overview

Discord webhooks accept JSON payloads via HTTP POST. This skill handles:

1. Resolve webhook URL from environment variables or settings file
2. Format the message as plain text (content) or rich Embed
3. Send via HTTP POST using curl

Step 1: Resolve Webhook URL

Before resolving, source the project .env file if it exists:

[ -f .env ] && source .env

Then check environment variables:

1a: Named Webhook (when a target name is specified)

Look for environment variable DISCORD_WEBHOOK_{NAME} where {NAME} is the uppercase target name:

# Examples:
# Target "deploy" → DISCORD_WEBHOOK_DEPLOY
# Target "alerts" → DISCORD_WEBHOOK_ALERTS

1b: Default Webhook

Look for environment variable DISCORD_WEBHOOK_URL.

Error Handling

If no webhook URL is found, inform the user:

No Discord webhook URL configured. Add to your .env file:

DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/your/webhook

For named targets, use DISCORD_WEBHOOK_{NAME} (e.g., DISCORD_WEBHOOK_DEPLOY).

Do NOT proceed without a valid webhook URL.

Step 2: Format the Message

Plain Text

For simple string messages, use the content field:

{
  "content": "Deploy v1.2.3 completed successfully"
}

content has a 2000 character limit. Truncate with … if exceeded.

Embed Format

For structured information (deploy reports, error alerts, build status), use the embeds array:

{
  "embeds": [{
    "title": "Deploy Complete",
    "description": "Version **v1.2.3** deployed to production",
    "color": 3066993,
    "fields": [
      { "name": "Environment", "value": "production", "inline": true },
      { "name": "Duration", "value": "2m 34s", "inline": true }
    ],
    "footer": { "text": "Deployed by Claude Code" },
    "timestamp": "2026-04-10T12:00:00.000Z"
  }]
}