This resource is intended for creating and managing PBX clients.
Description of the resource fields
Name | Type | Description | Required | Default value |
---|---|---|---|---|
|
| Client name | True | |
|
| Client dealer ID. The dealer defines general settings for all his clients, such as routing rules, various limits, dial rules, preferred media servers, and others. | True | |
|
| Client domain ID. All client extensions have numbers in the format client_prefix*extension_name@client_domain. | True | |
|
| Client email address | True | |
|
| Client prefix. All client extensions have numbers in the format. client_prefix*extension_name@client_domain. Read only. | - | - |
|
| Unique client id. Read only. | - | - |
|
| Creation date of the client in the format: YYYY-MM-DD HH:MM:SS. Read only. | - | - |
|
| The length of client extension numbers. Can be 2, 3, or 4. Cannot be changed after the client has been created. | False | 3 |
|
| Client status. Can take the values active and blocked. If the blocked status is set, the client cannot receive and make calls, register, and use the REST API. | False | active |
|
| Client Time Zone | False | Time Zone of the system |
|
| Enable (value yes) or disable (value no) the presence service for the client. If the service is enabled, сlient extensions can subscribe to the events of the presence and dialog. | False | no |
|
| Enable (value yes) or disable (value no) sbc mode for the client. If SBC mode is enabled, media data for the client extensions will go through the same address as SIP messages. SBC mode can be used when the client's firewall only allows connection to one address. If the field value is null, the dealer setting is used. | False | null |
|
| Id of the list of routing rules for outgoing client calls. If value is null, the dealer's routing list will be used. | False | null |
|
| Using a short caller ID number for calls between client extensions. If the setting is enabled (value yes), then when making calls from an extension client to another extension of the same client, the From field will contain the short name of the extension without the client prefix (100@sip.ringme.ru) instead of full extension name (000*100@sip.ringme.ru). | False | no |
|
| Client language. Sound files of voicemail greetings, translation, conference control sounds are played in the client's language. If value is null, the PBX's global installation language is used. | False | null |
|
| Disk quota in bytes for storing conversation records, voicemail messages, and incoming fax messages. When the quota is exhausted, conversations will not be recorded, voice messages will be saved, and faxes will not be received. | False | 0 |
|
| The limit on the number of simultaneous registrations of one client extension. A value of 0 means that each new registration will cancel the previous one, with values greater than zero, when the registration limit is reached, new ones will be rejected. | False | 0 |
|
| The limit on the number of simultaneous client calls. If null, the dealer's limit will be used. | False | null |
|
| The limit on the number of client extensions. If null, the global limit is used. | False | null |
|
| The limit on the number of extension groups. If null, the global limit is used. | False | null |
|
| The limit on the number of sound files uploaded by the client. If null, the global limit is used. | False | null |
|
| The limit on the number of queue agents per client extension. If null, the global limit is used. | False | null |
|
| The limit on the number of external queue agents. If null, the global limit is used. | False | null |
|
| The limit on the number of rules in one IVR context option. If null, the global limit is used. | False | null |
|
| The limit on the number of options in one IVR context option. If null, the global limit is used. | False | null |
|
| The limit on the number of contexts in one extension of type IVR. If null, the global limit is used. | False | null |
|
| The limit on the number of incoming call rules per extension. If null, the global limit is used. | False | null |
|
| The limit on the number of client dial rules. If null, the global limit is used. | False | null |
|
| The limit on the number of users of type "extension". If null, the global limit is used. | False | null |
|
| The limit on the number of users of type "extension group". If null, the global limit is used. | False | null |
|
| The limit on the number of users of type "client". If null, the global limit is used. | False | null |
|
| The limit on the number of client time intervals. If null, the global limit is used. | False | null |
|
| The limit on the number of event handlers per extension. If null, the global limit is used. | False | null |
|
| The limit on the number of client API applications. If null, the global limit is used. | False | null |
|
| The limit on the number of network permission lists, which are used for authorization and registration of extensions with network and both authorization types. If null, the global limit is used. | False | null |
|
| A string field where any information about the client can be stored, for example, about the services connected to him. The field is not available to the client. | False | null |
|
| Comment about the client. Can be used to save any information about the client. The field is not available to the client. | False | null |
|
| A string field for any additional information about the client. This field is read-only for the client. | False | null |
|
| Client type, information field. The F value means an individual, the J value means a legal entity. | False | F |
|
| Contact persons of the client, information field. | False | null |
|
| Contact phone numbers of the client, information field. | False | null |
|
| Legal address of the client, information field. | False | null |
|
| Specifies a list of countries whose IP addresses are allowed to use a SIP account. Countries are listed in ISO 3166 Codes A2 format, for example: "RU US BY". If the list is not specified, then the value defined by the service provider is used. If the list has the value "*", then all countries are allowed and the service provider parameter is ignored | False | null |
|
| The actual address of the client, information field. | False | null |
|
| It is used to avoid call loss during “blind transfer”. Works only for calls within one PBX. All "blind transfers" within the PBX between the phone terminal will be returned if this parameter is set to true and in case of failure. However, for the best user experience, it is recommended to use "attended transfer" instead of “blind transfer”. If the specified bl_xfer_return_timeout parameter is missing, the call will return by the timeout (hangup_timeout) of the phone terminal to which the “blind transfer” was made. | False | null |
|
| Only if blink_transfer_return is set to true this timeout will be parsed, otherwise this parameter will be ignored. If blink_transfer_return is set to true and bl_xfer_return_timeout is specified in seconds - when blindly transferring to a phone terminal, its timeout (hangup_timeout) will be ignored, instead it the value bl_xfer_return_timeout will be used. | False | null |
|
| It is used for voice notification of the result of a call during an outgoing call. If there are no specified codes in outg_call_VR_code_list, nothing will be played. | False | null |
|
| This list will only be used when outg_call_VR_on_fail is set to true. The list must contain comma-separated error interpretations (Enumiration). Example: “USER_BUSY,NO_USER_RESPONSE,NO_ANSWER” | False | null |
Resources section "Admin"
POST /admin/client/
Create a new client
JSON parameters
Response fields
GET /admin/client/
Get a list of the clients of the system. It is possible to filter the results using request fields.
Request parameters
Name | Type |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Response fields
PUT /admin/client/{client_id}
Update a client by id
URL parameters
Name | Type |
---|---|
|
|
JSON parameters
Response fields
GET /admin/client/{client_id}
Get a client by id
URL parameters
Name | Type |
---|---|
|
|
Response fields
DELETE /admin/client/{client_id}
Delete a client. If the delete_dids request parameter is passed and it is set to true, then the client dids will be deleted from the system. Otherwise, they will be unassign from the removed client.
URL parameters
Name | Type |
---|---|
|
|
Request parameters
Name | Type | Default |
---|---|---|
|
| false |