Webhooks

Omnichannel provider delivery status webhook

Twilio messaging status callbacks update ChannelMessage / ChannelMessageAttempt by providerMessageId. Other catalog providers are accepted as scaffolds (no writes). Does not use admin tenant headers. Voice webhooks are unchanged.

POSThttps://api.thearvexa.com/api/webhooks/omnichannel/{segment}/status

Twilio Webhooks

Recent Requests

Time	Status	User Agent
Make a request to see history.

Path Params

segmentstringrequired

Catalog webhook path segment (twilio, infobip, …)

Headers

i-twilio-idempotency-tokenstringrequired

x-twilio-signaturestring

Twilio request signature. Required when TWILIO_VALIDATE_SIGNATURE is enabled in non-development environments.

Body Params

Request body is declared, but no field schema was published in OpenAPI.

Responses

200Accepted (applied, replayed, or scaffold)

Accepted (applied, replayed, or scaffold)

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

403Invalid or missing Twilio signature

Invalid or missing Twilio signature

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

404Unknown provider path segment

Unknown provider path segment

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

503Attempt not yet persisted for this providerMessageId, within OC_WEBHOOK_UNKNOWN_SID_RETRY_WINDOW_SECONDS (default 15s; Twilio tt ceiling) or interactive-tx timeout. Expected pre-dispatch; exclude omnichannel.webhook.status.unknown_sid / tx_timeout from error-rate paging. Beyond the window the drop is 200 and logged as droppedStatus. Requires StatusCallback URL fragment #rc=5&rp=5xx,ct,rt — Twilio does not retry 5xx by default.

Attempt not yet persisted for this providerMessageId, within OC_WEBHOOK_UNKNOWN_SID_RETRY_WINDOW_SECONDS (default 15s; Twilio tt ceiling) or interactive-tx timeout. Expected pre-dispatch; exclude omnichannel.webhook.status.unknown_sid / tx_timeout from error-rate paging. Beyond the window the drop is 200 and logged as droppedStatus. Requires StatusCallback URL fragment #rc=5&rp=5xx,ct,rt — Twilio does not retry 5xx by default.

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

← Return to API Reference