कॉल क्यूइंग

खास जानकारी

जब कोई एजेंट या वर्कस्पेस अपनी concurrency सीमा पर पहुंच जाता है, तो नई कॉल्स सामान्यतः तुरंत अस्वीकार हो जाती हैं। कॉल क्यूइंग सक्षम होने पर, एजेंट की क्षमता पूरी होने के दौरान आने वाले कॉलर्स को होल्ड ऑडियो के साथ लाइन पर रखा जाता है और स्लॉट खाली होते ही उनके आने के क्रम में अपने आप कनेक्ट कर दिया जाता है।

कॉल क्यूइंग हर एजेंट के लिए अलग से कॉन्फ़िगर होती है और डिफ़ॉल्ट रूप से बंद रहती है।

कॉल क्यूइंग कैसे काम करती है

1. क्षमता जांच: कॉल आने पर, ElevenAgents जांचता है कि एजेंट और वर्कस्पेस के पास खाली concurrency स्लॉट है या नहीं। अगर है, तो कॉल तुरंत कनेक्ट हो जाती है।
2. क्यूइंग: कोई स्लॉट उपलब्ध न होने पर, कॉलर को एजेंट की क्यू में रखा जाता है और उसे होल्ड ऑडियो सुनाई देता है। कॉलर के इंतज़ार के दौरान कोई बातचीत शुरू नहीं होती और कोई शुल्क नहीं लिया जाता।
3. प्रवेश: स्लॉट खाली होते ही, क्यू में सबसे आगे मौजूद कॉलर कनेक्ट हो जाता है और बातचीत सामान्य रूप से शुरू होती है।
4. टाइमआउट: अधिकतम क्यू प्रतीक्षा समय के भीतर कोई स्लॉट खाली न होने पर, कॉल डिस्कनेक्ट हो जाती है। टेलीफोनी कॉल्स सामान्य रूप से काट दी जाती हैं। WebSocket क्लाइंट्स को queue_status इवेंट मिलता है, जिसका स्टेटस timed_out होता है, और इसके बाद कोड 4300 के साथ कनेक्शन बंद हो जाता है।

किसी एजेंट के लिए कॉलर्स को उनके आने के क्रम में सख्ती से कनेक्ट किया जाता है। जब कई एजेंट्स किसी वर्कस्पेस का concurrency पूल साझा करते हैं, तो अधिक समय से इंतज़ार कर रहे कॉलर्स को आम तौर पर पहले कनेक्ट किया जाता है।

कॉलर को क्या सुनाई देता है

• Twilio और SIP ट्रंक नंबरों पर फ़ोन कॉलर्स को कॉल के दौरान होल्ड ऑडियो सुनाई देता है।
• विजेट और ब्राउज़र SDK यूज़र्स को ब्राउज़र में होल्ड ऑडियो सुनाई देता है। विजेट (वर्ज़न 0.17.0 या उसके बाद का) प्रतीक्षा संदेश भी दिखाता है और क्यू में होने पर टेक्स्ट इनपुट बंद कर देता है।
• सीधे WebSocket API क्लाइंट्स को सामान्य audio इवेंट्स के रूप में होल्ड ऑडियो मिलता है, साथ ही आपके अपने UI में प्रतीक्षा स्थिति चलाने के लिए queue_status इवेंट्स भी मिलते हैं। क्यू इवेंट्स संभालना देखें।

बिलिंग और बातचीत की अवधि

क्यू में बिताया गया समय बिल नहीं किया जाता, एजेंट की अधिकतम बातचीत अवधि में नहीं गिना जाता और बातचीत की रिपोर्ट की गई अवधि में शामिल नहीं होता। डैशबोर्ड में बातचीत की जानकारी दिखाती है कि कनेक्ट होने से पहले कॉलर ने कितनी देर इंतज़ार किया।

समर्थित चैनल्स

कॉन्फ़िगरेशन

कॉल क्यूइंग को एजेंट के Security टैब के Limits सेक्शन में हर एजेंट के लिए अलग से कॉन्फ़िगर किया जाता है।

API से होल्ड ऑडियो मैनेज करना

एजेंट का कस्टम होल्ड ऑडियो सेट करने के लिए MP3 या WAV फ़ाइल अपलोड करें। नई फ़ाइल अपलोड करने पर पुरानी फ़ाइल बदल जाती है। API audio/mpeg और audio/wav कंटेंट टाइप स्वीकार करता है, इसलिए उदाहरणों में टाइप साफ़ तौर पर सेट किया गया है।

from dotenv import load_dotenv
from elevenlabs import ElevenLabs
import os
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
elevenlabs.conversational_ai.agents.hold_audio.create(
agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
hold_audio_file=("hold-music.mp3", open("hold-music.mp3", "rb"), "audio/mpeg"),
)

डिफ़ॉल्ट होल्ड टोन पर वापस जाने के लिए कस्टम क्लिप हटाएं:

elevenlabs.conversational_ai.agents.hold_audio.delete(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
)

मौजूदा क्लिप एजेंट पर केवल-पढ़ने के लिए platform_settings.queueing_config.hold_audio के रूप में लौटाई जाती है। एजेंट बनाने या अपडेट करने के अनुरोध में hold_audio भेजने का कोई असर नहीं होता।

कस्टम WebSocket क्लाइंट में क्यू इवेंट्स संभालना

WebSocket API के माध्यम से कनेक्ट किए गए क्लाइंट्स को क्यू में रहने के दौरान queue_status इवेंट्स मिलते हैं:

{
  "type": "queue_status",
  "queue_status_event": {
    "status": "waiting"
  }
}

• waiting, conversation_initiation_metadata के तुरंत बाद और किसी भी होल्ड ऑडियो से पहले, एक बार भेजा जाता है।
• कॉलर कनेक्ट होने पर admitted भेजा जाता है। फिर बातचीत सामान्य रूप से आगे बढ़ती है।
• प्रतीक्षा अधिकतम क्यू प्रतीक्षा समय से अधिक होने पर timed_out भेजा जाता है। इसके बाद सर्वर कोड 4300 के साथ कनेक्शन बंद कर देता है।

तुरंत कनेक्ट होने वाली कॉल्स को कभी queue_status इवेंट्स नहीं मिलते। यह इवेंट हमेशा क्यू में मौजूद कॉलर्स को भेजा जाता है और इसे एजेंट के client_events में सक्षम करने की ज़रूरत नहीं होती।

होल्ड ऑडियो लगभग एक सेकंड के हिस्सों में सामान्य audio इवेंट्स के रूप में दिया जाता है, बशर्ते एजेंट के क्लाइंट इवेंट्स में audio शामिल हो। होल्ड ऑडियो को एजेंट की स्पीच मानने के बजाय प्रतीक्षा स्थिति दिखाने के लिए queue_status का उपयोग करें।

अक्सर पूछे जाने वाले सवाल