Discord Webhook adapter

The Discord Webhook adapter sends KALYIX Tip events as ready-to-post Discord messages into a Discord channel. You do not need a Discord bot or your own server.

Use this adapter for simple channel messages: new tips, test events, and later other allowed KALYIX events. Roles, commands, and server management are not part of this adapter.

Requirements

  • A Discord server where you may create webhooks for a channel.
  • A Discord webhook URL.
  • The Discord Webhook adapter in the Extensions Dashboard.
  • Enabled events and fields, for example Tip paid, amount, currency, and displayName.

Create a Discord webhook URL

  1. Open Discord.
  2. Open the server and channel where KALYIX should post.
  3. Open the channel settings.
  4. Go to Integrations.
  5. Open Webhooks.
  6. Create a new webhook or use an existing one.
  7. Copy the webhook URL.

The URL looks roughly like this:

https://discord.com/api/webhooks/123456789/abcdef...

Do not share this URL publicly. Anyone with the URL can post into that Discord channel.

Set up KALYIX

  1. Open the Extensions Dashboard.
  2. Enable the Discord Webhook adapter.
  3. Use Add target if you want another Discord target.
  4. Enter the Discord webhook URL.
  5. Write the Discord message.
  6. Enable the Tip paid event.
  7. Select the fields you want to use in the message.
  8. Save the selection.
  9. Save the Discord configuration.
  10. Use Send test to verify the channel.

You can create up to 5 Discord webhook targets. This lets you send messages to different servers or channels from the same KALYIX account.

Build a message with tokens

In the Discord message field, write normal Discord Markdown text and insert KALYIX tokens.

Example:

Thank you {{displayName}} for {{amount}} {{currency}}!

Message:
{{message}}

Tokens are only filled when the matching field is enabled and saved in the dashboard. If you use {{message}} but do not allow the message field, the token stays empty.

Available tokens

The token list in the dashboard shows the values available for this target based on your saved selection.

Typical Tip tokens are:

TokenMeaning
{{amount}}Amount, for example 10.
{{amountCents}}Amount in cents, for example 1000.
{{currency}}Currency, for example EUR.
{{username}}Technical username, if available.
{{displayName}}Display name, if available.
{{message}}Supporter message.
{{goalId}}Internal goal ID.
{{goalTitle}}Goal title.
{{pageSlug}}Tip page slug.
{{createdAt}}Event timestamp.
{{isTest}}Marks a test event.

Not every event has every field. Enabled but empty fields are replaced with an empty value.

Send test

Send test creates a real extension test event for this exact Discord target. It uses the same delivery flow as a real tip.paid event, but it is not stored as a real payment in Tip payment history.

If no message appears in Discord:

  • Check that the Discord webhook URL is saved.
  • Check that the target is switched On.
  • Check that Tip paid is enabled and saved.
  • Check that Discord still allows the webhook.
  • Check the history in the Extensions Dashboard for errors.

Difference to Raw Webhook

Discord Webhook builds a Discord message and sends it directly to Discord.

Raw Webhook sends raw KALYIX JSON data to your own server. Do not enter a Discord webhook URL into the Raw Webhook adapter, because Discord does not understand KALYIX JSON.

Use:

GoalAdapter
Discord channel without your own serverDiscord Webhook
Own server, automation, or mapperRaw Webhook
Streamer.bot alertsStreamer.bot

Difference to the Discord Bot

The Discord Webhook adapter can post messages. It cannot assign roles, run commands, check members, or manage servers.

Those features belong in a separate KALYIX Discord Bot later.