TelephonyCallRecord interface

Package:

@azure/ai-projects

Detailed diagnostics for a durable inbound call to a voice agent.

Properties

agent_session_ready_at	The Unix timestamp (in seconds) for when the voice-agent session became ready.
answered_at	The Unix timestamp (in seconds) for when the provider reported the call as answered.
caller_number	The caller's phone number, when supplied by the provider.
duration_ms	The call duration.
ended_at	The Unix timestamp (in seconds) for when the call ended.
end_reason	The service-generated reason that this single call ended, rather than the outcome of an overall outbound call job. Additional string codes may be returned.
events	The lifecycle timeline.
events_truncated	Whether older lifecycle events were omitted from the timeline.
id	The service-generated call identifier.
media_connected_at	The Unix timestamp (in seconds) for when the provider media channel connected.
phase	The provider-neutral lifecycle phase reached by the call.
provider	The telephony provider.
provider_call_id	The provider-assigned call identifier, when available.
provider_message	The provider message associated with the terminal result.
provider_number	The Teams Phone Extension or Twilio number that received the call.
provider_status_code	The provider status code associated with the terminal result.
provider_sub_code	The provider subcode associated with the terminal result.
started_at	The Unix timestamp (in seconds) for when the inbound webhook was received.
status	The lifecycle status of the call.
timing	Detailed provider-neutral call timing.
trace	Correlation to the customer-facing Foundry trace.

Property Details

agent_session_ready_at

The Unix timestamp (in seconds) for when the voice-agent session became ready.

agent_session_ready_at?: Date

Property Value

Date

answered_at

The Unix timestamp (in seconds) for when the provider reported the call as answered.

answered_at?: Date

Property Value

Date

caller_number

The caller's phone number, when supplied by the provider.

caller_number?: string

Property Value

string

duration_ms

The call duration.

duration_ms?: number

Property Value

number

ended_at

The Unix timestamp (in seconds) for when the call ended.

ended_at?: Date

Property Value

Date

end_reason

The service-generated reason that this single call ended, rather than the outcome of an overall outbound call job. Additional string codes may be returned.

end_reason?: string

Property Value

string

events

The lifecycle timeline.

events: TelephonyCallLifecycleEvent[]

Property Value

TelephonyCallLifecycleEvent[]

events_truncated

Whether older lifecycle events were omitted from the timeline.

events_truncated: boolean

Property Value

boolean

id

The service-generated call identifier.

id: string

Property Value

string

media_connected_at

The Unix timestamp (in seconds) for when the provider media channel connected.

media_connected_at?: Date

Property Value

Date

phase

The provider-neutral lifecycle phase reached by the call.

phase: TelephonyCallPhase

Property Value

TelephonyCallPhase

provider

The telephony provider.

provider: TelephonyProvider

Property Value

TelephonyProvider

provider_call_id

The provider-assigned call identifier, when available.

provider_call_id?: string

Property Value

string

provider_message

The provider message associated with the terminal result.

provider_message?: string

Property Value

string

provider_number

The Teams Phone Extension or Twilio number that received the call.

provider_number?: string

Property Value

string

provider_status_code

The provider status code associated with the terminal result.

provider_status_code?: number

Property Value

number

provider_sub_code

The provider subcode associated with the terminal result.

provider_sub_code?: number

Property Value

number

started_at

The Unix timestamp (in seconds) for when the inbound webhook was received.

started_at: Date

Property Value

Date

status

The lifecycle status of the call.

status: TelephonyCallStatus

Property Value

TelephonyCallStatus

timing

Detailed provider-neutral call timing.

timing: TelephonyCallTiming

Property Value

TelephonyCallTiming

trace

Correlation to the customer-facing Foundry trace.

trace?: TelephonyCallTrace

Property Value

TelephonyCallTrace