← Documentation
Panel manual · Call management · 7 min

Ring Groups

Ring a set of destinations using ordered or simultaneous strategies.

01

Purpose and location

Ring a set of destinations using ordered or simultaneous strategies.

Open Call management → Ring Groups. The available controls depend on the active edition, module entitlement, role and tenant scope.

RelayPBX ring group list and delivery strategy controls
A ring group combines member order, busy handling, timeout and a mandatory failover.
02

Before you start

Write down the current source and destination path before editing it. Keep a registered test extension, a rollback destination and Calls & Reports open for validation.

Capture the current value or export the affected records before a bulk or routing change. This gives the operator a precise comparison point and makes a supported transaction undo easier to assess.

03

Step-by-step workflow

Complete the steps in order. Do not combine an initial configuration with unrelated cleanup; small, attributable changes are easier to test and reverse.

  • Add members in the intended order.
  • Choose strategy and timeout.
  • Decide whether busy extensions are skipped.
  • Set a no-answer destination and test member states.
04

Field reference

Use the reference below while completing the form. Fields hidden by edition, module entitlement or role are intentionally unavailable to the signed-in user.

Members
Extensions or supported external destinations.
Strategy
Simultaneous, sequential or rolling distribution.
Timeout
Total or per-member ring duration.
Skip busy
Avoid extensions already on another call.
Failover
Destination after no member answers.
Account code
Optional reporting identifier for the group.
05

Acceptance checks

A saved record is only the beginning of validation. Run every relevant check below and retain the call-session ID, time and result when telephony is involved.

  • Test with all members available, one busy member and every member unavailable.
  • Confirm ring order and timeout match the selected strategy.
  • Let the group expire and verify the configured failover endpoint receives the call.
06

Common mistakes and safe recovery

If a check fails, stop adding changes. Restore the previous value or use a supported transaction undo, regenerate PBX configuration, then repeat the smallest failing test.

  • Saving a form is not proof that a call path works. Always validate the success path and its timeout or failure path.
07

What to include in a support case

Provide the tenant, module and object name, local time with timezone, expected result, observed result and the most recent successful state. For a call problem, include the logical call-session ID and the redacted SIP/SDP text diagnostic before requesting PCAP.

Never paste passwords, private keys, raw license payloads or unredacted customer media into a ticket. Use the one-time diagnostic grant and attachment controls when support requests additional evidence.