Skip to main content
Webhooks send OpenCX events, such as a session starting or closing, a handoff, a CSAT score, or a phone call ending, to an HTTPS endpoint you run. You set up endpoints from Settings → Webhooks, which opens a dedicated webhook dashboard.
Settings → Webhooks in your OpenCX dashboard. Viewing the page requires the Webhooks or Settings permission (Read). Opening the webhook dashboard requires Webhooks (Write).

Get access

Webhooks are turned on per organization by OpenCX. Until they are, OpenCX sends no webhook events for your organization, and Open dashboard shows:
Your organization is not allowed to use webhooks.
To request access, email the address in that message or support@open.cx. If your workspace is provided by a partner, the message shows your partner’s support address instead.

Open the webhook dashboard

1

Open Settings → Webhooks

Go to Settings → Webhooks. The page has one section, Webhook dashboard: “Webhook configuration, testing and monitoring live in a dedicated dashboard.”
2

Select Open dashboard

The webhook dashboard opens in a new browser tab. Open it again from this page whenever you need it.

Add your first endpoint

In the webhook dashboard:
  1. Add an endpoint with the HTTPS URL that should receive events.
  2. Choose the events to subscribe to. Every event and its payload is listed in Webhook event types.
  3. Copy the endpoint’s signing secret and verify the signature on every delivery, as described in delivery, signatures and retries.
  4. Send a test event, then check its delivery history in the dashboard.
Each delivery is an HTTP POST with a JSON body in the envelope { event, organization_id, data }. Return a 2xx response quickly and process the event afterwards. Failed deliveries are retried automatically, and you can replay them from the dashboard. If you use Connect, its thread and Supervisor events go through the same endpoints. See Connect webhooks.

Troubleshooting


Webhook event types

Payloads, signatures, and retries.

Connect webhooks

Thread and Supervisor events.

Permissions reference

Who can manage webhooks.

CSAT

Surveys behind CSAT events.