रिंग ग्रुप

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

हर वर्कस्पेस में एक 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 सेकंड में कोई जवाब नहीं देता, या किसी को रिंग नहीं किया जा सकता, तो सीधे ग्रुप पर रूट किया गया नंबर कॉल अस्वीकार कर देता है। जवाब न पाने वाले कॉलर को कहीं और भेजने के लिए, नंबर को ऐसे सीक्वेंस पर रूट करें जो ग्रुप को रिंग करे और फिर आगे बढ़े।

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

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 कॉलम वाली गिनती ही है।

आगे के कदम