Webhooks & Events

Cloud Voice can notify your systems when things happen on your account, by delivering events to an HTTPS endpoint you control. Events cover the telephony lifecycle, trunk registrations, call activity, and fax transmission status, and are dispatched asynchronously from a delivery queue so event bursts don’t get lost.

Event types

Category	Examples
Registration	A Register trunk comes online or drops its registration
Calls	Call lifecycle events on your trunks
Fax	Transmission progress and final status of sent and received faxes (see Faxing over SIP)

The trunk registration events are the same signal that powers the dashboard’s live registration status and Trunk Health widget, webhooks let your own monitoring consume it too.

Full event catalog

Detailed event list and payload schemas coming soon.

Configuring an endpoint

Detailed steps coming soon.

Tip

Use a dedicated HTTPS endpoint that responds quickly with a success status and processes the event afterward, slow handlers are the most common cause of delivery problems.

Delivery & retries

Events are queued and delivered asynchronously, so momentary spikes in call volume don’t drop notifications.

Retry schedule and delivery-guarantee details coming soon.

Verifying deliveries

Signature verification details coming soon.

Note

If you need to poll instead of receiving pushes, for example for trunk statistics or fax status, the same data is available through the API.