Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Name

Type

Description

Required

Default value

name

string

Trunk name

yes

direction

string("in","out","all")

Trunk direction. The trunk can be incoming (value “in”), in which case incoming calls to DID can be received through the trunk, outgoing (value “out”), in which case outgoing calls can be routed through the trunk, and bidirectional (value “all”).

no

id

integerУникальный идентификатор транка. Поле только для чтения

The unique ID of the trunk. Read only.

-

-

network_permission_group_id

integerИдентификатор группы доверенных сетей, запросы из которых разрешены для данного транка. Применяется для транков с направлением in и all

Identifier of a group of trusted networks from which requests are allowed for this trunk. Applies to trunks with in and all direction

yes, if trunk direction is in or all

null

address

string

Адрес SIP-сервера, на который будет отправлен вызов согласно правилам маршрутизации. Применяется для транков с направлением out и all. Указывается в виде host:port. В качестве host может быть доменное имяAddress of the SIP server to which the call will be sent according to the routing rules. Applies to trunks with out and all directions. Specified as host:port. Host can be a domain name, ":port" опционален is optional (5060 в случае отсутствия). Если необходимо использвать протокол tcp, то  if not present). If it is necessary to use tcp protocol, then "host:port;tranport=tcp"

yes, if trunk direction is out or all

null

status_in

string("active","blocked")

Статус транка на приём входящих вызовов. Если параметр имеет значение blocked, то на попытку вызова DID данного транка система вернет ошибкуTrunk status for receiving incoming calls. If the parameter is set to blocked, then the system will return an error on an attempt to call the DID of this trunk.

no

blocked

status_out

string("active","blocked"

Статус транка на приём исходящих вызовов. Если параметр имеет значение blocked, то попытка внешнего вызова через данный транк завершится ошибкойTrunk status for receiving outgoing calls. If the parameter is set to blocked, then an attempt to make an external call through this trunk will fail.

no

blocked

sbc_mode

stringВключить

Enable (значение yes) или отключить (значение no) режим sbc для транка. Если режим SBC включен, то медиаданные для вызовов, идущих через транк, будут проходить через тот же адрес, что и SIP-сообщения“yes” value) or disable (“no” value) sbc mode for the trunk. If SBC mode is enabled, the media for calls going through the trunk will go through the same address as the SIP messages.

no

strip

integerКоличество символов, которые будут удалены из начала номера при отправке исходящего вызова через данный транк

The number of characters that will be removed from the beginning of the number when an outgoing call is sent through this trunk.

no

null

pri_prefix

stringПрефикс, который будет добавлен в начало номера при отправке исходящего вызова через данный транк

The prefix that will be added to the beginning of the number when sending an outgoing call through this trunk.

no

null

auth_username

stringИмя пользователя для авторизации при отправке исходящего вызова через данный транк

The username for authorization when sending an outgoing call through this trunk.

no

null

auth_pass

stringПароль пользователя для авторизации при отправке исходящего вызова через данный транк

The user password for authorization when sending an outgoing call through this trunk.

no

null

from_username

stringИмя пользователя в поле From при отправке исходящего вызова через данный транк

The username in the “From” field when sending an outgoing call through this trunk.

no

null

from_domain

stringДомен в поле From при отправке исходящего вызова через данный транк

The domain in the “From” field when sending an outgoing call through this trunk.

no

null

insert_internal_user

string("yes","no")Если

параметр имеет значение If the parameter is set to "yes", то при отправке исходящего вызова через транк на внешний SIP-сервер в пакет INVITE будет добавлен заголовок Ringme-user, который будет содержать полное имя добавочного, с которого осуществляется вызов, в формате с префиксом домена: префикс_домена*префикс_клиента*номер_добавочного

no

yes

Image Removed

then when sending an outgoing call through the trunk to an external SIP server, the Ringme-user header will be added to the INVITE packet, which will contain the full name of the extension from which the call is made, in the format with a domain prefix: domain_prefix*client_prefix*extension_number

no

yes

super_trunk_ip

array(string)

Список адресов в виде A list of addresses in the form ip[:port] для проверки, могут ли вызовы с них использоваться для вызова на любой DID или добавочный. Адреса уникальны в пределах всей АТСto check if calls from them can be used to call to any DID or extension. Addresses are unique within the entire PBX.

no

[]

any_extension

string({"yes","no")

Если вызов из If the call is from "super_trunk_ip", на глобальный номер добавочного to a global extension (xxxx*xxx*xxx), то он разрешел при значении параметра then it is allowed if the parameter is set to "yes".

no

no

any_did

string("yes","no")

Если вызов из If the call is from "super_trunk_ip", на номер to a DID , то он разрешел при значении параметра number, then it is allowed if the parameter value is "yes".

no

no

channel_limit

integer

Максимально количество одновременных каналов, используемых транком. Суммируются входящие/исходящие. При значении "0" ограничение отсутствуетThe maximum number of simultaneous channels used by the trunk. Incoming/outgoing are summarized. With a value of "0" there is no limit.

no

0

in_anumber_rule_id

integerПри входящем вызове из транка, преобразует А-номер согласно соответствующим правилам  набора

On an incoming call from the trunk, converts the A-number according to the corresponding dialing rules

no

null

out_anumber_rule_id

integer

При вызове, уходящем в транк, преобразует A-номер (From field) согласно соответствующим правилам  набораOn a call going to the trunk, converts the A-number (“From” field) according to the corresponding dialing rules

no

null

use_dns_srv

boolean

При включении опции "use_dns_srv", если параметр "address" транка указан в виде домена без порта, то анализируются SRV записи этого домена и в случае неудачи исходящего вызова по одному адресу (таймаут), вызов будет отправлен на другой. Таймаут доступности каждого адреса устанавливается в 6 секунд (вместо 30 при use_dns_srv=false

Например, "address" = srvtest.ucom4b.com 

  1. для srvtest.ucom4b.com

$ host -t srv _sip._udp.srvtest.ucom4b.com
_sip._udp.srvtest.ucom4b.com has SRV record 10 50 5067 srvpbx1.ucom4b.com.
_sip._udp.srvtest.ucom4b.com has SRV record 20 50 5068 srvpbx2.ucom4b.com.
Тогда в случае недоступности srvpbx1.ucom4b.com:5067 вызов будет направлен на srvpbx1.ucom4b.com:5068 (Priority 10 и 20 соответственно)

  1. для srvtest.ucom4b.com

$ host -t srv _sip._udp.srvtest.ucom4b.com
_sip._udp.srvtest.ucom4b.com has SRV record 20 50 5067 srvpbx1.ucom4b.com.
_sip._udp.srvtest.ucom4b.com has SRV record 20 50 5068 srvpbx2.ucom4b.com.
вызовы будут уходить и резервироваться по SRV записям случайным образом (Priority одинаковый)

  1. для srvtest.ucom4b.com есть более одной A записи, но нет SRV записей: вызовы будут уходить и резервироваться по А записям случайным образом


Важно: если "address" указан с портом, то логика резервирования никак не работает: вызов отправляется на первую попавшуюся А запись домена.

no

false

...