Skip to content
Alertu Logo Alertu Docs

Universal Integration Guide

Prerequisites

Before you begin, ensure you have the following:

  1. Access to the Alertu platform and the alert groups you want to integrate.
  2. Access to the platform where you want to receive alerts, with permissions to create or manage webhooks.

Setup Steps

Follow these steps to integrate Alertu with your chosen platform using webhooks:

  1. Obtain Webhook URL from Your Platform:

    • Log into the platform where you want to receive Alertu notifications.

    • Look for options like “Integrations”, “Webhooks”, or “API”.

    • Create a new webhook or incoming webhook integration.

    • Copy the provided webhook URL.

    Note: The exact process will vary depending on your platform. Consult your platform’s documentation for specific instructions on creating webhooks.

    Security Note: Always keep webhook URLs secure, as they allow external services to post messages to your platform.

  2. Configure Alertu Integration:

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

  3. Test the Integration (Recommended):

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

Verification

After setting up the integration:

  • Trigger a test alert in Alertu (preferably using a non-production alert).
  • Verify that you receive a notification for the alert in your chosen platform.
  • Check that all expected alert details are correctly displayed in the message.
  • Ensure any formatted text or data is correctly interpreted by your platform.

Troubleshooting

If you don’t receive alerts in your platform:

  • Double-check the webhook URL in your Alertu alert group to ensure it’s correct.
  • Verify that the webhook is still active on your receiving platform.
  • Ensure your Alertu alert group is correctly configured to send notifications and that the integration is enabled.
  • Check your platform’s webhook settings to make sure incoming messages are allowed.
  • Test the webhook directly using a tool like cURL or Postman to ensure it’s functioning correctly.

Additional Resources