Webhooks

waveswebhooksintegrationsdiscordslacknotifications

What Are Webhooks?

Webhooks let your Wave send automatic notifications to an external URL whenever something happens — like a participant joining or leaving a Ripple. This is useful for logging activity, triggering automations, or posting updates to Discord or Slack.

Setting Up a Webhook

Go to Wave Settings → Webhooks and configure:

Endpoint URL

The URL that Rippily sends event data to. This could be:

  • A Discord webhook URL
  • A Slack incoming webhook URL
  • Your own server endpoint
  • A service like Zapier or Make (Integromat)

Format

Choose how the payload is structured:

Format Description
Standard JSON payload with full event details (default)
Discord Formatted for Discord webhook embeds
Slack Formatted for Slack incoming webhooks

If you're posting directly to a Discord or Slack channel, select the matching format and paste the webhook URL from that service.

Event Filtering

Choose which events trigger the webhook:

  • participant.joined — someone enters a Ripple
  • participant.left — someone leaves a Ripple

You can enable one or both.

Role Exclusions

Exclude specific roles from triggering webhooks. For example, you might not want notifications every time an administrator joins — only when regular members or guests do.

Secret Signing

Each webhook is assigned a secret key that Rippily uses to sign every payload. If you're building your own endpoint, you can verify the signature to confirm the request genuinely came from Rippily.

The secret is generated automatically when you create the webhook. You can regenerate it at any time, but existing integrations will need updating.

Failure Handling

If your endpoint doesn't respond successfully, Rippily tracks the failure. After repeated failures, the webhook is automatically disabled to prevent unnecessary load.

When a webhook is auto-disabled, you'll see the reason and failure count in the settings panel. Fix the issue with your endpoint, then re-enable the webhook.

Testing

Use the Send Test button to send a sample event to your endpoint. This lets you verify your integration is working without waiting for a real participant event.

Example: Discord Notifications

  1. In Discord, go to your channel's settings → Integrations → Webhooks
  2. Create a new webhook and copy its URL
  3. In Rippily Wave Settings → Webhooks, paste the URL
  4. Set the format to Discord
  5. Choose your events and save

Your Discord channel will now receive formatted messages whenever someone joins or leaves a Ripple.