Using Webhooks

Overview

Webhooks send HTTP POST requests to external URLs when events occur in Kulpunai.

Setting Up Webhooks

1. Go to Settings → Integrations → Webhooks
2. Click Add Webhook
3. Enter:
   • Webhook URL: Your endpoint
   • Events: Which events to listen for

Supported Events

• conversation_created
• conversation_updated
• conversation_status_changed
• message_created
• message_updated
• webwidget_triggered

Payload Structure

{
  "event": "message_created",
  "id": 123,
  "content": "Hello",
  "conversation": {...},
  "sender": {...},
  "account": {...}
}

Use Cases

• Sync with CRM
• Send notifications to Slack
• Update external databases
• Trigger custom workflows

Security

• Validate webhook signatures
• Use HTTPS endpoints
• Implement retry handling