Ring Groups

Ring multiple extensions simultaneously or sequentially

Ring groups let you ring multiple extensions when a call arrives. Unlike queues (which hold callers and distribute one at a time), ring groups ring all members at once or in sequence until someone answers.

Ring Strategies

Strategy	Description
`simultaneous`	All extensions ring at the same time. First to answer wins.
`sequential`	Ring extensions one by one in order. Move to next after timeout.
`round_robin`	Start with the next member in rotation each time.
`longest_idle`	Ring the member who hasn't taken a call in the longest time.

Configuration

Ring Group Settings

namestringrequired

Display name for the ring group

strategystringrequired

Ring strategy (see table above)

membersstring[]required

Array of extension IDs

ringTimeoutnumber

Seconds to ring each member (sequential) or total (simultaneous). Default: 20

noAnswerActionstring

Action when nobody answers: voicemail, extension, external, hangup

noAnswerTargetstring

Target for the no-answer action (mailbox ID, extension number, or phone number)

Example

curl -X POST "https://api.do.dev/v1/pbx/ring-groups" \
  -H "Authorization: Bearer do_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Team",
    "strategy": "simultaneous",
    "members": ["ext_101", "ext_102", "ext_103"],
    "ringTimeout": 25,
    "noAnswerAction": "voicemail",
    "noAnswerTarget": "vm_sales"
  }'

When a call routes to this ring group, extensions 101, 102, and 103 all ring for 25 seconds. If nobody answers, the caller hears the sales voicemail greeting.