Phone Terminal (/phone/)
- esnata (Unlicensed)
- Ilya Titaev
You can test API methods on the interactive API browser page and without writing code
Some of the resources described on the page may not be available by default due to the type of application (see Creating and authorizing applications).
When updating the parameters of the telephone terminal in the Bundle - several extensions for one employee, the synchronized parameters (List of synchronized parameters) will also be updated on the other telephone terminals in the “bundle“
Description of data structures
Phone Terminal Properties (PhoneProperties)
Name | Type | Mandatory | Default value | Description |
---|
Name | Type | Mandatory | Default value | Description |
---|---|---|---|---|
label | string | none |
| Displays the name of the internal number. Displayed on the called terminal for outgoing calls (if supported) |
announce_sound_upon_outgoing_call | long | none |
| ID of the sound file that will be played on an outgoing call as an information declaration |
announce_sound_upon_incoming_call | long | none |
| ID of the sound file that will be played when answering an incoming call as an information announcement. The file will be played, including when replying through the queue |
append_to_cid_name_on_transfer | string | none |
| Adding a translation attribute to the name of the conference participant that is requested and transmitted when joining the conference. It can be useful for "blind translation" to understand where the call was translated from |
auth_type | string | none | "digest" | The type of authentication of internal number requests on the SIP server. Accepts one of the values:
|
call_screening_enabled | boolean | none | false | Managing the incoming call confirmation mechanism. If the parameter is set to true, then during a call to an internal number, when you pick up the handset, the subscriber will hear information about the caller's number and the external number to which the call was made. To answer the call in this case, press the number 1, to cancel the call, hang up the phone |
conference_announce_caller_name | boolean | none | true | Local conference of the internal number *8<internal_number>. This parameter specifies whether to send the user name of the internal number that joins the local conference. The announcement does not work for invitees |
conference_end_on_exit | boolean | none | true | Local conference of the internal number *8<internal_number>. This parameter specifies whether the conference ends when the internal number that created the conference exits it. |
conference_pin | string | none |
| Local conference of the internal number *8<internal_number>. PIN code for entering the conference of other internal numbers |
external_number | string | none |
| If this parameter is defined, the SIP server sends a call there. This number can be, for example, a mobile number. The call is processed in the same way as if it came directly to the terminal (all the rules for call forwarding, conversation recordings, translation resolution, etc. work). |
geo_list | string | none |
| Sets the list of countries from which IP addresses the use of the SIP account is allowed. Countries are listed in the ISO 3166 Codes A2 format, for example "RU US BY". If the list is not specified, the resource parameter of the same name is used “Client (/client/)”. If the list is set to "*", then all countries are allowed and the client parameter is ignored |
hangup_timeout | long | none | 60 | The maximum time to wait for an internal number to respond to an incoming call, in seconds. After this time, the call is considered unanswered and the incoming call rules may be activated (if any) or a hang-up may occur |
hold_music | long | none | 0 | ID of the sound file that sounds on the other side of the dialog when the terminal puts the call on hold. If not specified, the preset system file will sound |
ignore_early_media | boolean | none | true | If this parameter is set to true, early media, such as autoresponders, will be ignored when calling the internal number. May be useful in case of external number registration or FMC application |
incoming_limit | long | none | 0 | Sets how many calls the internal number can receive at the same time: "0" - without restrictions, "1" - no more than one (analogous to turning off "call waiting"), "2" - no more than two, etc. |
network_permission_group_id | long | none | 0 | Sets the ID of the client's trusted networks for authorization on the sip server with 'auth_type':'network' or 'auth_type':'both' |
preserve_caller_id_number_att_tr | boolean | none | true | A parameter that specifies whether to pass the caller's number to the call recipient when translating a call with the *2 command (translation with accompaniment). By default, when transferring a call *2, the caller's number is placed in the caller's name, and the caller's number reflects the internal number from which the call is transferred |
record_enabled | boolean | none | true | A parameter that specifies whether to include call recording in the file. Saved files are available through the "Conversation Records" resource, disk quota-through the client properties, occupied disk space-through the "Disk Space" resource. |
record_format | string | none | None | Format of the conversation recording files. Possible options: 'mp3’ ‘' wav’, None. If the record format is not specified, the setting specified in the client configuration (resource “Client (/client/)”). The size of the recording files depends on the recording format. The full specification is given at the end of this page |
record_stereo | boolean | none | None | A parameter that specifies whether to record a conversation in stereo or mono format. Possible options: 'yes', 'no', None. If this parameter is not specified, the configuration specified in the client configuration (resource “Client (/client/)”). The size of the recording files depends on the recording format. The full specification is given at the end of this page |
record_transfer | boolean | none | true | A parameter that specifies whether to record the conversation when transferring a call (if after the transfer the call gets to another internal number with a record, the recording on the translating internal number stops). Works only when the record_enabled function is active |
record_on_transfer | boolean | none | false | By default, the internal number conversation is recorded. If the record_on_transfer function is activated, the opposite side of the conversation from the internal number is recorded. |
ringback_sound | long | none | 0 | The melody played instead of beeps (183 progress, by default - 180 Ringing (beeps)) |
static_reg_address | string | none |
| If the terminal cannot register on the server for any reason, the registration can be specified explicitly, and all calls will be directed to this address. At the same time, the terminal can continue to register on the server, but calls will still go away according to static_reg_address. Specified as address:port (for example: 8.8.8.8:5068) |
transfer_caller_id_number | string | none |
| Fixed number of the caller, which is always displayed when the call is forwarded inside the PBX (can be changed by the telephony provider when the call is forwarded further) |
vm_attach_file | boolean | none | true | This parameter specifies whether to attach a file with a voice message when sending a receipt notification. Relevant for vm_enabled |
vm_enabled | boolean | none | true | This option activates voice mail |
vm_greeting | long | none | 0 | ID of the audio file that sounds like a voicemail greeting. Relevant for vm_enabled |
vm_mailto | string | none |
| E-mail address for receiving notifications about a new voice message (multiple addresses separated by commas are possible). Relevant for vm_enabled |
intercom | long | none | None | Autoreply, when 0 is set to auto-answer immediately, 1 or more is an answer after a specified time in seconds. To disable it, set to None |
bundle | Object | none |
| bundle structure. "124" - id of additional extension ”active” - data type bool, indicates whether the additional extension is active in the bundle or not 2.bundle_id id of main extension in bundle (int) |
replace_pin | string | none | None | Secret code for the substitution functionality for extensions. Must be entered after the corresponding command on the telephone terminal. |
call_status_id | int | none | None | Extension status from Extension call statuses (/call_status/) |
call_status_set_dt | string | none | None | Date of last set extension call status Extension call statuses (/call_status/) |
transfer_after_call_end_to | string | none | None | number where the call will be transferred at the end of the conversation:
|
Example
For the internal number with the ID 54, we will set the binding of the external mobile number +79876543210:
{
"auth_type": "digest",
"hold_music": null,
"preserve_caller_id_number_att_tr": false,
"conference_pin": null,
"conference_end_on_exit": true,
"network_permission_group_id": 1,
"append_to_cid_name_on_transfer": null,
"record_stereo": false,
"incoming_limit": 1,
"vm_mailto": null,
"vm_enabled": false,
"hangup_timeout": 5,
"record_enabled": true,
"vm_attach_file": true,
"conference_announce_caller_name": true,
"announce_sound_upon_outgoing_call": null,
"vm_greeting": null,
"ignore_early_media": false,
"static_reg_address": null,
"geo_list": "RU",
"call_screening_enabled": true,
"ringback_sound": null,
"record_format": "mp3",
"transfer_caller_id_number": null,
"record_transfer": true,
"external_number": "+79876543210",
"bundle": {
"bundle_list": {
"124": {
"active": false
},
"29196": {
"active": true
}
},
"bundle_id": 3
},
"call_status_id": null,
"call_status_set_dt": null,
"transfer_after_call_end_to": null
}
Conversation recording specification
mp3_mono
Bit rate : 16.0 kb/s
Channel(s) : 1 channel
Sampling rate : 8 000 Hz
mp3_stereo
Bit rate : 32.0 kb/s
Channel(s) : 2 channels
Sampling rate : 8 000 Hz
wav_mono
Bit rate : 128 kb/s
Channel(s) : 1 channel
Sampling rate : 8 000 Hz
wav_stereo
Bit rate : 256 kb/s
Channel(s) : 2 channels
Sampling rate : 8 000 Hz
Resources of the "Internal number" section
GET /extension/{extension_id}/phone/
Get phone terminal properties
URL Parameters
Name | Type | Description |
---|
Name | Type | Description |
---|---|---|
extension_id | integer | unique identifier of the internal number, can take the value @me in the case of a user of the "internal number" type |
PUT /extension/{extension_id}/phone/
Change phone terminal properties
URL Parameters
Name | Type | Description |
---|
Name | Type | Description |
---|---|---|
extension_id | integer | unique identifier of the internal number, can take the value @me in the case of a user of the "internal number" type |
JSON parameters