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.

Parametry nagłówka

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.

Parametry ścieżki

agent_name string wymagane

The name of the voice agent that owns the binding.

Parametry zapytań

api-version string wymagane

The API version to use for this operation.

Treść żądania

The provider-specific binding to create.

Content-Type: application/json

Jedna z następujących:

teams_phone_extension CreateTeamsPhoneExtensionTelephonyBindingRequest

The request to create a Microsoft Teams Phone Extension binding.

provider enum wymagane

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 wymagane

Universally Unique Identifier

twilio CreateTwilioTelephonyBindingRequest

The request to create a Twilio binding.

provider enum wymagane

The Twilio provider.

twilio

phone_number string wymagane

The Twilio E.164 phone number.

Odpowiedzi

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

Nagłówki

ETag string wymagane

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

Treść

Content-Type: application/json

Jedna z następujących:

teams_phone_extension TeamsPhoneExtensionTelephonyBinding

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

provider enum wymagane

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 wymagane

Universally Unique Identifier

twilio TwilioTelephonyBinding

A Twilio binding owned by a voice agent.

provider enum wymagane

The Twilio provider.

twilio

phone_number string wymagane

The Twilio E.164 phone number.

Żądanie

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