Ring groups

List ring groups.

Retrieve a collection of ring groups.

GEThttp://127.0.0.1:8888/api/ring_groups

Query parameters

Response

Body

countinteger (int64)

Total number of resource.

Example: 100

itemsarray of object

Request

const response = await fetch('http://127.0.0.1:8888/api/ring_groups', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "count": 100,
  "items": [
    {
      "id": {},
      "name": "text",
      "extension_number": "text",
      "ring_strategy": "RING_SIMULTANEOUSLY"
    }
  ]
}

PreviousDestroy NextAgents

Update a ring group

POSThttp://127.0.0.1:8888/api/ring_groups/{id}

Path parameters

id*all of

The unique ID of ring group.

Body

namestring

The name of ring group.

ring_timeinteger (int32)

Duration that each extension will ring, in seconds.

ring_strategyenum

Ring strategy:
Can be either:

RING_SIMULTANEOUSLY: Ring all available members of the group simultaneously.
PRIORITIZED_HUNT: Ring each available member of the group serially in the configured order.
CYCLIC_HUNT: Ring each available member of the group serially, ring the member that hasn't been rung from a call from this group in the longest amount of time first.
LEAST_WORKED_HUNT: Ring each available member of the group serially, ring the member that hasn't answered a call from this group in the longest amount of time first.
PAGING_INTERCOM: Ring all available members of the group simultaneously and add an auto answer indication to the calls in order to invoke a page.
SKILL_BASED_ROUTING_PRIORITIZED_HUNT: The call assign to the agents in the level "1" skill group first,
and move on to the less experienced agents in subsequent skill groups, if the call is not answered in current skill group.
Ring each available member of the group serially in the configured order.
SKILL_BASED_ROUTING_CYCLIC_HUNT: The call assign to the agents in the level "1" skill group first,
and move on to the less experienced agents in subsequent skill groups, if the call is not answered in current skill group.
Ring each available member of the group serially, ring the member that hasn't been rung from a call from this group in the longest amount of time first.
SKILL_BASED_ROUTING_LEAST_WORKED_HUNT: The call assign to the agents in the level "1" skill group first,
and move on to the less experienced agents in subsequent skill groups, if the call is not answered in current skill group.
Ring each available member of the group serially, ring the member that hasn't answered a call from this group in the longest amount of time first.

RING_SIMULTANEOUSLYPRIORITIZED_HUNTCYCLIC_HUNTLEAST_WORKED_HUNTPAGING_INTERCOMSKILL_BASED_ROUTING_PRIORITIZED_HUNTSKILL_BASED_ROUTING_CYCLIC_HUNTSKILL_BASED_ROUTING_LEAST_WORKED_HUNT

skip_busy_memberboolean

Indicates if members on call would be skipped.

enable_paidboolean

Whether to add ring group information into P-Asserted-Identity header.

enable_pridboolean

Whether to add ring group information into Remote-Party-ID header.

extension_number_as_to_headerboolean

Whether to user extension number as invite To header.

no_answer_forward_ruleobject

outbound_caller_idsarray of object

A collection of outbound caller IDs.

Response

Request

const response = await fetch('http://127.0.0.1:8888/api/ring_groups/{id}', {
    method: 'POST',