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.

Parâmetros do cabeçalho

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.

Parâmetros de caminho

agent_name string obrigatório

The name of the voice agent that owns the binding.

Parâmetros de consultas

api-version string obrigatório

The API version to use for this operation.

Corpo do Pedido

The provider-specific binding to create.

Content-Type: application/json

Um dos seguintes:

teams_phone_extension CreateTeamsPhoneExtensionTelephonyBindingRequest

The request to create a Microsoft Teams Phone Extension binding.

provider enum obrigatório

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 obrigatório

Universally Unique Identifier

twilio CreateTwilioTelephonyBindingRequest

The request to create a Twilio binding.

provider enum obrigatório

The Twilio provider.

twilio

phone_number string obrigatório

The Twilio E.164 phone number.

Respostas

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

Cabeçalhos

ETag string obrigatório

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

Corpo

Content-Type: application/json

Um dos seguintes:

teams_phone_extension TeamsPhoneExtensionTelephonyBinding

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

provider enum obrigatório

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 obrigatório

Universally Unique Identifier

twilio TwilioTelephonyBinding

A Twilio binding owned by a voice agent.

provider enum obrigatório

The Twilio provider.

twilio

phone_number string obrigatório

The Twilio E.164 phone number.

Pedir

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