Webhooks Introduction

Webhooks allow Waplix to send real-time HTTP POST event payloads to your server when changes occur on your connected WhatsApp instances.

Common Event Types

• message.received - Triggered when a new incoming message is received
• message.sent - Triggered when an outgoing message is successfully sent
• message.delivered - Triggered when a message is delivered to the recipient
• message.read - Triggered when a message is read by the recipient (blue ticks)
• instance.connected - Triggered when a session connects successfully
• presence_update - Triggered when online status changes

Security & Integration Best Practices

• Always use a secure HTTPS endpoint for your webhook receiver URL.
• Verify webhook secrets (if configured) to ensure payloads originate from Waplix.
• Acknowledge webhook delivery quickly by returning an HTTP 200 OK status immediately.
• Offload heavy operations (e.g., database writes, AI processing) to a background queue to prevent connection timeouts.