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.

The ring group object

{
  "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"
}

Field	Purpose
strategy	ring_all, sequential, or round_robin.
ring_timeout_sec	Overall ring time before the exit.
moh_media_id	Optional ringback/hold media.
exit_dest_*	Where the call goes if nobody answers (a route target).
schedule_id + closed_dest_*/holiday_dest_*	Business hours on the group.

Members

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 }
]

Field	Purpose
user_id / device_id	The member (one or the other).
position	Order for sequential / round_robin.
delay_sec	For ring_all, start ringing this member after N seconds (staggered overlap).
timeout_sec	Per-member ring time.

Strategies

• ring_all: ring every member at once (optionally staggered via delay_sec); first to answer wins.
• sequential: ring members one at a time in position order.
• round_robin: rotate the starting member across calls to spread load.

Exit on no-answer

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 group vs. queue

	Ring group	Queue
Model	Fork to members	Hold + distribute by ACD
Waiting callers	No real waiting line	Ordered queue with positions
Skills/tiers	No	Yes (tier_level)
Wrap-up, no-answer auto-pause	No	Yes
Hold music / announcements	Basic	Full MOH + position announcements
Best for	Small teams, “anyone can grab it”	Contact centers, SLAs, reporting

Using a ring group in a flow

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

Guide

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