Webhook integrations

Set up webhooks to receive real-time notifications about visitor events and integrate with your existing workflows.

What are Webhooks?

Webhooks are HTTP callbacks that notify your application when specific events occur in your Zenovay account.

Supported Events

Configure webhooks for these events:

• visitor.new: New visitor to your site
• visitor.return: Returning visitor
• pageview.new: New page view
• traffic.spike: Unusual traffic increase
• goal.completed: Conversion goal achieved

Setting Up Webhooks

1. Navigate to Settings > Webhooks
2. Click "Add Webhook"
3. Enter your endpoint URL
4. Select events to subscribe to
5. Configure security settings
6. Test the webhook

Webhook Payload

Example webhook payload structure:

{
  "event": "visitor.new",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "visitor_id": "abc123",
    "location": {
      "country": "United States",
      "city": "New York"
    },
    "referrer": "https://google.com",
    "user_agent": "Mozilla/5.0..."
  }
}

Security

Secure your webhooks:

• HTTPS endpoints required
• Request signature verification
• IP address whitelisting
• Custom authentication headers