Users
Methods
AddUser
Adds a new user.
To call this method, make sure your service account has one of the following roles:
Parameters
user_name:
string
The user name in format [a-z0-9][a-z0-9_-]{2,49}
user_display_name:
string
The user display name. The length must be less than 256
user_password:
string
The user password. Must be at least 8 characters long and contain at least one uppercase and lowercase letter, one number, and one special character
application_id:
number
The application ID which a new user will be bound to. Can be used instead of the application_name parameter
application_name:
string
The application name which a new user will be bound to. Can be used instead of the application_id parameter
parent_accounting:
boolean
Optional'True' if the user will use the parent account's money, 'false' if the user will have a separate balance
user_active:
boolean
OptionalDefaults on: trueThe user enable flag
user_custom_data:
string
OptionalAny string
Returns
result:
number
1
user_id:
number
The new user ID
DelUser
Deletes the specified user(s).
To call this method, make sure your service account has one of the following roles:
Parameters
user_id:
intlist
The user ID list separated by semicolon (;). Use the 'all' value to select all users
user_name:
stringlist
The user name list separated by semicolon (;) that can be used instead of user_id
application_id:
number
OptionalDelete the specified users bound to the application ID. It is required if the user_name is specified
application_name:
string
OptionalDelete the specified users bound to the application name. Can be used instead of the application_id parameter
Returns
result:
number
1
SetUserInfo
Edits the user.
To call this method, make sure your service account has one of the following roles:
Parameters
user_id:
number
The user to edit
user_name:
string
The user name that can be used instead of user_id
application_id:
number
OptionalThe application ID. It is required if the user_name is specified
application_name:
string
OptionalThe application name that can be used instead of application_id
new_user_name:
string
OptionalThe new user name in format [a-z0-9][a-z0-9_-]{2,49}
user_display_name:
string
OptionalThe new user display name. The length must be less than 256
user_password:
string
OptionalThe new user password. Must be at least 8 characters long and contain at least one uppercase and lowercase letter, one number, and one special character
parent_accounting:
boolean
OptionalSet 'true' to use the parent account's money, 'false' to use a separate user balance
user_active:
boolean
OptionalDefaults on: trueThe user enable flag
user_custom_data:
string
OptionalAny string
Returns
result:
number
1
GetUsers
Shows the users of the specified account.
To call this method, make sure your service account has one of the following roles:
Parameters
application_id:
number
The application ID to filter
application_name:
string
The application name part to filter
skill_id:
number
OptionalThe skill ID to filter
excluded_skill_id:
number
OptionalThe excluded skill ID to filter
acd_queue_id:
number
OptionalThe ACD queue ID to filter
excluded_acd_queue_id:
number
OptionalThe excluded ACD queue ID to filter
user_id:
number
OptionalThe user ID to filter
user_name:
string
OptionalThe user name part to filter
user_active:
boolean
OptionalThe user active flag to filter
user_display_name:
string
OptionalThe user display name part to filter
with_skills:
boolean
OptionalDefaults on: falseSet true to get the bound skills
with_queues:
boolean
OptionalDefaults on: falseSet true to get the bound queues
acd_status:
stringlist
OptionalThe ACD status list separated by semicolon (;) to filter. The following values are possible: OFFLINE, ONLINE, READY, BANNED, IN_SERVICE, AFTER_SERVICE, TIMEOUT, DND
showing_skill_id:
number
OptionalThe skill to show in the 'skills' field output
count:
number
OptionalDefaults on: 20The max returning record count
offset:
number
OptionalDefaults on: 0The first N records will be skipped in the output
order_by:
string
OptionalDefaults on: user_nameThe following values are available: 'user_id', 'user_name' and 'user_display_name'
return_live_balance:
boolean
OptionalDefaults on: trueSet true to get the user live balance
Returns
result:
The UserInfoType records
total_count:
number
The total found user count
count:
number
The returned user count
TransferMoneyToUser
Transfer the account's money to the user or transfer the user's money to the account if the money amount is negative.
To call this method, make sure your service account has one of the following roles:
Parameters
user_id:
intlist
The user ID list separated by semicolon (;). Use the 'all' value to select all users
user_name:
stringlist
The user name list separated by semicolon (;) that can be used instead of user_id
amount:
decimal
The money amount, $. The absolute amount value must be equal or greater than 0.01
application_id:
number
OptionalThe application ID. It is required if the user_name is specified
application_name:
string
OptionalThe application name that can be used instead of application_id
currency:
string
OptionalThe amount currency. Examples: RUR, EUR, USD
strict_mode:
boolean
OptionalDefaults on: trueReturns error if strict_mode is true and a user or the account hasn't enough money
user_transaction_description:
string
OptionalDefaults on: From account/To accountThe user transaction description
account_transaction_description:
string
OptionalDefaults on: From user: ${user_name}/To user: ${user_name}The account transaction description. The following macro available: ${user_id}, ${user_name}
Returns
result:
number
1
balance:
decimal
The new account balance