Skip to content
Alertu Logo Alertu Docs

Discord Integration Guide

Prerequisites

Before you begin, ensure you have the following:

  1. “Manage Webhooks” permission in the Discord server where you want to receive alerts.
  2. Access to the Alertu platform and the alert groups you want to integrate.

Setup Steps

Follow these steps to integrate Discord with Alertu:

  1. Generate Webhook in Discord:

    • Open Discord and navigate to the server where you want to receive alerts.

    • Right-click on the channel you want to use and select “Edit Channel”.

    • Click on “Integrations” in the left sidebar.

    • Click on “Create Webhook” (or “View Webhooks” if you already have some).

    • Provide a name for the webhook (e.g., “Alertu Notifications”).

    • (Optional) Upload an avatar for the webhook.

    • Click “Copy Webhook URL”.

    Note: Keep this webhook URL secure, as it allows posting messages to your Discord channel.

  2. Configure Alertu Integration:

    • Log in to your Alertu account.
    • Navigate to the alert group you want to integrate with Discord.
    • Open the “Third Party Integration Settings” section.
    • Enable Third Party Integration.
    • Select “Discord” as the integration type.
    • Paste the webhook URL you copied from Discord.
    • Save the alert group settings.

  3. Test the Integration (Recommended):

    • In the alert group settings, locate and click the “Test Integration” button.
    • Check your Discord channel for the test message.
    • If successful, you should see a notification in your Discord channel, confirming the integration. 🎉

Verification

After setting up the integration:

  • Trigger a test alert in Alertu.
  • Verify that you receive a notification for the alert in your Discord channel.
  • Check that all expected alert details are correctly displayed in the Discord message.
  • Ensure any formatted text, embeds, or attachments (if applicable) appear correctly.

Troubleshooting

If you don’t receive alerts in Discord:

  • Double-check the webhook URL in your Alertu alert group to ensure it exactly matches the one generated by Discord.
  • Verify that the Discord channel and webhook are still active by sending a test message through Discord’s webhook testing interface (you can use cURL or Postman for this).
  • Ensure your Alertu alert group is correctly configured to send notifications and that the integration is enabled.
  • Check Discord’s server settings to make sure webhooks are still allowed and the specific webhook hasn’t been deleted.
  • Verify your network settings allow outbound connections from Alertu to Discord’s servers.
  • Review Alertu’s integration logs (if available) for any error messages or failed delivery attempts.

Additional Resources