Create a ring group

Make a ring group so a small team all rings for the same call.

1. Create the ring group. Choose a strategy and a no-answer exit.

   {
     "id": "rg_01jdr70g9apz69vke5at748d47", "account_id": "acc_01jf18ah3jeb5w6dfp27sgjsbt", "name": "Front desk",
     "strategy": "ring_all",
     "ring_timeout_sec": 25,
     "exit_dest_kind": "voicemail", "exit_dest_id": "vm_01jg8asp59ps9rtt7azhrhvcre"
   }

2. Add members (each a user or a device). Use delay_sec to stagger ringing; use position for sequential order.

   [
     { "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": 0 },
     { "ring_group_id": "rg_01jdr70g9apz69vke5at748d47", "user_id": "us_01j5v4y37r2h362sv0pz7wa5k2", "position": 2, "delay_sec": 8 }
   ]

3. Route to it. Point a number directly at the group…

   { "e164": "12025550123", "dest_kind": "ring_group", "dest_id": "rg_01jdr70g9apz69vke5at748d47" }

   …or use a ringGroup node in a flow.

4. Test. Call in: all members ring at once. If nobody answers within 25s, the call falls through to voicemail.

Note

Choosing between a ring group and a queue? Use a ring group for “any of these few people can grab it.” Use a queue when you need waiting callers, skills/tiers, wrap-up, or reporting. See the comparison table.

Strategy cheatsheet

• ring_all: everyone rings together (stagger with delay_sec).
• sequential: one at a time, in position order.
• round_robin: rotate who rings first across calls to spread load.