Receive Messages with Webhooks

To receive real-time notifications when customers message you, set up a webhook handler endpoint on your application server.

1. Configure Your Webhook

Register your HTTPS server callback URL under the webhook settings page in the Waplix Portal or via the Webhook Configuration API.

2. Ingest message.received Payloads

When a message arrives, Waplix sends a POST request. Your server must immediately parse and acknowledge the event:

{
  "event": "message.received",
  "instance_id": "demo_instance",
  "from": "15551234567@s.whatsapp.net",
  "chat_id": "15551234567@s.whatsapp.net",
  "message_type": "text",
  "message": "Hello developer!",
  "message_id": "MSG_DEMO_001",
  "timestamp": 1782582344
}
      

3. Acknowledge Response

Return an HTTP 200 OK response within 5 seconds. Failing to do so will result in connection timeouts and retry cycles from our backend routers.