Skip to main content

🔗 Webhook Configuration

Webhooks allow your application to receive notifications automatically when specific events occur on WhatsApp, such as incoming messages or message delivery status updates.

Benefits of Using Webhooks​

Instead of polling (repeatedly checking) the Wagy API, Webhooks deliver data via push (real-time). This is much more resource-efficient and makes your application more responsive.

PRO Feature

The Webhook feature is only available for devices with PRO quota.

Configuration Steps​

  1. Prepare a URL on your server (e.g., https://api.yourbusiness.com/wagy-webhook).
  2. Enter that URL in the Webhook URL field.
  3. Click Save URL.
  4. Click the Verify Now button. Wagy will verify URL ownership by sending a challenge code. Ensure your server responds correctly according to our technical documentation standards.

Webhook Signature Security​

To ensure that the data entering your server genuinely originates from Wagy and not another party, we provide a Webhook Secret:

  • Wagy will include the X-Wagy-Signature header with every data delivery.
  • You can verify this signature using the HMAC-SHA256 algorithm with your Webhook Secret as the key.
  • Example verification code in various programming languages is available directly on the panel configuration page.

Supported Event Types​

Wagy supports various types of events, including:

  • message.received: When a message arrives at your number.
  • message.sent, delivered, read: Status updates for messages you sent.
  • device.status_update: Notifications if your device gets disconnected or reconnected.

Finally, learn how to manage payments in Billing & Payments.