TelephonyCallJob interface

Package:

@azure/ai-projects

A durable direct or campaign-created outbound call intent.

Properties

agent_name	The name of the voice agent used at execution time.
attempt_count	The number of provider attempts created so far.
cancellation	The recorded cancellation request, when cancellation was requested.
connection_name	The Foundry connection name in the current project used to originate the call. Its category selects Twilio or Azure Communication Services / Teams Phone Extension. No inbound telephony binding is required.
created_at	The Unix timestamp in seconds when the call job was created.
destination	The phone destination to call.
id	The service-generated call-job identifier.
next_attempt_at	The Unix timestamp in seconds at which the next retry becomes eligible.
object	The object type. Always telephony.call_job.
purpose	An optional customer-declared purpose for placing the call.
retry_policy	The frozen provider-attempt retry policy.
revision	The monotonically increasing optimistic-concurrency revision.
schedule	The optional execution window.
source	The caller identity used to originate the call. For a Twilio connection, provide an authorized E.164 phone number. For an Azure Communication Services / Teams Phone Extension connection, provide the Teams Resource Account object ID. The identity type is inferred from the connection category; originating does not change inbound routing.
status	The current call-job lifecycle status.
structured_inputs	Structured input values available to the agent and greeting for this call. Agent-declared inputs are validated against their schemas; omitted optional inputs may use their Agent-defined default values, while omitted required inputs are rejected. Additional inputs remain available as dynamic template variables.
terminal_reason	The stable service-generated reason for the overall outbound call job, which can span multiple provider attempts, when available. Interpret this with status: a queued job can retain a temporary dispatch-deferral reason. Additional string codes may be returned.
updated_at	The Unix timestamp in seconds when the call job was last updated.

Property Details

agent_name

The name of the voice agent used at execution time.

agent_name: string

Property Value

string

attempt_count

The number of provider attempts created so far.

attempt_count: number

Property Value

number

cancellation

The recorded cancellation request, when cancellation was requested.

cancellation?: TelephonyCallJobCancellation

Property Value

TelephonyCallJobCancellation

connection_name

The Foundry connection name in the current project used to originate the call. Its category selects Twilio or Azure Communication Services / Teams Phone Extension. No inbound telephony binding is required.

connection_name: string

Property Value

string

created_at

The Unix timestamp in seconds when the call job was created.

created_at: Date

Property Value

Date

destination

The phone destination to call.

destination: TelephonyOutboundDestination

Property Value

TelephonyOutboundDestination

id

The service-generated call-job identifier.

id: string

Property Value

string

next_attempt_at

The Unix timestamp in seconds at which the next retry becomes eligible.

next_attempt_at?: Date

Property Value

Date

object

The object type. Always telephony.call_job.

object: "telephony.call_job"

Property Value

"telephony.call_job"

purpose

An optional customer-declared purpose for placing the call.

purpose?: string

Property Value

string

retry_policy

The frozen provider-attempt retry policy.

retry_policy: TelephonyOutboundRetryPolicyUnion

Property Value

TelephonyOutboundRetryPolicyUnion

revision

The monotonically increasing optimistic-concurrency revision.

revision: number

Property Value

number

schedule

The optional execution window.

schedule?: TelephonyCallJobSchedule

Property Value

TelephonyCallJobSchedule

source

The caller identity used to originate the call. For a Twilio connection, provide an authorized E.164 phone number. For an Azure Communication Services / Teams Phone Extension connection, provide the Teams Resource Account object ID. The identity type is inferred from the connection category; originating does not change inbound routing.

source: string

Property Value

string

status

The current call-job lifecycle status.

status: TelephonyCallJobStatus

Property Value

TelephonyCallJobStatus

structured_inputs

Structured input values available to the agent and greeting for this call. Agent-declared inputs are validated against their schemas; omitted optional inputs may use their Agent-defined default values, while omitted required inputs are rejected. Additional inputs remain available as dynamic template variables.

structured_inputs?: Record<string, any>

Property Value

Record<string, any>

terminal_reason

The stable service-generated reason for the overall outbound call job, which can span multiple provider attempts, when available. Interpret this with status: a queued job can retain a temporary dispatch-deferral reason. Additional string codes may be returned.

terminal_reason?: string

Property Value

string

updated_at

The Unix timestamp in seconds when the call job was last updated.

updated_at: Date

Property Value

Date