Signed switch events and authoritative call state
Configure the event bridge, verify timestamp/nonce/signature evidence, ingest idempotent events and reconcile authoritative call status and duration.
xConnect
Open guide →GuideUnderstand the signed switch-event bridge
Use authenticated voice-switch events as authoritative call-state evidence.
Open guide →GuideConfigure the event bridge
Provide the protected secret-file location through the CLI deployment workflow.
Open guide →GuideDisable the event bridge
Use the CLI-only disable action when rollback or maintenance requires it.
Open guide →GuideReview event bridge configuration
Use the CLI-only event-config diagnostic to confirm callback and readiness.
Open guide →GuideUse PUT for switch events
Reject non-PUT event submissions.
Open guide →GuideRespect the 65,536-byte payload limit
Reject empty or oversized event payloads.
Open guide →GuideSend required signature headers
Provide timestamp, nonce and signature headers for every event.
Open guide →GuideValidate event timestamps
Reject stale or invalid timestamp evidence.
Open guide →GuideUse replay-protected nonces
Reject a reused event nonce.
Open guide →GuideVerify the HMAC signature
Validate the raw request body using the configured secret.
Open guide →GuideSend valid JSON
Reject payloads that cannot be decoded as an event object.
Open guide →GuideUnderstand idempotent event keys
Avoid creating duplicate evidence when the same valid event is delivered again.
Open guide →GuideMatch an event to a call
Use call UUID/route evidence to update the correct stored call.
Open guide →GuideIngest ringing events
Update call state when the switch reports ringing.
Open guide →GuideIngest answered events
Record answered time and active state.
Open guide →GuideIngest completed or hangup events
Record final status, duration and cause.
Open guide →GuideIngest failure causes
Store the authoritative failure reason for failed/missed/declined/cancelled outcomes.
Open guide →GuideReview last switch event time
Use dashboard/diagnostics to confirm recent event delivery.
Open guide →