Skip to main content

Developer webhooks

Developer webhooks stream OXVO events to external systems so your backend can react in real time.

Where to find it​

Open Settings → Developer → Webhooks, or use the direct link.

Open directly: Open Developer Webhooks

When to use webhooks​

Use webhooks when you need to:

  • Sync conversation updates into internal systems
  • Trigger automation pipelines from support activity
  • Update CRM, billing, or ticketing records
  • Monitor operational events outside OXVO

Create a webhook endpoint​

  1. Open the Developer webhooks page.
  2. Select Add new webhook.
  3. Enter an HTTPS endpoint URL.
  4. Add an internal name (optional but recommended).
  5. Select subscribed event types.
  6. Save and run a controlled test.

Supported event types​

Common events include:

  • conversation_created
  • conversation_updated
  • conversation_status_changed
  • message_created
  • message_updated
  • contact_created
  • contact_updated
  • webwidget_triggered
  • conversation_typing_on
  • conversation_typing_off

Delivery and reliability guidance​

  • Return a fast 2xx response from your endpoint.
  • Process heavy logic asynchronously in your backend.
  • Make handlers idempotent to tolerate retries.
  • Log failures with enough context for replay.

Warning: Do not subscribe to every event on day one. Start with the smallest event set your integration needs.

Webhook setup with event subscriptions