Skip to content
SIP.IO
DocsStart free

Ring Groups

A ring group rings several members for the same call. Use it for a small team where anyone can pick up (a front desk, a sales pod, an on-call rotation) when you don’t need the queuing, skills, and reporting of a full ACD queue.

{
"id": "rg_01jdr70g9apz69vke5at748d47", "account_id": "acc_01jf18ah3jeb5w6dfp27sgjsbt", "name": "Front desk",
"strategy": "ring_all",
"ring_timeout_sec": 25,
"moh_media_id": null,
"exit_dest_kind": "voicemail", "exit_dest_id": "vm_01jg8asp59ps9rtt7azhrhvcre",
"schedule_id": "sch_01j0jvpe0wzc6g05bktfew0xyx"
}
FieldPurpose
strategyring_all, sequential, or round_robin.
ring_timeout_secOverall ring time before the exit.
moh_media_idOptional media the caller hears instead of ringback while members are rung.
require_confirmtrue = press 1 to accept: the member hears a prompt and must press 1, so a mobile’s voicemail can’t swallow the call.
exit_dest_*Where the call goes if nobody answers (a route target).
schedule_id + closed_dest_*/holiday_dest_*Business hours on the group.

Members are rows, each a user or a device, with ordering and timing controls:

[
{ "ring_group_id": "rg_01jdr70g9apz69vke5at748d47", "user_id": "us_01jatt0336xwzg2zbf3q9pyfm5", "position": 0, "delay_sec": 0 },
{ "ring_group_id": "rg_01jdr70g9apz69vke5at748d47", "user_id": "us_01j8m8yxxmsg3web7hxh7mr9rh", "position": 1, "delay_sec": 5 },
{ "ring_group_id": "rg_01jdr70g9apz69vke5at748d47", "device_id": "dev_01j12frzkfzcem64prjmgf6nnr", "position": 2, "delay_sec": 0 }
]
FieldPurpose
user_id / device_idThe member (one or the other).
positionOrder for sequential / round_robin.
delay_sec · timeout_secPer-member stagger and ring time. Stored, but not applied yet: today every member rings for the group’s ring_timeout_sec.
  • ring_all: ring every member at once; first to answer wins.
  • sequential: one member at a time in position order. A turn is per person: all of a user’s phones (desk phone, softphone, mobile app) ring together on their turn, then the next person’s.
  • round_robin: like sequential, but each call starts with the member after the one who answered last, so load spreads across the team. With require_confirm, the rotation follows whoever pressed 1.

Members who are busy on another call or set to do-not-disturb are skipped, so the group never spends ring time on someone who can’t pick up. Members can be users or individual devices.

If the ring times out with no answer, the call falls through to the exit route target (exit_dest_*), commonly a voicemail or a queue. When a number points directly at a ring group, flow synthesis chains this exit automatically.

Ring groupQueue
ModelFork to membersHold + distribute by ACD
Waiting callersNo real waiting lineOrdered queue with positions
Skills/tiersNoYes (tier_level)
Wrap-up, no-answer auto-pauseNoYes
Hold music / announcementsBasicFull MOH + position announcements
Best forSmall teams, “anyone can grab it”Contact centers, SLAs, reporting

Reference it from a ringGroup node, or point a number at it directly with dest_kind: "ring_group".

For a step-by-step, see Create a ring group.