Send a new voice call from a FoneNumber to a recipient phone number.
This will place a call to the given to phone number, with a caller ID corresponding to the given fonenumber. When the call connects, the API returns with the call ID, and the destination identified by service_id will be connected.
US and International Dialing
• All non-numeric characters in a phone number are ignored; a value like "(321) 499-1008" will be interpreted as 3214991008.
• When calling a number within the United States, use 1+10 digits: 13214991000
• For international dialing: 011+(country code)+digits: 01149894567898
In this example, '49' is the country code for Germany)
Notes
to
toA valid phone number (7 to 15 digits long) or a configured Speed Dial (1 to 6 digits long).
service_type
service_typeThe to parameter contains the corresponding setting for the destination.
| Type | Value | Example | Note |
|---|---|---|---|
| Device | The ID for the destination device | 987123543678 | Use the Get Devices endpoint to get the desired device ID. |
| VoiceMail | The ID for the destination VoiceMail | VM7878452661 | Use the Get Voicemails endpoint to get the desired voicemail ID. |
| SoundFile | A valid URL | https://www.example.com/file.wav | URL for sound file to play. See below for more information. |
| TTS | Text String | Hello, this is a test call | Text-to-speech. See below for more information. |
| Phonenumber | Telephone number | 3215551111 | Valid 7 to 15 digit telephone number |
TTS: Text-to-speech supports the Speech Synthesis Markup Language (SSML) for improved control over how the text is read. Official documentation is provided at the W3C SSML page.
SoundFile: Currently, only WAV files accessible by the given URL are supported. Support for uploaded files and other formats is coming soon.
service_id
service_idCalls can be connected to one of several destination types: a configured and registered Device (e.g. SIP handset, Fractelfone mobile app, or WebRTC endpoint), a configured VoiceMail box, a SoundFile URL, or to another PhoneNumber. There is also an option to set the destination type to TTS (text-to-speech), in which the message specified by the to field is read out via speech synthesis. Use the type parameter to specify the type of call that needs to be made.
Response Properties
| Property | Type | Description |
|---|---|---|
| call | object | Call object. |
Making calls may result in additional charges and fees to your account.