CreateTelephonyCallJobRequest interface
A request to create one durable direct outbound call job.
Properties
| 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. |
| destination | The phone destination to call. |
| purpose | An optional customer-declared purpose for placing the call. |
| retry_policy | The provider-attempt retry policy. Omit it for one attempt with no retry delay. |
| 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. |
| 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. |
Property Details
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
destination
The phone destination to call.
destination: TelephonyOutboundDestination
Property Value
purpose
An optional customer-declared purpose for placing the call.
purpose?: string
Property Value
string
retry_policy
The provider-attempt retry policy. Omit it for one attempt with no retry delay.
retry_policy?: TelephonyOutboundRetryPolicyUnion
Property Value
schedule
The optional execution window.
schedule?: TelephonyCallJobSchedule
Property Value
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
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>