Agent Telephony
Create an agent telephony binding
Creates a telephony binding for the voice agent named in the path. Creating a SIP binding requires the VoiceAgents=V1Preview opt-in.
標頭參數
Foundry-Features
enum
A feature flag opt-in required when using preview operations or modifying persisted preview resources.
Repeatability-Request-ID
string
An opaque, globally-unique, client-generated string identifier for the request.
Repeatability-First-Sent
string
Specifies the date and time at which the request was first created.
路徑參數
agent_name
string
必要
The name of the voice agent that owns the binding.
查詢參數
api-version
string
必要
The API version to use for this operation.
要求本文
The provider-specific binding to create.
teams_phone_extensibility
TeamsPhoneExtensibilityTelephonyBinding
A Microsoft Teams Phone extensibility binding owned by a voice agent.
provider
enum
必要
The Microsoft Teams Phone extensibility provider.
phone_number
string
The optional display phone number for the Teams resource account.
resource_account_object_id
string
必要
Universally Unique Identifier
twilio
TwilioTelephonyBinding
A Twilio binding owned by a voice agent.
provider
enum
必要
The Twilio provider.
phone_number
string
必要
The Twilio E.164 phone number.
sip
SipTelephonyBinding
Inbound binding using a same-project SipInbound connection for authentication/network restrictions. Creation does not prove regional runtime readiness.
provider
enum
必要
The SIP provider.
phone_number
string
Optional display metadata, not a routing key or E.164-constrained destination.
allowed_calling_numbers
SipAllowedCallingNumber[]
Exact E.164 caller numbers or restricted anchored patterns, validated by the service. Omit or use [] for no restriction.
回覆
The request has succeeded and a new resource has been created as a result.
標題
ETag
string
必要
The entity tag to send in the If-Match header when updating or deleting the binding.
主體
teams_phone_extensibility
TeamsPhoneExtensibilityTelephonyBinding
A Microsoft Teams Phone extensibility binding owned by a voice agent.
provider
enum
必要
The Microsoft Teams Phone extensibility provider.
phone_number
string
The optional display phone number for the Teams resource account.
resource_account_object_id
string
必要
Universally Unique Identifier
twilio
TwilioTelephonyBinding
A Twilio binding owned by a voice agent.
provider
enum
必要
The Twilio provider.
phone_number
string
必要
The Twilio E.164 phone number.
sip
SipTelephonyBinding
Inbound binding using a same-project SipInbound connection for authentication/network restrictions. Creation does not prove regional runtime readiness.
provider
enum
必要
The SIP provider.
phone_number
string
Optional display metadata, not a routing key or E.164-constrained destination.
allowed_calling_numbers
SipAllowedCallingNumber[]
Exact E.164 caller numbers or restricted anchored patterns, validated by the service. Omit or use [] for no restriction.
Request
POST /agents/{agent_name}/telephony/bindings HTTP/1.1
回應
Status: 201
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json