Webhooks

A webhook sends an HTTP request to your address when something happens in Kulpunai. It is how the platform is wired into your own systems.

Setting one up

1. Open Settings → Integrations → Webhooks.
2. Add a webhook.
3. Enter:
   • URL — where requests should go;
   • Events — what to react to.

Events

• conversation_created — a conversation was created;
• conversation_updated — a conversation changed;
• conversation_status_changed — the status changed;
• message_created — a new message;
• message_updated — a message was edited;
• webwidget_triggered — a visitor opened the website widget.

Payload format

The request arrives as a POST with a JSON body:

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

The fields present depend on the event.

Uses

• Pushing leads into your own CRM or accounting system;
• Notifications in a corporate chat;
• Recording requests in an external database;
• Triggering your own processing.

Recommendations

• Use an HTTPS endpoint.
• Respond quickly: a slow response leads to retries.
• Handle repeats — the same event can arrive twice.
• Test against a scratch endpoint before pointing a production system at it.