Webhooks

Created on 29 December, 2024 • Docs • 188 views • 2 minutes read

Webhook integration allows customers to send real-time monitoring alerts, such as downtime notifications, DNS monitoring updates, or server uptime details, to third-party platforms like Zapier, Make (formerly Integromat), or custom systems.

Why Use Webhooks for Notifications

Webhooks provide a flexible and efficient way to automate workflows and integrate Pingtr's monitoring alerts with other platforms. With webhooks, customers can trigger actions in third-party tools or custom applications when a specific event occurs, such as a server going down or DNS records changing. This enables immediate responses to critical issues, reducing downtime and improving system reliability.

Features of Webhook Notifications

  1. Real-time Alerts: Webhooks send notifications instantly when an event occurs, such as downtime or SSL expiration.
  2. Platform Integration: Compatible with platforms like Zapier, Make, and custom APIs for further processing or automation.
  3. Scalability: Supports multiple use cases, including notifying IT teams, updating dashboards, or triggering recovery scripts.

Setting Up a Webhook as a Notification Handler

Step 1: Create a Webhook URL

  1. Set up a webhook URL on your desired platform, such as Zapier or Make.
  2. For custom systems, configure your endpoint to receive and process POST requests.

Step 2: Configure Webhook in Pingtr

  1. Visit the Pingtr notification settings page.
  2. Select Webhook as the notification handler type.
  3. Enter the webhook URL from your platform or custom system.
  4. Save the webhook configuration.

Step 3: Test the Webhook

  1. Trigger a test event from Pingtr to ensure the webhook is set up correctly.
  2. Verify the data is received and processed by your platform or custom system.

Example Webhook Payload

When an event occurs, Pingtr sends a JSON payload to the configured webhook URL. Payload is like this:

{
"monitor_id": "934",
"name": "example.com",
"is_ok": 0,
"url": "https://pingtr.com/monitor/934"
}

Use Cases for Webhook Notifications

Automating Incident Response

Send downtime alerts to a platform like Zapier to trigger incident management workflows. For example, create a ticket in a system like Jira or send a Slack notification to the IT team.

Updating Dashboards

Send server uptime details to Make, which updates a real-time monitoring dashboard with the latest metrics.

Triggering Recovery Scripts

Use custom systems to process webhook alerts and trigger automated recovery scripts, such as restarting a server or clearing a DNS cache.

Enhancing Customer Communication

Notify a CRM system about service disruptions using webhooks, enabling proactive communication with affected customers.

Tips for Effective Webhook Usage

  1. Secure the Webhook URL: Use authentication mechanisms (e.g., secret keys or tokens) to ensure only trusted sources can trigger your webhook.
  2. Validate Payloads: Verify the data structure and values in the received payload before processing.
  3. Optimize Workflows: Integrate with platforms like Zapier or Make to automate repetitive tasks and enhance incident response.
  4. Test Regularly: Periodically test the webhook to ensure it works as expected and handles alerts correctly.

Webhook integration in Pingtr empowers customers to build robust, automated workflows for monitoring and incident response. By seamlessly connecting to platforms like Zapier or custom systems, businesses can respond faster to issues, minimize downtime, and maintain system reliability.