रिंग ग्रुप

रिंग ग्रुप आपके वर्कस्पेस के उन लोगों को रिंग करता है जो ब्राउज़र फ़ोन में ऑनलाइन हैं। किसी नंबर को, या अपने वर्कस्पेस के डिफ़ॉल्ट रूट को, किसी ग्रुप की ओर रूट करें। तब आने वाली कॉल डैशबोर्ड में ग्रुप के ऑनलाइन सदस्यों को तब तक रिंग करती है जब तक उनमें से कोई उत्तर न दे।

हर वर्कस्पेस में एक Default ग्रुप होता है जो ऑनलाइन सभी लोगों को रिंग करता है। किसी छोटी टीम, जैसे सपोर्ट या सेल्स, को रिंग करने के लिए अपने ग्रुप जोड़ें, और हर नंबर को उस ग्रुप की ओर निर्देशित करें जिसे उसका उत्तर देना चाहिए।

शुरू करने से पहले

• ऑनलाइन होने वाले सदस्य। रिंग ग्रुप केवल उन सदस्यों को रिंग करता है जो ब्राउज़र फ़ोन में ऑनलाइन हैं। कॉल प्राप्त करें में बताया गया है कि ऑनलाइन कैसे होते हैं और कौन हो सकता है।
• Voice प्रबंधित करने की अनुमति। रिंग ग्रुप देखने के लिए पढ़ने के स्तर पर voice_management चाहिए। ग्रुप बनाने, उनका नाम बदलने, उन्हें हटाने, सदस्य बदलने और किसी नंबर को ग्रुप की ओर रूट करने के लिए यह लिखने के स्तर पर चाहिए।
• API या CLI के लिए: एक API कुंजी, जिसमें ऑपरेशन के लिए आवश्यक स्तर पर voice_management स्कोप हो।

डिफ़ॉल्ट ग्रुप

Default ग्रुप सूची में हमेशा पहले स्थान पर होता है। कॉल आने के समय वर्कस्पेस में ऑनलाइन हर उपयोगकर्ता इसका सदस्य होता है, इसलिए आपको इसमें कभी किसी को जोड़ना नहीं पड़ता। इसका नाम नहीं बदला जा सकता, इसे हटाया नहीं जा सकता और इसके सदस्य नहीं बदले जा सकते: ऐसा कोई भी अनुरोध 409 और E21072 के साथ अस्वीकार कर दिया जाता है।

इसकी ID vrg_ के बाद आपकी वर्कस्पेस ID का प्रत्यय होती है, इसलिए हर रीड में यह एक जैसी रहती है। जहाँ भी रिंग ग्रुप ID स्वीकार की जाती है, वहाँ इसका उपयोग करें।

रिंग ग्रुप बनाएँ

1. Voice > Ring groups खोलें और New ring group चुनें।
2. Name दर्ज करें और Create ring group चुनें।
3. ग्रुप के Members में Add member चुनें और वे सभी उपयोगकर्ता चुनें जिन्हें ग्रुप को रिंग करना चाहिए। सूची में वे उपयोगकर्ता दिखते हैं जिनकी वर्कस्पेस तक पहुँच है।

Online कॉलम ग्रुप के उन सदस्यों को गिनता है जो ऑनलाइन हैं और कॉल स्वीकार कर रहे हैं। इसमें कॉल पर मौजूद सदस्य भी शामिल हैं, जिन्हें वह कॉल समाप्त होने तक रिंग नहीं किया जाता। नए ग्रुप में कोई सदस्य नहीं होता, इसलिए सदस्य जोड़ने तक यह 0 दिखाता है।

API के ज़रिए रिंग ग्रुप बनाएँ, फिर उपयोगकर्ता ID से हर सदस्य जोड़ें। उपयोगकर्ता ID पता करने के लिए bird members list चलाएँ, जिसके लिए पढ़ने के स्तर पर members स्कोप चाहिए।

const group = await bird.voice.ringGroups.create({ name: "Support" });
console.log(group.id, group.name);

group = client.voice.ring_groups.create(name="Support")
print(group.id, group.name)

group, err := client.Voice.RingGroups.Create(context.Background(), bird.VoiceRingGroupsCreateParams{
	Name: "Support",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(group.Id, group.Name)

$group = $bird->voice->ringGroups->create((new VoiceRingGroupCreate())->setName('Support'));
echo $group->getId(), ' ', $group->getName(), "\n";

bird voice ring-groups create --name Support

curl -X POST "https://{region}.platform.bird.com/v1/voice/ring-groups" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support"
  }'

const member = await bird.voice.ringGroups.members.create("RING_GROUP_ID", { user_id: "USER_ID" });
console.log(member.user_id);

member = client.voice.ring_groups.members.create("RING_GROUP_ID", user_id="USER_ID")
print(member.user_id)

member, err := client.Voice.RingGroups.Members.Create(context.Background(), "RING_GROUP_ID", bird.VoiceRingGroupsMembersCreateParams{
	UserID: "USER_ID",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(member.UserId)

$member = $bird->voice->ringGroups->members->create('RING_GROUP_ID', (new VoiceRingGroupMemberCreate())->setUserId('USER_ID'));
echo $member->getUserId(), "\n";

bird voice ring-groups members create <ring-group-id> \
  --user-id usr_01krdgeqcxet5s7t44vh8rt9mg

curl -X POST "https://{region}.platform.bird.com/v1/voice/ring-groups/{ring_group_id}/members" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_01krdgeqcxet5s7t44vh8rt9mg"
  }'

जो उपयोगकर्ता बाद में वर्कस्पेस छोड़ देता है, वह तब तक सूची में रहता है जब तक आप उसे हटा नहीं देते, लेकिन ग्रुप उसे कभी रिंग नहीं करता। किसी सदस्य को हटाने के लिए उसके बगल में Remove चुनें, या API के ज़रिए सदस्य को हटाएँ। हटाए गए सदस्य को अगली कॉल से रिंग नहीं किया जाता।

कॉल को रिंग ग्रुप पर रूट करें

कोई नंबर किसी ग्रुप को तब रिंग करता है जब उसका अपना रूट, या वह वर्कस्पेस डिफ़ॉल्ट रूट जिसका वह पालन करता है, उस ग्रुप को निर्दिष्ट करता है।

• एक नंबर: Voice > Numbers खोलें, नंबर खोलें, और Inbound routing में Ring a ring group चुनें। ग्रुप चुनें और Save चुनें।
• हर वह नंबर जिसका अपना रूट नहीं है: Numbers पेज पर Calls to numbers without their own route के बगल में Change चुनें, Ring a ring group और ग्रुप चुनें, फिर सहेजें।

API के ज़रिए, नंबर अपडेट करते समय रूट को {"type": "ring_group", "ring_group_id": "<id>"} पर सेट करें, या डिफ़ॉल्ट रूट के लिए वॉइस सेटिंग्स में। ऐसा ring_group_id जो न डिफ़ॉल्ट ग्रुप है और न ही वर्कस्पेस का कोई ग्रुप, 422 के साथ अस्वीकार कर दिया जाता है।

bird voice numbers update vnu_01krdgeqcxet5s7t44vh8rt9mg \
  --route ring_group --ring-group-id vrg_01krdgeqcxet5s7t44vh8rt9mg

curl -X PATCH "https://{region}.platform.bird.com/v1/voice/numbers/vnu_01krdgeqcxet5s7t44vh8rt9mg" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "inbound_configuration": {
      "route": {
        "type": "ring_group",
        "ring_group_id": "vrg_01krdgeqcxet5s7t44vh8rt9mg"
      }
    }
  }'

bird voice settings update डिफ़ॉल्ट रूट के लिए वही --route ring_group --ring-group-id फ़्लैग लेता है। कॉल प्राप्त करना में बाकी रूट और किसी नंबर को डिफ़ॉल्ट पर वापस लाने का तरीका बताया गया है।

कोई सीक्वेंस भी डायल चरण से किसी ग्रुप को रिंग कर सकता है। फिर उस चरण का परिणाम सीक्वेंस को आगे बढ़ाता है, और ग्रुप के कॉल का उत्तर न देने पर वॉइसमेल या फ़ॉरवर्ड इसी जगह जोड़ा जाता है।

रिंग ग्रुप कैसे रिंग करता है

जब किसी ग्रुप के लिए कॉल आती है, तो Bird ग्रुप के उन सदस्यों को पढ़ता है जिन्हें उस समय रिंग किया जा सकता है, और उन्हें यादृच्छिक क्रम में लगाता है:

• सदस्यों को एक बार में पाँच-पाँच करके रिंग किया जाता है, हर बैच के लिए अधिकतम 20 सेकंड तक। जब किसी बैच का हर सदस्य कॉल अस्वीकार कर देता है या उस तक पहुँचा नहीं जा सकता, तो अगला बैच तुरंत शुरू होता है।
• कुल 60 सेकंड के बाद रिंग होना बंद हो जाता है।
• जो सदस्य सबसे पहले Accept चुनता है, कॉल उसे मिलती है, और बाकी सदस्यों के यहाँ रिंग बंद हो जाती है।
• किसी सदस्य के यहाँ केवल एक डिवाइस पर रिंग होती है: वह ब्राउज़र जिसमें उसकी ऑनलाइन स्थिति है।

किसी सदस्य को तब छोड़ दिया जाता है जब वह ऑफ़लाइन हो, Busy हो, पहले से किसी कॉल पर हो, या लगातार तीन कॉल छूटने के बाद Not accepting calls पर हो। आपकी स्थिति में हर स्थिति समझाई गई है।

सदस्यों के यहाँ रिंग होते समय कॉल करने वाले को रिंग की आवाज़ सुनाई देती है, और जब तक कोई सदस्य कॉल स्वीकार नहीं करता, कॉल का उत्तर नहीं दिया जाता, इसलिए रिंग होने के समय का शुल्क नहीं लगता। अगर 60 सेकंड में कोई उत्तर नहीं देता, या किसी को रिंग नहीं किया जा सकता, तो सीधे ग्रुप पर रूट किया गया नंबर कॉल अस्वीकार कर देता है। अनुत्तरित कॉल करने वालों को कहीं और भेजने के लिए, नंबर को ऐसे सीक्वेंस पर रूट करें जो ग्रुप को रिंग करे और फिर आगे बढ़े।

वॉइस लेग API में, कॉल करने वाले का लेग उत्तर देने वाले सदस्य का नाम answered_by में बताता है। रिकॉर्डिंग या ट्रांसक्रिप्ट में, पक्ष का user_id उस ओर के सदस्य का नाम बताता है।

रिंग ग्रुप हटाएँ

Ring groups पेज पर समूह चुनें और Delete ring group चुनें। जो कॉल पहले से इसके सदस्यों के यहाँ बज रही हैं, उन पर कोई असर नहीं पड़ता।

अगर कोई नंबर, वर्कस्पेस का डिफ़ॉल्ट रूट या कोई प्रकाशित सीक्वेंस अब भी किसी समूह को रिंग करता है, तो उस समूह को हटाया नहीं जा सकता: अनुरोध 409 और E21071 के साथ अस्वीकार कर दिया जाता है। पहले इनमें से हर एक को किसी दूसरे रूट पर भेजें, फिर समूह हटाएँ।

सीमाएँ

डिफ़ॉल्ट समूह में सदस्यों की कोई सीमा नहीं है। अगर कोई नया समूह बनाने या सदस्य जोड़ने से सीमा पार होती है, तो अनुरोध 422 के साथ अस्वीकार हो जाता है, और संदेश में उस सीमा का नाम होता है। एक साथ कितने उपयोगकर्ता ऑनलाइन रह सकते हैं, यह संगठन की सीमा है, जिसका विवरण ऑनलाइन उपयोगकर्ताओं की सीमा में है।

API, CLI या MCP से रिंग समूह प्रबंधित करें

MCP सर्वर यही ऑपरेशन voice_ring_groups_* टूल के रूप में देता है, और इसके voice_numbers_update और voice_settings_update टूल ring_group रूट स्वीकार करते हैं। हर समूह की जानकारी पढ़ने पर उसमें online_member_count शामिल होता है, जो Online कॉलम वाली ही गिनती है।

अगले कदम