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.

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 Settings → Developer → Webhooks.
  2. Select Add 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.

📷 Image (optional): Webhook setup with event subscriptions
Why: Shows endpoint setup and event selection in the same view used by administrators.
File: docs/images/developers-webhooks-setup.png
AI prompt: "Clean product documentation screenshot of OXVO Settings Developer Webhooks page with webhook list and an open create modal containing endpoint URL, name field, and event subscription toggles for conversation, message, and contact events; modern SaaS UI, neutral background, high contrast, OXVO branding only, synthetic sample data, 1600x1000."