Ignora e passa al contenuto principale

Questo browser non è più supportato.

Esegui l'aggiornamento a Microsoft Edge per sfruttare i vantaggi di funzionalità più recenti, aggiornamenti della sicurezza e supporto tecnico.

Scarica Microsoft Edge Scopri di più su Internet Explorer e Microsoft Edge
microsoft-foundry.rest.security.o-auth2-auth

Agent Telephony

Create an agent telephony binding

POST /agents/{agent_name}/telephony/bindings

Creates a telephony binding for the voice agent named in the path.

Parametri di intestazione

Foundry-Features enum

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

VoiceAgents=V1Preview
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.

Parametri del percorso

agent_name string necessario

The name of the voice agent that owns the binding.

Parametri di query

api-version string necessario

The API version to use for this operation.

Corpo della richiesta

The provider-specific binding to create.

Content-Type: application/json
Uno dei seguenti:
teams_phone_extension CreateTeamsPhoneExtensionTelephonyBindingRequest

The request to create a Microsoft Teams Phone Extension binding.

provider enum necessario

The Microsoft Teams Phone Extension provider.

teams_phone_extension
phone_number string

The optional display phone number for the Teams resource account.

resource_account_object_id string necessario

Universally Unique Identifier

twilio CreateTwilioTelephonyBindingRequest

The request to create a Twilio binding.

provider enum necessario

The Twilio provider.

twilio
phone_number string necessario

The Twilio E.164 phone number.

Risposte

The request has succeeded and a new resource has been created as a result.

Intestazioni

ETag string necessario

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

Corpo

Content-Type: application/json
Uno dei seguenti:
teams_phone_extension TeamsPhoneExtensionTelephonyBinding

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

provider enum necessario

The Microsoft Teams Phone Extension provider.

teams_phone_extension
phone_number string

The optional display phone number for the Teams resource account.

resource_account_object_id string necessario

Universally Unique Identifier

twilio TwilioTelephonyBinding

A Twilio binding owned by a voice agent.

provider enum necessario

The Twilio provider.

twilio
phone_number string necessario

The Twilio E.164 phone number.

Client error

Corpo

Content-Type: application/json
error OpenAI.Error necessario
code string | null necessario
message string necessario
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
Uno qualsiasi dei seguenti:
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 necessario

The public continuation instruction.

details OpenAI.Error[]
additionalInfo object
debugInfo object

Server error

Corpo

Content-Type: application/json
error OpenAI.Error necessario
code string | null necessario
message string necessario
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
Uno qualsiasi dei seguenti:
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 necessario

The public continuation instruction.

details OpenAI.Error[]
additionalInfo object
debugInfo object

Richiedi

POST /agents/{agent_name}/telephony/bindings HTTP/1.1

Response

Status: 201
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
it-it
Scelte sulla privacy
  • Dichiarazione di non responsabilità relativa all'intelligenza artificiale
  • Versioni precedenti
  • Blog
  • Collabora
  • Riservatezza
  • Privacy dei dati sanitari dei consumatori
  • Condizioni per l'utilizzo
  • Accessibilità
  • Marchi
  • © Microsoft 2026