跳到主要內容

已不再支援此瀏覽器。

請升級至 Microsoft Edge,以利用最新功能、安全性更新和技術支援。

下載 Microsoft Edge Internet Explorer 和 Microsoft Edge 的詳細資訊
microsoft-foundry.rest.security.o-auth2-auth

Agent Telephony

Get an agent telephony binding

GET /agents/{agent_name}/telephony/bindings/{binding_id}

Retrieves a telephony binding owned by the voice agent named in the path.

標頭參數

Foundry-Features enum

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

VoiceAgents=V1Preview

路徑參數

agent_name string 必要

The name of the voice agent that owns the binding.

binding_id string 必要

The service-generated binding identifier.

查詢參數

api-version string 必要

The API version to use for this operation.

回覆

The request has succeeded.

標題

ETag string 必要

The entity tag to send in the If-Match header when updating or deleting the binding.

主體

Content-Type: application/json
下列其中一項:
teams_phone_extensibility TeamsPhoneExtensibilityTelephonyBinding

A Microsoft Teams Phone extensibility binding owned by a voice agent.

provider enum 必要

The Microsoft Teams Phone extensibility provider.

teams_phone_extensibility
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.

twilio
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.

sip
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.

Client error

主體

Content-Type: application/json
error OpenAI.Error 必要
code string | null 必要
message string 必要
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
以下任何一項:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string 必要

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

Server error

主體

Content-Type: application/json
error OpenAI.Error 必要
code string | null 必要
message string 必要
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
以下任何一項:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string 必要

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

Request

GET /agents/{agent_name}/telephony/bindings/{binding_id} HTTP/1.1

回應

Status: 200
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
zh-tw
您的隱私權選擇
  • AI 免責聲明
  • 舊版本
  • 部落格
  • 參與
  • 隱私權
  • 消費者健康隱私
  • 使用規定
  • 商標
  • © Microsoft 2026