HTTPS API

Key Word

Value

Mandatory

Type

Note

Request Parameters

cookie

yes

string

Returned value after login. All requests must include this value. If no cookie is included, error code -6 will be returned.

user_name

yes

string

The extension number

Key Word

Value

Mandatory

Type

Note

Request Parameter

cookie

yes

string

Returned value after login. All requests must include this value. If no cookie is included, error code -6 will be returned.

page

no

int

Retrieves the extensions on the specified page. This page is based on the value for the item_num parameter. If item_num is unspecified, all items will be on page 1.

item_num

no

int

Maximum number of extensions to retrieve for the query. If unspecified, all extensions will be returned. This also indicates the number of items per page for the page parameter

sord

acs, desc

no

string

Sorting method. acs stands for ascending, and desc stands for descending.

sidx

no

string

Sort according to the index.

options

extension, account_type, fullname, out_of_service, status, addr, urgemsg, newms, oldmsg

no

string

Specify the extension details to retrieve and display. Multiple items can be entered and must be separated by commas. If unspecified, all details will be returned.

Successful response:

status

0

yes

int

Successful response, status is 0

account

yes

Json array

Account List

total_item

yes

int

Total number of items on the list

total_page

yes

int

Total number of items on the list

page

yes

int

Page the extensions are on.

extension

yes

string

Extension number.

account_type

SIP, IAX, FXS, SIP(Web RTC)

no

string

Extension type.

fullname

no

string

Caller ID Name, which consists of first_name, space, and last name.

out_of_service

Yes, no

no

string

Indicates whether the extension is out of service

status

Idle, InUse, Busy, Unavailable, Ringing

no

string

Just “Extension status” is fine.

addr

no

string

IP address and port number of registered extensions. If there are multiple devices under the same account, they will be separated by commas.

urgmsg

no

int

Number of urgent messages.

newmsg

no

int

Number of new messages.

oldmsg

no

int

Number of old messages.

presence_status

unavailable, available,

away, chat, dnd, userdef

no

string

Presence status. Only SIP extensions support presence status.

presence_def_script

Custom presence status. If presence_status is userdef, this parameter’s value will be used.

user_name

no

string

Typically the same as extension number.

email_to_user

no

string

Indicates whether or not to send email notifications to an extension’s configured email address if the extension gets updated.

Failed response:

status

yes

int

Please see the error code list for more details.

Key Word

Value

Mandatory

Type

Note

Request Parameter

cookie

yes

string

Returned value after login. All requests must include this value. If no cookie is included, error code -6 will be returned.

extension

Existing extension number

yes

string

Specify which extension's configuration to retrieve.

Successful response

status

0

yes

int

The response is successful, status is 0.

extension

no

Json obj

The specific configuration of the extension.

account_type

SIP, IAX, FXS, SIP(WebRTC)

no

string

Extension type.

fullname

no

string

Caller ID Name, which consists of first_name, space, and last name.

hasvoicemail

yes, no

no

string

Indicates whether voicemail is enabled or disabled.

cidnumber

no

string

Caller ID of incoming calls.

secret

no

string

SIP/IAX password.

vmsecret

no

string

Voicemail password.

skip_vmsecret

Yes, no

no

string

Indicates whether an extension will need to enter a password when dialing into voicemail.

ring_timeout

no

int

Extensions’ ring timeout. If unspecified, the system ring timeout will be used. Default is 60 seconds.

auto_record

all, external, internal, off

no

string

Auto-recording.

all：all incoming calls to the extension will be recorded

external: only calls to external numbers will be

recorded.

internal: only calls to internal numbers will be

recorded.

off: No calls will be recorded.

encryption

no, yes, support

no

string

SRTP encryption mode. Set whether to turn on SRTP mode to encrypt RTP streams.

Support: Enable but not forced.

faxdetect

no, yes

no

string

Configure the mode of using fax. There are 2 available settings. The default is “no”.

no：Disable fax related features.
yes (Fax detection): Fax signals from this user or the trunk can be detected during a call. The received fax will be sent to the email address set for the user. If the user's email address is not configured, the fax will be sent to the default email address set on the fax page.

sendtofax

yes, no

no

string

Indicates whether fax will also be sent to the extension’s configured email address when receiving a fax call.

strategy_ipacl

0,1,2

no

int

Indicates the device’s ACL policy.
0(Allow All)：Any IP address can register to this extension.
1(Local Network): Only IP addresses in the configured subnets can register to this extension. Devices on the UCM’s subnet is allowed by default. Up to 10 subnets can be added.
2 (Special IP address): This option seems to have been merged with 1 (Local Network) in 1.0.20.x

local_network1

no

string

local_network1-10 are the subnets that are allowed to register to the extension when 1 is configured as the value for strategy_ipacl.

local_network2

no

string

local_network3

no

string

local_network4

no

string

local_network5

no

string

local_network6

no

string

local_network7

no

string

local_network8

no

string

local_network9

no

string

local_network10

no

string

specific_ip

no

string

When the policy is 2, that is, Special IP Address, Format is xxx.xxx.xxx.xxx or xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx.

allow

ulaw, alaw, gsm, g726, g722, g729, h264, ilbc, g726aal2, adpcm, g723, h263, h263p, vp8, opus, h265, rtx

no

string

The extension’s supported codecs. Several codecs can be configured for a single extension.

dnd

yes, no

no

string

Indicates DND status.

If set to yes, all calls will be ignored, and the extension’s call forwarding rules will not take effect

dnd_timetype

0,1,2,3,4,5,6,8

no

int

The time conditions where DND status will be enabled.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

permission

internal，internal-local，internal-local-national，internal-local-national-international

no

string

Outbound call permissions of the extension.

internal：Internal

internal-local：Local

internal-local-national：Nationwide

internal-local-national-international：International

nat

yes, no

no

string

Indicates whether the extension is behind a NAT. If the UCM is using a public IP address to communicate with devices behind NAT, one-way audio issues may occur if this option is not enabled, NAT is not configured properly, or if SIP/RTP ports are not supported by the firewall.

bypass_outrt_auth

no, yes, bytime

no

string

Indicates whether the extension can skip password authentication when dialing out of a trunk

yes: Users will not need to enter a password when dialing out of a trunk.

bytime: Users will not need to enter a password when dialing out of a trunk only during the specified time condition.

skip_auth_timetype

0,1,2,3,4,5,6,8

no

int

Time condition where the extension will be able to dial out of a trunk without needing to enter a password.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

t38_udptl

yes, no

no

string

Indicates whether T.38 support is toggled on or off

directmedia

yes, no

no

string

Indicates whether direct media is enabled or not.

No: The PBX will route RTP media streams from SIP

endpoints through itself.

Yes: The PBX will attempt to redirect RTP media streams so that they are only between caller and callee. Note: It is not always possible for the UCM to negotiate endpoint-to endpoint media routing.

dtmfmode

rfc4733, info, inband, auto

no

string

Indicates the DTMF signaling sent from the extension

Info: Signaling is transmitted through SIP messages.

Inband: Signaling is transmitted in audio streams. Requires PCMU and PCMA codec support.

RFC4733: Signaling is transmitted as audio but is encoded separately from the audio stream.

Auto: Selects the signaling to use based on negotiation.

Signaling is preferred in the following priority: RFC4733, Inband, Info

enable_qualify

yes, no

no

string

Indicates whether keep-alive is enabled for this extension.

Yes: The PBX periodically sends SIP OPTION messages to the extension endpoint to monitor and maintain UCM’s connection to the endpoint.

qualifyfreq

no

int

Keep-alive Frequency.

Indicates how often keep-alive messages are sent to this extension’s endpoints.

authid

no

string

Authentication ID.

This is the SIP service subscriber's ID used for authentication. If not configured, the Extension Number will be used for authentication.

tel_uri

disabled, user_phone, enabled

no

string

TEL URI.

Enabled: TEL URI and Remove OBP from Route cannot be enabled at the same time. "Tel:" will be used instead of "SIP:" in the SIP request.

User_Phone: If the phone has an assigned PSTN telephone number, this field should be set. A "User=Phone" parameter will then be attached to the Request-Line and "TO" header in the SIP request to indicate the E.164 number.

enablehotdesk

no, yes

no

string

Indicates whether hotdesking is enabled for this extension.

Yes: SIP Password will accept only alphanumeric characters; Extension will be used for AuthID.

user_outrt_passwd

no

string

Dial Trunk Password

Password that must be entered by the extension to dial out.

out_of_service

yes, no

no

string

Indicates whether the “Disable this Extension” option is toggled on or off for this extension.

Yes: The extension is disabled.

No: The extension is enabled.

mohsuggest

default，ringbacktone_default，……

no

string

Music on Hold.

Indicates the Music on Hold playlist to use when putting parties on hold.

en_ringboth

no，yes

no

string

Ring Simultaneously: Indicates whether the “Ring Simultaneously” option is toggled on or off for this extension

If enabled, both this extension and the configured external number will be rung at the same time. If the calling the external number requires the use of a

register trunk, the register trunk’s number will be displayed to the caller. Failover trunks cannot be used for Ring Simultaneously calls.

external_number

no

string

The external number configured for Ring Simultaneously. Hyphens (-) are ignored

use_callee_dod_on_fwd_rb

no, yes

no

string

Indicates whether the callee’s DOD number will be used as CID for forwarded calls or Ring Simultaneously calls

use_callee_dod_on_fm

no, yes

no

string

Use Callee DOD for Follow Me

Indicates whether to the callee’s DOD number will be used as CID for Follow Me calls.

ringboth_timetype

0,1,2,3,4,5,6, 8

no

int

Time Condition for Ring Simultaneously

The time conditions when Ring Simultaneously will be used

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

enable_ldap

yes, no

no

string

Enable LDAP

Indicates whether this extension can be added to LDAP phonebooks.

max_contacts

no

int

Concurrent Registrations

The maximum allowed number of endpoints that can register to this extension. Supported values: 1-10

custom_autoanswer

no, yes

no

string

Custom Call-info for Auto Answer

Indicates whether the extension supports auto-answer when denoted in Call-info and Alert-info headers.

sca_enable

no, yes

no

string

Enable SCA

Indicates whether or not SCA is enabled for the extension

call_waiting

yes, no

no

string

emergcidnumber

no

string

Emergency Calls CID

CallerID number that will be used when calling out and receiving direct callbacks.

enable_webrtc

yes, no

no

string

Enable WebRTC Support

Indicates whether this extension supports WebRTC registration and calling.

alertinfo

none, ring1, ring2, ring3, ring4, ring5, ring6, ring7, ring8, ring9, ring10, Bellcore-dr1, Bellcore-dr2

Bellcore-dr3, Bellcore-dr4, Bellcore-dr5, custom

Alert-info

Indicates the alert-info header that will be used in the extension’s INVITE requests to specify a ring tone to be used by the UAS.

limitime

no

int

Maximum Call Duration

Indicates the maximum duration of this extension’s calls. The default value 0 means no limit.

dndwhitelist

no

string

DND whitelist

Displays the numbers that can call this extension even if it has DND enabled. Multiple numbers are separated by commas.

fwdwhitelist

no

string

Forward Whitelist

Displays the numbers that will ignore this extension’s call forwarding rules when calling in. Multiple numbers are separated by commas

callbarging_monitor

no

string

Allow call-barging

Displays the extensions that can barge in and monitor this extensions’ calls via feature code.

seamless_transfer_members

no

string

Allowed to seamless transfer

Displays the extensions that can seamlessly transfer to this extension.

sip_presence_settings

Json array

The specific configuration content of the online status of the SIP extension. The specific content needs to specify which state the presence_status is.

"sip_presence_settings": [ {

"presence_status": "available",

"cfb":"6000" ,

"cfn": null,

"cfu": null,

"cfb_timetype": 1,

"cfn_timetype": 0,

"cfu_timetype": 0,

"cfb_destination_type": "0",

"cfn_destination_type": "0",

"cfu_destination_type": "0"

}，{

"presence_status": "unavailable",

"cfb": null,

"cfn": "12345",

"cfu": null,

"cfb_timetype": 0,

"cfn_timetype": 2,

"cfu_timetype": 0,

"cfb_destination_type": "0",

"cfn_destination_type": "0",

"cfu_destination_type": "0"

}]

When available, cfb to extension 6000;

When unavailable, cfn to custom extension 12345.

presence_status

available, away, chat, dnd, userdef, unavailable

no

string

Presence status of this extension. Default is Available.

cfb

no

string

Call Forward Busy (CFB) destination.

Callers will be redirected to this number if the extension is busy.

cfn

no

string

Call Forward No Answer (CFNA) Destination

Callers will be redirected to this number if calls to the extension are not answered before ring timeout.

Note: If  unspecified, this feature is disabled.

cfu

no

string

Call Forward Unconditional (CFU) destination. Callers will always be redirected to this number.

cfb_timetype

0,1,2,3,4,5,6,8

no

string

Call forward busy based on this time condition. CFB will be active only during the selected time condition.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

cfn_timetype

0,1,2,3,4,5,6,8

no

string

Call forward no answer based on this time condition. CFNA will be active only during the selected time condition.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

cfu_timetype

0,1,2,3,4,5,6,8

no

string

Call forward unconditional based on this time condition. CFU will be active only during the selected time condition.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

cfb_destination_type

0,1,2,3,4,5,6,8

Extension type of the CFB destination. If unspecified, CFB will be disabled.0: None

1: Extension

2: Custom Number

3: Voicemail

4: Ring Group

5: Queues

6: Voicemail Group

cfn_destination_type

0,1,2,3,4,5,6,8

Extension type of the CFNA destination. If unspecified, CFNA will be disabled.

0: None

1: Extension

2: Custom Number

3: Voicemail

4: Ring Group

5: Queues

6: Voicemail Group

cfu_destination_type

0,1,2,3,4,5,6,8

Extension type of the CFU destination. If unspecified, CFU will be disabled

0: None

1: Extension

2: Custom Number

3: Voicemail

4: Ring Group

5: Queues

6: Voicemail Group

voicemail

no

Json obj

Specific Configuration of voicemail.

"voicemail": {

"vm_attach": null,

"vm_reserve": null

}

vm_attach

NULL, yes, no

no

string

Send voicemail to email

NULL: “Default”. Global voicemail settings in the Voicemail page will be used

vm_reserve

NULL, yes, no

no

string

Keep Voicemail after Emailing

Only applicable when either condition is fulfilled:

1. Edit Extension→Send Voicemail to Email is

enabled.

2.Voicemail→Voicemail Email Settings→Send

Voicemail to Email is enabled and Edit Extension→Send Voicemail to Email is set to “Default”.

Global voicemail settings in the Voicemail page will be used.

“Default”. Global voicemail settings in the Voicemail page will be used.

Failed response

status

yes

int

Please see the error code list for more details.

Key Word

Value

Mandatory

Type

Note

Request Parameter

cookie

yes

string

Returned value after login. All requests must include this value. If no cookie is included, error code -6 will be returned.

extension

Required.   2-18 digits

yes

string

Specify which extension's configuration to retrieve.

hasvoicemail

yes, no

no

string

Indicates whether voicemail is enabled or disabled.

cidnumber

no

string

Caller ID of incoming calls.

secret

no

string

SIP/IAX password.

vmsecret

no

string

Voicemail password.

skip_vmsecret

Yes, no

no

string

Indicates whether an extension will need to enter a password when dialing into voicemail.

ring_timeout

Value between 3 and 600. Can be set to “null”. When set to null, global settings will be used.

no

int

Ring Timeout

when set to NULL, the system default ring timeout is used.

auto_record

all, external, internal, off

no

string

Auto-recording.

all：all incoming calls to the extension will be recorded

external: only calls to external numbers will be

recorded.

internal: only calls to internal numbers will be

recorded.

off: No calls will be recorded.

encryption

no, yes, support

no

string

SRTP encryption mode. Set whether to turn on SRTP mode to encrypt RTP streams.

Support: Enable but not forced.

faxdetect

no, yes

no

string

Configure the mode of using fax. There are 2 available settings. The default is “no”.

no：Disable fax related features.
yes (Fax detection): Fax signals from this user or the trunk can be detected during a call. The received fax will be sent to the email address set for the user. If the user's email address is not configured, the fax will be sent to the default email address set on the fax page.

sendtofax

yes, no

no

string

Indicates whether fax will also be sent to the extension’s configured email address when receiving a fax call.

strategy_ipacl

0,1,2

no

int

Indicates the device’s ACL policy.
0(Allow All)：Any IP address can register to this extension.
1(Local Network): Only IP addresses in the configured subnets can register to this extension. Devices on the UCM’s subnet is allowed by default. Up to 10 subnets can be added.
2 (Special IP address): This option seems to have been merged with 1 (Local Network) in 1.0.20.x

local_network1

no

string

local_network1-10 are the subnets that are allowed to register to the extension when 1 is configured as the value for strategy_ipacl.

local_network2

no

string

local_network3

no

string

local_network4

no

string

local_network5

no

string

local_network6

no

string

local_network7

no

string

local_network8

no

string

local_network9

no

string

local_network10

no

string

specific_ip

IP address

no

string

When the policy is 2, that is, Special IP Address, Format is xxx.xxx.xxx.xxx or xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx.

allow

ulaw,alaw,gsm,g726,g722,g729,h264,ilbc,g726aal2,adpcm,g723,h263,h263p,vp8,opus,h265,rtx

no

string

The extension’s supported codecs. Several codecs can be configured for a single extension.

dnd

yes, no

no

string

Do Not Disturb.

yes: All calls will be ignored, and the call forward unconditional/ no answer/ busy of the extension will not take effect.

dnd_timetype

0,1,2,3,4,5,6,8

no

int

The time conditions where DND status will be enabled.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

permission

internal，internal-local，internal-local-national，internal-local-national-international

no

string

Select outbound permission.

internal：internal

internal-local：local

internal-local-national：nationwide

internal-local-national-international：international

nat

yes, no

no

string

NAT is used when UCM uses public IP and communicates with devices hidden behind a NAT network, such as a broadband router. You may encounter one-way audio problem. This type of problem is often associated with NAT configuration or SIP and RTP ports supported by the firewall.

bypass_outrt_auth

no, yes, bytime

no

string

Skip trunk authentication.

yes: When dialing an external line, the user does not need to enter a password;

bytime: dial an external line in the set time condition, the user does not need to enter a password.

skip_auth_timetype

0,1,2,3,4,5,6,8

no

int

Time condition where the extension will be able to dial out of a trunk without needing to enter a password.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

t38_udptl

yes, no

no

string

Whether to support T.38 UDPTL.

directmedia

yes, no

no

string

Whether to enable direct media.

No: the PBX will route the media streams from SIP endpoints through itself.

Yes: the PBX will attempt to redirect the RTP media streams to bypass the PBX and to go directly between caller and callee. Note: It is not always possible for the PBX to negotiate endpoint-to-endpoint media routing.

dtmfmode

rfc4733, info, inband, auto

no

string

Default mode of sending DTMF signal.

The DTMF signal is carried by the info method of SIP signaling. Inband: Requires 64kbit codec PCMU and PCMA.

Auto: Adaptive preference is for RFC2833, followed by inband.

enable_qualify

yes, no

no

string

Enable keeping-alive.

Yes: The PBX periodically sends SIP OPTION signaling to detect if the host is online

qualifyfreq

Required. Set a value between 1

and 3600.

no

int

Keep-alive Frequency.

When the host is on, set the interval of sending keep-alive messages measured in seconds.

authid

Up to 32 characters excluding

space., ;:?"()<>@,\/[]={}.

no

string

Authentication ID.

This is the SIP service subscriber's ID used for authentication. If not configured, the Extension Number will be used for authentication.

tel_uri

disabled, user_phone, enabled

no

string

TEL URI.

Enabled: TEL URI and Remove OBP from Route cannot be enabled at the same time. "Tel:" will be used instead of "SIP:" in the SIP request.

User_Phone: If the phone has an assigned PSTN telephone number, this field should be set. A "User=Phone" parameter will then be attached to the Request-Line and "TO" header in the SIP request to indicate the E.164 number.

enablehotdesk

no, yes

no

string

Support Hot-desking Mode

yes：SIP Password will accept only alphanumeric characters; Extension will be used for AuthID.

user_outrt_passwd

4-10 digits

no

string

Dial Trunk Password

Configure personal password when making outbound calls.

out_of_service

yes, no

no

string

Whether to disable this extension

yes：disable

no：enable

mohsuggest

Required: default,

ringbacktone_default, MoH playlist name, etc

no

string

Music on Hold.

Specify which Music on Hold class to suggest to the bridged channel when putting them on hold.

en_ringboth

no，yes

no

string

Ring Simultaneously

If you want the extension and external number to ring simultaneously, check this box. If you use register trunk for outbound calls, the caller will display the registered number. The outbound call will use only the main trunk. The failover trunk will not be used.

external_number

Up to 32 alphanumeric characters

and special characters +-*#

no

string

Set the external number for Ring Simultaneously. "-" is the connection character and will be ignored.

use_callee_dod_on_fwd_rb

no, yes

no

string

yes: Use the callee's DOD number as callerID on Outgoing Forwarding or Ring Simultaneously calls.

use_callee_dod_on_fm

no, yes

no

string

Use Callee DOD for Follow Me

Use the callee DOD number as CID if configured Follow Me numbers are external numbers.

ringboth_timetype

0,1,2,3,4,5,6, 8

no

int

Time Condition for Ring Simultaneously

The time conditions when Ring Simultaneously will be used

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

enable_ldap

yes, no

no

string

Enable LDAP

yes: If enabled, the extension will be added to LDAP Phonebook PBX lists.

max_contacts

Value between 1 and 10

no

int

Concurrent Registrations

The maximum endpoints which can be registered to this extension. Value: 1-10.

custom_autoanswer

no, yes

no

string

Custom Call-info for Auto Answer

yes: If checked, the invite message sent to the extension will contain a Call-info header to indicate auto answer.

sca_enable

no, yes

no

string

Enable SCA.

call_waiting

yes, no

no

string

Call waiting

yes: Allows calls to the extension even when it is already in a call. This only works if the caller is directly dialing the extension. If disabled, the CC service and busy in-call forward will not work.

emergcidnumber

2-32 alphanumeric characters

no

string

Emergency Calls CID

CallerID number that will be used when calling out and receiving direct callbacks.

enable_webrtc

yes, no

no

string

Enable WebRTC Support

Enable registration and call from WebRTC.

alertinfo

none, ring1, ring2, ring3, ring4, ring5, ring6, ring7, ring8, ring9, ring10, Bellcore-dr1, Bellcore-dr2

Bellcore-dr3, Bellcore-dr4, Bellcore-dr5, custom

Alert-info

When present in an INVITE request, the Alert-info header field specifies an alternative ring tone to the UAS.

limitime

Value between 0 and 86400

no

int

Maximum Call Duration

The maximum call duration (in seconds). The default value 0 means no limit.

dndwhitelist

no

string

DND whitelist

Multiple numbers are supported and separated by commas.

fwdwhitelist

no

string

Forward Whitelist

Set extension numbers, multiple can be separated by commas. Calls from users in the forward whitelist will not be forwarded.

callbarging_monitor

no

string

Set up Allow call-barging list. Members of the list can spy on this extension via feature codes. Multiple extensions can be set, separated by commas.

seamless_transfer_members

no

string

Set up Allow to seamless transfer list. Members of the list can seamlessly transfer via feature code. Multiple extensions can be set, separated by commas.

sip_presence_settings

Json array

The specific configuration content of the online status of the SIP extension. The specific content needs to specify which state the presence_status is.

"sip_presence_settings": [ {

"presence_status": "available",

"cfb":"6000" ,

"cfn": null,

"cfu": null,

"cfb_timetype": 1,

"cfn_timetype": 0,

"cfu_timetype": 0,

"cfb_destination_type": "0",

"cfn_destination_type": "0",

"cfu_destination_type": "0"

}，{

"presence_status": "unavailable",

"cfb": null,

"cfn": "12345",

"cfu": null,

"cfb_timetype": 0,

"cfn_timetype": 2,

"cfu_timetype": 0,

"cfb_destination_type": "0",

"cfn_destination_type": "0",

"cfu_destination_type": "0"

}]

When available, cfb to extension 6000;

When unavailable, cfn to custom extension 12345.

presence_status

available, away, chat, dnd, userdef, unavailable

no

string

Set the presence status of this extension. Default is Available. To set the transfer destination, configure call transfer.

cfb

no

string

Configure the target number to be forwarded to for Call Forward Busy(CFB).

 Incoming calls during busy time will be forwarded to the entered extension.

Corresponds to the extension number under the cfb_destination_type type.

cfn

no

string

Configure the target number to be forwarded to for Call Forward No Answer(CFN).

Incoming calls that are not answered after ring timeout will be forwarded to the entered extension.

Note: If not specified, this feature is disabled. Corresponds to the extension number under the cfn_destination_type type.

cfu

no

string

Configure the target number to be forwarded to for Call Forward Unconditional(CFU). All incoming calls will be forwarded to the entered extension unconditionally. Corresponds to the extension number under the cfu_destination_type type.

cfb_timetype

0,1,2,3,4,5,6,8

no

string

Call forward busy based on this time condition. CFB will be active only during the selected time condition.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

cfn_timetype

0,1,2,3,4,5,6,8

no

string

Call forward no answer based on this time condition. CFNA will be active only during the selected time condition.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

cfu_timetype

0,1,2,3,4,5,6,8

no

string

Call forward unconditional based on this time condition. CFU will be active only during the selected time condition.

0：All Time

1：Office Time

2：Out of Office Time

3：Holiday

4: Out of Holiday

5：Out of office time or holiday

6：Specific time

8：Office time and out of holiday

cfb_destination_type

0,1,2,3,4,5,6

Extension type of the CFB destination. If unspecified, CFB will be disabled.0: None

1: Extension

2: Custom Number

3: Voicemail

4: Ring Group

5: Queues

6: Voicemail Group

cfn_destination_type

0,1,2,3,4,5,6

Extension type of the CFNA destination. If unspecified, CFNA will be disabled.

0: None

1: Extension

2: Custom Number

3: Voicemail

4: Ring Group

5: Queues

6: Voicemail Group

cfu_destination_type

0,1,2,3,4,5,6

Extension type of the CFU destination. If unspecified, CFU will be disabled

0: None

1: Extension

2: Custom Number

3: Voicemail

4: Ring Group

5: Queues

6: Voicemail Group

vm_attach

yes, no

If set to NULL, global setting will be used.

no

string

Send voicemail to email

NULL: the global setting will be used.

vm_reserve

Yes, no, NULL If set to NULL, global setting will be used.

no

string

Keep Voicemail after Emailing

Only applies if extension-level is enabled or global Send Voicemail to Email is enabled and extension-level is default.

NULL: the global setting will be used.

Successful response

status

0

yes

int

Successful response，status is 0

Failed response

status

yes

int

Please see the error code list for more details.

Key Word

Value

Mandatory

Type

Note

Request parameter

cookie

yes

string

Returned value after login. All requests must include this value. If no cookie is included, error code -6 will be returned.

trunk_name

yes

string

Trunk name

Host

yes

string

Host

trunk_type

Peer, register

yes

string

Trunk type

Username

Up to 64 characters

yes

string

Configure the username to authenticate with the VoIP provider.

Secret

Configure the password to authenticate with the VoIP provider. Required for register trunks.

The rest options are Same as updateSIPTrunk

Successful response

Status

0

yes

int

The response is successful, status is 0

Failed response

Status

yes

int

Please see the error code list for more details.

Key Word

Value

Mandatory

Type

Note

Request Parameter

cookie

yes

string

Returned value after login. All requests must include this value. If no cookie is included, error code -6 will be returned.

trunk

yes

string

Retrieves the configuration of the specified trunk. Please enter the trunk ID.

Successful response

status

0

yes

int

The response is successful, status is 0.

trunk

yes

Json, obj

Specific Trunk configuration.

trunk_index

yes

string

Trunk id.

allow

ulaw,alaw,gsm,g726,g729,ilbc,g722,g726aal2,adpcm,g723,h263,h263p,h264,h265,vp8,opus,rtx.

no

string

The trunk’s supported codecs

allow_outgoing_calls_if_reg_failed

yes, no

no

string

Whether outgoing calls are allowed the trunk is unable to register successfully.

auth_trunk

yes, no

no

string

Authenticate trunk.

If enabled, UCM will respond to incoming calls with 401 message to authenticate the trunk.

authid

no

string

Authenticate ID

This is the SIP service subscriber's ID used for authentication. If not configured, the Extension Number will be used for authentication.

auto_recording

no, yes

no

string

Auto record.

cc_agent_policy

native, never

no

string

To enable CC service

Control together with cc_monitor_policy.

CC service is enabled if both cc_agent_policy and cc_monitory_policy are native. It is disabled if both are set to never.

cc_max_agents

no

int

The maximum number of CCSS agents that may be allocated to this channel. In other words, this number is the maximum number of CC requests this channel is allowed to make.

cc_max_monitors

no

int

The maximum number of monitor structures which may be created for this device. In other words, this number tells how many callers may request CC services for a specific device at one time.

cc_monitor_policy

native, never

no

string

To enable CC service

Control together with cc_agent_policy.

CC service is enabled if both cc_agent_policy and cc_monitory_policy are native. It is disabled if both are set to never.

cidname

no

string

Caller ID Name

CID name for this trunk that will be used if the caller does not have CID name configured.

cidnumber

no

string

Caller ID

Number that the trunk will try to use when making outbound calls.

CID priority from highest to lowest is as follows:

From User (register trunk only) > Inbound Call CID (enable using remote CID) > Trunk CID/register trunk username (Keep Trunk CID enabled) > DOD CID(with correspond DOD configuration) > Extension CID > Register Trunk Username (for register trunk only, Keep Trunk CID disabled) > Global Outbound CID.

Note: Certain providers may ignore this CID.

dialin_direct

no, yes

no

string

Direct callback

Allows external numbers the option to get directed to the extension that last called them.

did_mode

request-line, to-header

no

string

Direct callback

Allows external numbers the option to get directed to the extension that last called them.

dtmfmode

null, rfc2833, info, inband, auto

no

string

Configures the mode for sending DTMF.

Null: Use global setting.

RFC4733 (default): DTMF is transmitted as audio in the RTP stream but is encoded separately from the audio stream. Backward-compatible with RFC2833.

Info: DTMF is transmitted through SIP signaling using info method.

Inband: DTMF is transmitted as audio and is included in the audio stream.

Auto: self-adjust

enable_qualify

yes, no

no

string

Enable Heartbeat Detection

yes：the PBX will regularly send SIP OPTIONS to check if the device is online.

encryption

no, yes, support

no

string

SRTP encryption mode

Toggles support for RTP stream encryption.

fax_intelligent_route

no

string

Enable fax intelligent routing. Set the destination to which the fax will be forwarded when a fax is detected. The following options are available:

Note: If you need to send a fax to your mailbox, make sure that the Mailbox in System is set up correctly.

fax_intelligent_route_destination

no

string

Fax destination. The destination of fax intelligent routing can only be a fax extension or an fxs extension with a fax device.

faxdetect

yes, no

no

string

Fromdomain

no

string

From domain

Configure the actual domain where the extension comes from. Can override From field. For example,"trunk.UCM6510.provider.com "is the domain name of the following From header field. sip:1234567@trunk.UCM6510.provider.com

fromuser

host

keepcid

keeporgcid

no, yes

no

string

Keep Original CID

Keep CID from the inbound call when dialing out even if option "Keep Trunk CID" is enabled. Please make sure the peer PBX at the other end supports matching user entry using the "username" field from the authentication line.

ldap_custom_prefix

no

string

LDAP Dialed Prefix

System will automatically modify the remote contacts by adding this prefix. When ldap_default_outrt is set to self-defined, use this prefix.

ldap_default_outrt

no

int

LDAP Outbound Rule

Specify an outbound rule. The PBX system will automatically modify the remote contacts by adding prefix parsed from this rule.

If null and ldap_default_outrt_prefix is configured, use custom outbound prefix. If null, no outbound prefix is added by default.

ldap_sync_enable

no, yes

no

Sync LDAP Enable

Provide and update the local LDAP contact to a remote peer automatically (SIP peer trunk only). To ensure successful synchronization, the remote peer needs to enable this service and set the same password as the local UCM.

ldap_sync_passwd

no

string

Sync LDAP Password

This is the password used for LDAP contact file encryption and decryption. The password must be the same for both peers to ensure successful synchronization.

ldap_sync_port

no

int

Sync LDAP Port

The TCP port used by this service.

nat

no, yes

no

string

Enable this setting if the UCM is using public IP and communicating with devices behind NAT.

Note 1: This setting will overwrite the Contact header of received messages, which may affect the ability to establish calls when behind NAT. Consider changing settings in PBX Settings->SIP Settings->NAT instead.

If one is experiencing one-way audio issues, please check the NAT configuration and SIP/RTP ports in the firewall.

need_register

no, yes

no

string

Whether to register on the external server.

out_maxchans

no

int

The number of current outgoing calls over the trunk at the same time. The default value 0 means no limit.

out_of_service

no

int

The number of current outgoing calls over the trunk at the same time. The default value 0 means no limit.

outboundproxy

no

string

Outbound proxy

When configured, the outbound signal will be sent to the proxy instead of the devices directly. The outbound proxy can be domain name or IP address.

pai_number

no

string

PAI Header

PAI header for the trunk formatted as “name<number>”, “<number>”, or “number”. If not configured, CID will be used instead.

passthrough_pai

yes, no

no

string

Passthrough PAI Header

If enabled and "Send PAI Header" is disabled, PAI headers will be preserved as calls pass through the UCM.

qualifyfreq

no

int

Configure the frequency (in seconds) to send SIP OPTIONS messages to check the status of the device. Default is 60.

rmv_obp_from_route

no, yes

no

string

Remove OBP from Route

If enabled, the outbound proxy URI in the Route header will be removed from SIP requests. Default setting is “No”.

secret

no

string

Password of register trunk

send_ppi

yes, no

no

string

Send PPI Header

Yes: the invite message sent to trunks will contain PPI (P-Preferred-Identity) Header.

status

Unknown, Unmonitored, Reachable, Unreachable, Registered, Unregistered, Lagged, Failed, Request Sent, Rejected, Timeout, No Authentication

no

string

tel_uri

disabled, user_phone, enabled

no

string

TEL URI

Enabled: TEL URI and Remove OBP from Route cannot be enabled at the same time. If set to "Enable", "Tel:" will be used instead of "SIP:" in the SIP request.

User_phone: If the phone has an assigned PSTN telephone number, this field should be set. A "User=Phone" parameter will then be attached to the Request-Line and "TO" header in the SIP request to indicate the E.164 number.

transport

udp, tcp, tls

no

string

Configure the SIP Transport method. Using TCP requires local TCP support; using TLS requires local TLS support.

trunk_index

no

string

Trunk ID

trunk_name

no

string

Provider name

Configure a unique label to identify the trunk when listed in outbound rules and incoming rules.

trunk_type

peer, register

no

string

Trunk type

Peer trunk or register trunk

use_dod_in_ppi

no, yes

no

string

Displays whether the DOD is being used for the PPI header.

If both use_dod_in_pi and use_origcid_in_ppi are set to “no”, CID will be used for the PPI header.

use_origcid_in_ppi