Skip to main content

Webhooks

Webhooks allow you to receive real-time notifications about message status and incoming messages.

Overview

Webhooks provide a way for our system to send data to your application in real-time whenever:
  • A message status changes
  • A recipient replies to your message
  • A new message is received

Setting Up Webhooks

  1. Go to your WhatsAble dashboard
  2. Navigate to Developer Settings
  3. Click “Add Webhook”
  4. Enter your webhook URL
  5. Select the events you want to receive

Webhook Events

Message Status Events

Incoming Message Events

Webhook Security

  1. HTTPS Required: All webhook endpoints must be accessible via HTTPS
  2. Authentication: Verify webhook signatures
  3. IP Whitelisting: Configure allowed IP addresses
  4. Rate Limiting: Handle multiple events efficiently

Best Practices

  1. Idempotency: Handle duplicate events gracefully
  2. Error Handling: Return appropriate HTTP status codes
  3. Logging: Log all incoming webhook events
  4. Monitoring: Set up alerts for webhook failures
  5. Testing: Use the webhook testing tool in dashboard

Example Webhook Handler