Voice

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

वॉइस API किसी एप्लिकेशन को एक प्रलेखित सॉफ़्टवेयर इंटरफ़ेस के ज़रिए फ़ोन कॉल कॉन्फ़िगर, नियंत्रित या निरीक्षण करने देता है।

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

वॉइस API क्या नियंत्रित कर सकता है?

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

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

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

कॉल पढ़ने वाला मेथड कॉल शुरू करने वाला ऑपरेशन नहीं है।

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

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

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

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

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

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

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

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

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

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

Bird के साथ यह कैसे बनाएँ?

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

कॉन्फ़िगरेशन बदलावों के लिए write स्तर पर voice_management ज़रूरी है।

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

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

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

ब्राउज़र फ़ोन के लिए ट्रंक पर session_credentials_enabled: true होना चाहिए और उसके digest_algorithms में MD5 शामिल होना चाहिए।

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

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

संक्षेप में

  1. वॉइस API अलग-अलग ऑपरेशन उपलब्ध कराते हैं।

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

  2. सिग्नलिंग और ऑडियो के रास्ते अलग होते हैं।

    SIP सेशन स्थापित और बदलता है। मीडिया वह ले जाता है जो प्रतिभागी सुनते हैं, इसलिए सफल सिग्नलिंग अकेले यह साबित नहीं करती कि ऑडियो काम कर रहा है।

  3. कॉल का उत्तर मिलना कार्य पूरा होने का प्रमाण नहीं है।

    उत्तर दी गई कॉल वॉइसमेल या किसी अन्य सिस्टम तक पहुँच सकती है। जिस एप्लिकेशन का वह कार्य है, वही पुष्टि करता है कि वह पूरा हुआ या नहीं।

व्यवहार में लाएँ।

इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ

उसी नेटवर्क पर बनाएँ।

एक टेस्ट API key आपको तुरंत मिल जाती है। भुगतान विधि जोड़ने और सेंडर सत्यापित करने पर प्रोडक्शन अनलॉक होता है।

आपका अगला आइडिया।
जुड़ने के लिए तैयार।