वॉइस API क्या है?

कॉलबैक, फ़ोन मेन्यू और वॉइस असिस्टेंट किसी कॉलिंग प्लेटफ़ॉर्म के अलग-अलग हिस्सों का इस्तेमाल करते हैं।

वॉइस API किन चीज़ों को नियंत्रित कर सकता है?

वॉइस API कॉन्फ़िगरेशन, कॉल कंट्रोल और रिपोर्टिंग उपलब्ध करा सकता है, और कौन-से ऑपरेशन समर्थित हैं, यह प्रोवाइडर तय करता है।

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

हर प्रदाता कॉल नियंत्रण को अलग तरीके से व्यक्त करता है। उदाहरण के लिए, Twilio का TwiML Twilio को लौटाए गए निर्देशों के ज़रिए कार्रवाइयों का वर्णन करता है। इसलिए किसी एप्लिकेशन को दूसरे प्रदाता पर ले जाने के लिए केवल होस्टनेम बदलना काफ़ी नहीं है, उसके व्यवहार और कॉलबैक अपेक्षाओं का भी मिलान करना पड़ता है।

जो मेथड किसी कॉल को पढ़ता है, वह कॉल शुरू करने वाला ऑपरेशन नहीं है।

API और SIP एक साथ कैसे काम करते हैं?

एप्लिकेशन API किसी सेवा को कॉन्फ़िगर या नियंत्रित कर सकता है, जबकि उसके नीचे SIP टेलीफ़ोन सत्र स्थापित करता है।

कॉल-सिग्नलिंग प्रोटोकॉल SIP सत्र बनाता, बदलता और समाप्त करता है। यह तय करता है कि प्रतिभागी कैसे जुड़ेंगे। RTP ऑडियो जैसी रीयल-टाइम मीडिया ले जाता है।

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

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

मैं किसी कॉल के बारे में क्या पढ़ सकता हूँ?

कॉल रिकॉर्ड प्रयास की पहचान करता है और उसकी देखी गई स्थिति बताता है। कौन-से फ़ील्ड उपलब्ध होंगे, यह ऑपरेशन और कॉल के चरण पर निर्भर करता है।

• कनेक्शन: कॉल स्वीकार हुई या नहीं, घंटी बजी या नहीं और उसका उत्तर मिला या नहीं।
• मीडिया: प्रतिभागी एक-दूसरे को सुन पाए और आपस में बातचीत कर पाए या नहीं।
• व्यावसायिक परिणाम: क्या इच्छित अपॉइंटमेंट, कॉलबैक या सहायता कार्य पूरा हुआ।

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

इवेंट आपके एप्लिकेशन को बदलावों पर प्रतिक्रिया देने में मदद करते हैं। डुप्लिकेट और देर से पहुँचने वाले इवेंट संभालें, फिर गायब या अनिश्चित अपडेट का मिलान प्रदाता की रिकॉर्ड की गई स्थिति से करें।

मैं इसे Bird के साथ कैसे बनाऊँ?

आप आउटबाउंड कॉलिंग को एक SIP ट्रंक, एक सत्यापित कॉलर ID और एक सक्षम गंतव्य देश के साथ कॉन्फ़िगर करते हैं।

कॉन्फ़िगरेशन बदलने के लिए राइट स्तर पर voice_management आवश्यक है।

ट्रंक पर outbound_enabled का मान true होना चाहिए। इसका domain वह पता है जिससे आपका SIP क्लाइंट जुड़ता है। API-कुंजी ऑथेंटिकेशन में आपकी कुंजी allowed_api_key_ids में सूचीबद्ध होती है; इस कुंजी को राइट स्तर पर voice चाहिए। उस सूची को अपडेट करने से सभी प्रविष्टियाँ बदल जाती हैं, इसलिए वे कुंजियाँ बनाए रखें जिनका उपयोग अन्य क्लाइंट अभी भी करते हैं।

आपके कॉलर ID को status: verified चाहिए, जो पुष्टि करता है कि आपके वर्कस्पेस ने अपनी सत्यापन कॉल पूरी कर ली है। इसके phone_number में शुरुआती + सहित अंतरराष्ट्रीय नंबर होता है।

गंतव्य देश को enabled: true और status: available दोनों चाहिए। किसी देश को सक्षम करने से असमर्थित गंतव्य पर कॉल करना संभव नहीं हो जाता।

ब्राउज़र फ़ोन के लिए ट्रंक के digest_algorithms में session_credentials_enabled: true और MD5 भी आवश्यक हैं।

कॉल के बाद आप status, rejection_reason और sip_response_code जाँचते हैं। लेग सूची और लेग पढ़ने वाले ऑपरेशन ये फ़ील्ड लौटाते हैं। ये ऑपरेशन प्रयासों की रिपोर्ट देते हैं। इन्हें आपका SIP एप्लिकेशन शुरू करता है।

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