Skip to main content

​
User Webhooks

You can now configure your own webhook endpoints to receive WhatsApp events in real-time directly in your application.

​
New Features

Custom Endpoints

Configure multiple webhook URLs per organization with HTTPS validation

HMAC Signing

Optional SHA-256 signature for payload validation

Custom Headers

Add custom HTTP headers for authentication

Event Filtering

Filter by instance and event type

​
Event Logs

Track all webhook deliveries with detailed logs:
  • Status tracking: Success, failed, pending states
  • Latency monitoring: Response time in milliseconds
  • Payload inspection: View exact payload sent
  • Resend capability: Retry failed deliveries
  • Test events: Send test payloads to verify connectivity

​
Payload Format

{
  "event": "message.received",
  "timestamp": "2024-12-12T10:30:00.000Z",
  "webhookId": "uuid",
  "instance": {
    "id": "uuid",
    "phone": "5511999999999",
    "name": "My Instance"
  },
  "data": {
    "messageId": "ABC123",
    "from": "5511888888888",
    "type": "text",
    "body": "Hello!"
  }
}

​
Security Headers

When you configure a signing secret, we include: 
x-livchat-signature: sha256=<hmac_hex>
x-livchat-timestamp: 1702383000
Configure your webhooks at Dashboard > Webhooks.