Receive final voice status

webhook

voiceStatus

Terminal call-status notification: completed, busy, no-answer, or failed. Incoming uses the number StatusCallback; outgoing uses StatusCallback. GET has query values and no body; POST has form fields. Completion events include duration fields; failed events can omit them.

Query Params

Called

string

Direction

string

enum

Both real terminal-event senders select inbound or outbound-api using BIncoming.

Allowed:

Timestamp

string

UTC timestamp in English ddd, dd MMM yyyy HH:mm:ss +0000 form, using a 24-hour clock.

CallbackSource

string

enum

Allowed:

CallSid

string

Both real terminal-event senders select incoming CAI or outgoing CAO using BIncoming.

string

ApiVersion

string

enum

Allowed:

CallStatus

string

enum

Mapped from real terminal event state and reason: completed, busy, no-answer, or failed.

Allowed:

From

string

AccountSid

string

Caller

string

Digits

string

Optional captured DTMF string, URL-encoded when emitted in query/form fields. Documented in completion and failure builders.

SequenceNumber

integer

enum

Allowed:

Duration

integer

Completion branch: ceiling of duration seconds divided by 60; zero when provider duration is absent. Encoded as form/query text.

CallDuration

integer

Completion branch: duration in seconds; missing provider duration now defaults to zero. Encoded as form/query text.

SipResponseCode

integer

Completion branch: 200 for completed with positive duration, otherwise 400. Failure branch: 404. Encoded as text.

Headers

X-TextGrid-Signature

string

Base64 HMAC-SHA1 with the account WebhookSecret. GET signs the full requested URL including query parameters once; POST signs the original URL plus the raw body. Apply the documented non-ASCII escaping. See signature-verification.md.

Response

200

Response marked successful by these handlers.

Loading…