Internal Numbers Group (/extension_group/)
You can test API methods on the interactive API browser page and without writing code
Some of the resources described on the page may not be available by default due to the type of application (see Creating and authorizing applications).
The resource allows you to manage groups of internal client numbers. Internal numbers groups are designed to combine the client's internal numbers into a group, which allows you to:
work with a number of resources (call recordings, voice mail, incoming faxes) at the group level. For example, you can get a list of call records for internal numbers that are in a specific group;
organize access to internal number resources by creating a user of the "internal numbers group" type. Such a user, unlike a user of the "internal number" type, can use the resources of several internal numbers, but, unlike a user of the "client" type, he can only access the resources of those internal numbers that are in his group.
Description of data structures
Name | Type | Description |
---|---|---|
id | long | Unique ID of the internal numbers group |
name | string | Name of the internal numbers group |
client_id | long | ID of the client that the group belongs to |
extra_params | string | Additional parameters |
Examples
Name of the internal numbers group
System response:
{
"id": 14,
"name": "New group of internal numbers",
"client_id": 12,
"extra_params": null
}
Placing an internal number with ID 30 in a previously created group
(for this, the internal number must be previously created):
System response:
{
"status": "active",
"domain": "sip.ringme.ru",
"create_date": "2020-03-16 12:18:08",
"name": "000*300",
"dial_rule_limit": null,
"extension_group_id": 14,
"label": "Petrov",
"caller_id_name": "Petrov P. P.",
"client_id": 12,
"extra_params": "null",
"message_did": "string",
"dial_rule_id": null,
"ani_rfc3325": false,
"type": "phone",
"id": 30,
"did_as_transfer_caller_id": null
}
Similarly, we place the previously created internal number with the ID 28 in the previously created group:
System response:
{
"status": "active",
"domain": "sip.ringme.ru",
"create_date": "2020-03-16 12:18:08",
"name": "000*301",
"dial_rule_limit": null,
"extension_group_id": 14,
"label": "Sidorov",
"caller_id_name": "Sidorov S. S.",
"client_id": 12,
"extra_params": "312",
"message_did": "string",
"dial_rule_id": null,
"ani_rfc3325": false,
"type": "phone",
"id": 28,
"did_as_transfer_caller_id": null
}
Getting a list of all internal numbers in a given group:
Getting a list of call records of internal numbers in a given group from April 1 to April 21, 2016:
Resources of the "Client" section
Resources of the "Internal numbers group" section