dial

View as MarkdownOpen in Claude
1dial(destination, options?): Promise<Call>

Places an outbound call to the given destination.

Waits for authentication before dialing. Media options are merged from saved preferences, destination query parameters (e.g. ?channel=video), and the provided options (highest priority).

Returns a Call in 'ringing' state. Subscribe to Call.status$ to track progression through 'connected''disconnected'.

Parameters

destination
string | AddressRequired

Address URI string (e.g. '/public/my-room') or Address instance.

options
DialOptions

Media and dial options (audio/video, device constraints). Overrides defaults. See DialOptions.

Returns

Promise<Call>

The created Call instance.

Throws

If authentication is not complete or call creation fails.

Examples

1const call = await client.dial('/public/conference', {
2 audio: true,
3 video: true,
4});
5call.status$.subscribe(status => console.log('Call:', status));