Skip to main content

IClientOptions IClientOptions

Table of contents ​

Properties ​

Properties ​

anonymous_login ​

• Optional anonymous_login: Object

anonymous_login login options

Type declaration ​

NameTypeDescription
target_idstringThe target ID to use for the anonymous login. this is typically the ID of the AI assistant you want to connect to.
target_params?TargetParamsOptional parameters to pass to the target. These are forwarded to voice-sdk-proxy and mapped to custom headers on the SIP INVITE. See TargetParams
target_typestringA string indicating the target type, for now only ai_assistant is supported.
target_version_id?stringThe target version ID to use for the anonymous login. This is optional and can be used to specify a particular version of the AI assistant.

callReportInterval ​

• Optional callReportInterval: number

Interval in milliseconds for collecting call statistics. Stats are aggregated over each interval and stored locally until call end.

Default

5000 (5 seconds)

debug ​

• Optional debug: boolean

Enable debug mode for this client. This will gather WebRTC debugging information.


debugOutput ​

• Optional debugOutput: "file" | "socket"

Debug output option


enableCallReports ​

• Optional enableCallReports: boolean

Enable automatic call quality reporting to voice-sdk-proxy. When enabled, WebRTC stats are collected periodically during calls and posted to the voice-sdk-proxy /call_report endpoint when the call ends.

Default

true;

env ​

• Optional env: Environment

Environment to use for the connection. So far this property is only for internal purposes.


forceRelayCandidate ​

• Optional forceRelayCandidate: boolean

Force the use of a relay ICE candidate.


iceServers ​

• Optional iceServers: RTCIceServer[]

ICE Servers to use for all calls within the client connection. Overrides the default ones.


keepConnectionAliveOnSocketClose ​

• Optional keepConnectionAliveOnSocketClose: boolean

By passing keepConnectionAliveOnSocketClose as true, the SDK will attempt to keep Peer connection alive when the WebSocket connection is closed unexpectedly (e.g. network interruption, device sleep, etc).


login ​

• Optional login: string

The username to authenticate with your SIP Connection. login and password will take precedence over login_token for authentication.


login_token ​

• Optional login_token: string

The JSON Web Token (JWT) to authenticate with your SIP Connection. This is the recommended authentication strategy. See how to create one.


mutedMicOnStart ​

• Optional mutedMicOnStart: boolean

Disabled microphone by default when the call starts or adding a new audio source.


password ​

• Optional password: string

The password to authenticate with your SIP Connection.


prefetchIceCandidates ​

• Optional prefetchIceCandidates: boolean

Enable or disable prefetching ICE candidates. Defaults to true.


region ​

• Optional region: string

Region to use for the connection.


ringbackFile ​

• Optional ringbackFile: string

A URL to a wav/mp3 ringback file that will be used when you disable "Generate Ringback Tone" in your SIP Connection.


ringtoneFile ​

• Optional ringtoneFile: string

A URL to a wav/mp3 ringtone file.


rtcIp ​

• Optional rtcIp: string

RTC connection IP address to use instead of the default one. Useful when using a custom signaling server.


rtcPort ​

• Optional rtcPort: number

RTC connection port to use instead of the default one. Useful when using a custom signaling server.


trickleIce ​

• Optional trickleIce: boolean

Enable or disable Trickle ICE.


useCanaryRtcServer ​

• Optional useCanaryRtcServer: boolean

Use Telnyx's Canary RTC server