getting-started

Your first Outbound Webhook (Discord channel for Smart Trade events)

Push real bot events from haythix to a Discord channel in 10 minutes

15 min · beginner

What you'll have when finished

  • Have one Discord webhook firing real Smart Trade events into your server
  • Know how to test deliveries end-to-end
  • Understand the HMAC signature note for Discord/Slack/Telegram

Before you start

  • Failed deliveries do NOT auto-retry — if your receiver is down you miss events. Critical events should also have in-app notification redundancy
  • Subscribing with "*" can flood your Slack/Discord channel — start with specific high-signal events
  • Discord / Slack / Telegram do NOT verify HMAC — the secret is purely defensive for those

Walkthrough

  1. Get a Discord webhook URL from your server

    In Discord, open Server Settings → Integrations → Webhooks → New Webhook. Name it "haythix events". Pick the channel where you want events to appear. Click Copy Webhook URL. The URL looks like discord.com/api/webhooks/12345/abcdef... — keep this private.

    Success criteria: You have a Discord webhook URL copied to clipboard

  2. Open Outbound Webhooks + click New Webhook

    Discover → Outbound Webhooks. Click the cyan New Webhook button top-right. Create form opens.

    Success criteria: Create form is visible

  3. Name it + paste the Discord URL

    Name = "Discord Smart Trade alerts". URL = paste the Discord webhook URL. As you paste, the page detects "discord.com/api/webhooks" and auto-switches Format to Discord. No manual format change needed.

    Success criteria: Format option = Discord is highlighted AND URL field shows your Discord webhook URL

  4. Subscribe to Smart Trade events only

    Event picker → Smart Trade group → tick specific events: smart_trade.entry_filled, smart_trade.tp_filled, smart_trade.sl_filled. DO NOT use "*" yet — Smart Trade can fire 5-10 events per trade and would noise your Discord channel.

    Success criteria: 3 specific Smart Trade events selected (no other groups)

  5. Leave Generate secret ON

    Toggle "Generate secret" stays ON. We produce a random HMAC secret automatically. Discord ignores the X-Haythix-Signature header (Discord does not verify HMAC), but the secret is harmless and gives you a clean upgrade path if you ever switch to a raw receiver.

    Success criteria: Generate secret toggle is ON

  6. Save + click Test

    Click Save. Webhook appears in your list. Click it to open Detail view. Click Test. Within 1-2 seconds the delivery shows in the log with HTTP 204 (Discord success). Check your Discord channel — a synthetic Smart Trade event should appear as a formatted chat message.

    Success criteria: Discord channel shows the test event message AND deliveries log shows 1 success

  7. Wait for the first real Smart Trade event

    Now run a Smart Trade. When your entry fills, TP fires, or SL fires, the webhook posts to your Discord channel automatically. Each post takes 1-2 seconds after the actual fill. Hero stats panel updates with delivery count and success rate as events fire.

    Success criteria: At least one real (non-test) event has been delivered

What's next

You have one operational pipeline. Common follow-ups: (1) create a separate webhook for Grid Bot events to a different Discord channel. (2) For Slack instead of Discord, the workflow is identical — paste a Slack incoming webhook URL and the page auto-detects format. (3) For complex routing (e.g., "log Grid Bot fills to Google Sheets"), use n8n or Zapier with raw format. (4) Subscribe to alert.* to push every haythix Alert through the same channel.