Set up Discord webhook notifications

Send readable Affonso notifications to your team's Discord channel without writing code. You create a Discord incoming webhook for the destination channel, paste its URL into Affonso, and choose which events should be posted.

You need the Manage Webhooks permission in your Discord server.

Create an incoming webhook in Discord

1. Open your Discord server and select Server Settings.
2. Go to Integrations → Webhooks.
3. Click Create Webhook.
4. Give the webhook a recognizable name, such as Affonso, and select the destination channel.
5. Click Copy Webhook URL.

For more detail, see Discord's webhook setup guide and incoming webhook documentation.

Connect Discord to Affonso

1. Open Connect → Webhooks in Affonso.
2. Click Add Endpoint.
3. Paste the Discord incoming-webhook URL into Endpoint URL.
4. Confirm that Discord is selected as the format. Affonso suggests it automatically for recognized Discord URLs.
5. Select the events you want to receive.
6. Save the endpoint.
7. Open the endpoint and click Send test event in Deliveries.
8. Choose one of the subscribed events and click Send test event again.

The notification should appear in the Discord channel with a visible Test label, the selected event title, and realistic mock fields. The test does not create or read program records.

Send events to different channels

Create a separate Discord incoming webhook and Affonso endpoint for each channel that needs different notifications. For example, send new affiliate and referral events to a growth channel, and payout failures to a finance channel.

Each Discord notification contains a curated set of useful event details. If you need the complete machine-readable payload for an application or automation, create a Raw JSON webhook instead.

Troubleshooting

• The URL is rejected: Copy the incoming-webhook URL again from Discord. Affonso accepts HTTPS URLs from recognized Discord incoming-webhook domains.
• The test fails: Check that the webhook still exists, it can post to the selected channel, and its server permissions have not changed.
• The message goes to the wrong channel: Change the webhook's destination in Discord, or create a new webhook for the correct channel and update the Affonso endpoint.
• A delivery failed after setup: Open the endpoint's Deliveries section to inspect the response. After fixing the destination, replay a production delivery or send a new test event. Test events cannot be replayed.

Keep the webhook URL secure

A Discord incoming-webhook URL contains a credential that can post to its channel. Do not share it in public messages, source code, or logs. If it is exposed, delete or recreate the webhook in Discord, then update the endpoint in Affonso.