Voice

Dial from the browser softphone

Changed on

Step 2 of the browser softphone handshake: rings the browser registered with the credential from POST /v1/voice/calls/web first, and dials the target only once the browser answers, so the callee's pickup connects immediately with no ringing after they answer. The call is logged as outbound (from = your number, to = target) and recorded per the number's settings. ringTimeoutSeconds applies to the target's phone, not to the browser.

post/v1/voice/calls/web/dial

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/voice/calls/web/dial
  • Auth: HTTP bearer

Request body

tostring required

The number to call, E.164 with leading +.

credentialIdstring required

The WebRTC credential id returned by POST /v1/voice/calls/web (the registered browser).

fromNumberstring

Which of your voice-enabled numbers to call from (optional when you have one).

recordOverrideboolean
ringTimeoutSecondsinteger

Seconds to let the callee's phone ring before the call ends as no_answer. The destination carrier can end it sooner.

Response

Call originated; answer/bridge continue asynchronously.

successboolean
callIdstring
telnyxCallControlIdstring
status'dialing'
direction'outbound'
fromstring
tostring
recordingEnabledboolean

Changes

  • 664b218652beRevision changes
    • info

      added the new optional request property

    • info

      added the non-success response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status