Webhooks

Last updated: February 19, 2026

Webhooks

Webhooks let your system receive real-time notifications when events happen in nakwasap.

Set Up a Webhook

  1. Go to Settings > Webhooks
  2. Click Add Webhook
  3. Enter:
    • URL — The endpoint that will receive the webhook
    • Events — Select the events to subscribe to
    • Secret — Secret key to verify the signature
  4. Click Save

Events

EventDescription
message.receivedNew message received
message.sentMessage sent
contact.createdNew contact created
chat.assignedChat assigned to member

Payload Format

{
  "event": "message.received",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "messageId": "msg_abc123",
    "from": "60123456789",
    "body": "Hello!",
    "instanceId": 1
  }
}

Verify Signature

Every webhook request includes an X-Webhook-Signature header that you can use to verify the authenticity of the request.