Phone Terminal (/phone/)

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:

  • digest - using password

  • network - only from the predefined networks

  • both- using password from the predefined networks

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.
With the record_on_transfer function inactive, recording will stop when the internal number hangs up, and with the record_on_transfer function active, it will stop only when the opposite side of the conversation hangs up

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_list": null, "bundle_id": null
}

bundle structure.
Contains:
1. bundle_list
bundle_list is an Object datatype where additional extensions from the bundle are written. Example: { "124": { "active": false}, "29196": { "active": true}}

"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:

  1. in the case of an incoming call - transfer the caller if the called person hangs up

  2. in the case of an outgoing call, transfer the called number if the caller hangs up first

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

See Phone Terminal Properties (PhoneProperties)