How to make an outgoing call#

An outgoing call is started with the dial method of the client, and audio transmission is started right after it. By this time, the client and the connection must already be created, see initialization.

dial accepts a phone number, a full chat ID like 79991234567@c.us or an @lid ID like 1062110180230@lid — the latter is needed when you do not have the phone number of the other party.

const phoneNumber = '79991234567'; // the number you are calling

try {
  await client.dial(phoneNumber);
  await calls.startAudioBridge();
  console.log('Call started.');
} catch (error) {
  console.error('Error starting the call:', error);
}

The order matters here: call startAudioBridge() only after dial() has completed, otherwise the server responds with the no active call error. For details, see the Audio transmission section; it also describes what to do if the bridge has not been started.

In the vanilla JavaScript example, it looks like this:

startCallButton.addEventListener('click', async () => {
  const phoneNumber = document.getElementById('phoneNumber').value;

  await client.dial(phoneNumber);
  await calls.startAudioBridge();
});

Dialing is indicated by the out-call state, and when the other party answers, the state changes to on-call — see handling call states.