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 de encabezado

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 la ruta de acceso

agent_name string requerido

The name of the voice agent that owns the binding.

Parámetros de consulta

api-version string requerido

The API version to use for this operation.

Cuerpo de la solicitud

The provider-specific binding to create.

Content-Type: application/json

Uno de los siguientes:

teams_phone_extension CreateTeamsPhoneExtensionTelephonyBindingRequest

The request to create a Microsoft Teams Phone Extension binding.

provider enum requerido

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 requerido

Universally Unique Identifier

twilio CreateTwilioTelephonyBindingRequest

The request to create a Twilio binding.

provider enum requerido

The Twilio provider.

twilio

phone_number string requerido

The Twilio E.164 phone number.

Respuestas

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

Encabezados

ETag string requerido

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

Cuerpo

Content-Type: application/json

Uno de los siguientes:

teams_phone_extension TeamsPhoneExtensionTelephonyBinding

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

provider enum requerido

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 requerido

Universally Unique Identifier

twilio TwilioTelephonyBinding

A Twilio binding owned by a voice agent.

provider enum requerido

The Twilio provider.

twilio

phone_number string requerido

The Twilio E.164 phone number.

Solicitar

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

Respuesta

Status: 201
Content-Type: application/json

Status: 4XX
Content-Type: application/json

Status: 5XX
Content-Type: application/json