Get group contacts
Method |
get.group_contacts |
Description |
Getting contact groups list in address book |
Who has access |
Agent, Customer |
Parameters of request
Title |
Type |
Required |
Description |
access_token |
string |
yes |
Authentication session key |
user_id |
number |
no |
Authentication session key |
user_id |
number |
no |
Unique user ID of a customer or an agent who makes request. Is mandatory for the agent To access a list of customer users you need to use the method "get.customer_users" |
limit |
number |
no |
Number of returned records. Refer to "Paging" |
offset |
number |
no |
Offset that defines from which phone number to return "limit" of recordings. Default value is "0". Refer to "Paging" |
filter |
object |
no |
Refer to "Filtering criteria" |
fields |
array |
no |
Refer to "View returning errors" |
sort |
array |
no |
Refer to "Sorting" |
Parameters of reply
Title |
Type |
Valid value |
Filtering |
Sorting |
Description |
id |
number |
|
yes |
|
Unique ID of a contact group in address book |
name |
string |
|
yes |
yes |
Contact group name |
is_system |
boolean |
|
yes |
|
It's a system group that cannot be deleted |
List of contacts that belong to a group |
members |
array |
|
yes |
|
List of unique cintact IDs that belong to a group. |
contact_id |
number |
|
|
|
Unique contact ID refer to "get.contacts" |
contact_full_name |
string |
|
|
|
Contact full name |
JSON request structure
{
"jsonrpc":"2.0",
"id":"number",
"method":"get.group_contacts",
"params":{
"access_token":"string",
"user_id":"number",
"offset":"number",
"limit":"number",
"filter":{
},
"sort":[
{
"field":"string",
"order":"string"
}
],
"fields":[
"string"
]
}
}
JSON reply structure
{
"jsonrpc":"2.0",
"id":"number",
"result":{
"metadata":{
},
"data":[
{
"id":"number",
"name":"string",
"is_system":"boolean",
"members":[
{
"contacts_id":"number",
"contact_full_name":"string"
}
]
}
]
}
}
List of returning errors
Refer to "List of errors for methods with the verb get"