Discord

Datafly Signal posts real-time notifications to a Discord channel using an Incoming Webhook. When a notify-worthy event happens on your site — an order, a sign-up, a new lead — Signal sends a message to your channel server-to-server. There is no client-side script and no bot to host.

Prerequisites

You need Manage Webhooks permission on the Discord server (guild) where you want notifications to land.

https://discord.com/api/webhooks/123456789012345678/aBcDeFgHiJkLmNoPqRsTuVwXyZ...

Configure in Signal

Configuration Fields

Management UI Setup

1. Go to Integrations > Add Integration > Discord.
2. Choose the Default preset.
3. Paste your webhook_url.
4. Click Save.

The Default preset notifies on Order Completed, Signed Up, and Lead Generated. All other events (page views, product views, etc.) are dropped so they don’t flood the channel. To notify on more events, edit the integration’s Field Mappings in the Management UI.

API Endpoint

Signal delivers each event with the Discord Execute Webhook endpoint:

POST https://discord.com/api/webhooks/{webhook.id}/{webhook.token}

The webhook id and token come from the webhook_url you configured — Signal posts the JSON body directly to that URL. Authorization is the token in the URL; there is no separate API key or header. A successful send returns 204 No Content.

Identity Signals

Discord is a channel notification surface, so Signal does not send user identity signals (no email, phone, IP, or hashed PII) and does not apply consent gating. Only the event details you map into the message and embed are sent. If you want to include a user reference (for example an order’s customer name), map it explicitly into an embed field in your blueprint — and only do so if your channel’s audience is permitted to see it.

Event Mapping

Default preset

Each event builds a plain-text content message plus a rich embed (a card with a title, colour, and detail fields). Discord limits content to 2000 characters and the combined text across all embeds to 6000 characters.

Example: Order notification

Datafly.js call:

datafly.track("Order Completed", {
  order_id: "ORD-001",
  revenue: 129.99,
  currency: "GBP"
});

Discord payload sent by Signal:

{
  "username": "Datafly Signal",
  "content": "🛒 New order **ORD-001** — 129.99 GBP",
  "embeds": [
    {
      "title": "Order Completed",
      "color": 5814783,
      "fields": [
        { "name": "Order ID", "value": "ORD-001" },
        { "name": "Revenue", "value": "129.99" },
        { "name": "Currency", "value": "GBP" }
      ]
    }
  ]
}

This appears in the channel as a message from “Datafly Signal” with a coloured embed card listing the order details.

Testing

1. Create a throwaway webhook in a private test channel and paste its URL into a test Signal integration.
2. Trigger an Order Completed event on your site (or replay one from Signal’s event debugger).
3. Confirm the message appears in the test channel within a second or two.
4. Inspect the embed fields to verify your mappings produced the values you expect.
5. When satisfied, point the integration at the real channel’s webhook URL.

Troubleshooting