वॉइस सीक्वेंस में डेटा का उपयोग करें
Warning: Voice sequences are in preview. Steps, entry data, and the sequence definition format can change in ways that break existing sequences and API requests.
पहले तय करें कि कॉल एंट्री कौन-सा डेटा स्वीकार करती है, फिर उस डेटा का उपयोग समर्थित चरण फ़ील्ड में करें। उदाहरण के लिए, कोई रिमाइंडर कॉल शुरू करने वाले एप्लिकेशन से ग्राहक का नाम और अपॉइंटमेंट का समय स्वीकार कर सकता है।
चुना गया चरण कौन-से स्रोत और मान मोड समर्थित करता है, यह देखने के लिए फ़ील्ड पिकर का उपयोग करें।
एंट्री डेटा परिभाषित करें
- अपने ड्राफ़्ट में Start call एंट्री चुनें।
- इसके डेटा फ़ील्ड जोड़ें और आवश्यक फ़ील्ड चिह्नित करें।
- बाद का कोई चरण चुनें और उसका विस्तृत एडिटर खोलें।
- Available data से कोई फ़ील्ड चुनें, फिर प्रतिनिधि एंट्री डेटा के साथ उसका प्रीव्यू देखें।
API कॉल का sequence.trigger_data एक ऐसा ऑब्जेक्ट होना चाहिए जो चुनी गई एंट्री के स्कीमा से मेल खाए। जब एंट्री को किसी डेटा की ज़रूरत न हो, तो {} दें। इनकमिंग नंबर रूट {} देता है, इसलिए उसकी एंट्री को खाली ऑब्जेक्ट स्वीकार करना चाहिए। इनकमिंग फ़ील्ड वैकल्पिक रखें और बाद के चरणों में अनुपस्थित मानों को संभालें।
एप्लिकेशन डेटा कॉल की पहचान से अलग है। आपके एप्लिकेशन द्वारा दिया गया caller नाम का फ़ील्ड यह स्थापित नहीं करता कि कौन कॉल कर रहा है, और न ही किसी नंबर का उपयोग करने की अनुमति देता है।
मान मैप करें या टेक्स्ट बनाएँ
समर्थित फ़ील्ड में निश्चित मान, पिछले चरणों के मान, जोड़े गए मानों वाला टेक्स्ट या fx एक्सप्रेशन दिए जा सकते हैं। टाइप वाले फ़ील्ड के लिए सीधा मान इस्तेमाल करें और बोले जाने वाले वाक्यों के लिए जोड़े गए मानों वाला टेक्स्ट। अंकों वाली स्ट्रिंग टेक्स्ट ही रहती है।
उदाहरण के लिए, एंट्री पर customer_name नाम का एक आवश्यक स्ट्रिंग फ़ील्ड परिभाषित करें। किसी समर्थित स्पीच फ़ील्ड में Hello, एक स्पेस, फ़ील्ड का मान और , your appointment is confirmed. जोड़ें। तैयार टेक्स्ट जाँचने के लिए {"customer_name":"Ada"} के साथ प्रीव्यू करें।
वॉइस एक्सप्रेशन एंट्री फ़ील्ड को trigger.data.customer_name के रूप में पढ़ते हैं। पिछले योग्य आउटपुट के लिए steps.<step_id>.output इस्तेमाल होता है। सोर्स पिकर से आप सही चरण और फ़ील्ड चुन सकते हैं।
गायब डेटा और ब्रांच संभालें
वैकल्पिक फ़ील्ड मौजूद न हों, null हों या खाली हों, ऐसा हो सकता है। इन स्थितियों का प्रीव्यू करें और जहाँ उचित हो, एक स्पष्ट फ़ॉलबैक चुनें। जिस पाथ पर रन नहीं गया, उसके चरण का उस रन में कोई आउटपुट नहीं होता।
कॉल से जुड़ी जानकारी execution के अंतर्गत रहती है। उदाहरण के लिए, मूल कॉलर का नंबर मौजूद न हो, ऐसा हो सकता है। सुरक्षा जाँच वाला एक्सप्रेशन इसे सुरक्षित रूप से पढ़ता है:
execution.call.orig != null && has(execution.call.orig.address) ? execution.call.orig.address : ''यह जानकारी टेलीफ़ोन एंडपॉइंट के बारे में है; इससे किसी व्यक्ति की पहचान प्रमाणित नहीं होती। अगर प्रीव्यू में चलने वाला कोई एक्सप्रेशन execution इस्तेमाल करता है, तो प्रीव्यू को एक एक्ज़ीक्यूशन सैंपल चाहिए। सैंपल न होने पर प्रीव्यू उस चरण का मूल्यांकन करने से पहले रुक जाता है। इसे Advanced scenario JSON के ज़रिए दें, और वैलिडेशन द्वारा बताए गए स्वरूप का पालन करें।
निजी कीपैड जानकारी बाद के एक्सप्रेशन सोर्स या सहेजे गए चरण विवरण में उपलब्ध नहीं होती। बाद के किसी स्पीच या परिणाम फ़ील्ड को निजी अंकों पर निर्भर न बनाएँ।
ट्रांसफ़र के दौरान डेटा आगे भेजें
लोकल Transfer गंतव्य एंट्री को एक नया ऑब्जेक्ट देता है। उस एंट्री को जिन मानों की ज़रूरत है, उन्हें मैप करें और उसके आवश्यक फ़ील्ड जाँचें।
गंतव्य को नया trigger.data मिलता है, और पिछले चरणों के आउटपुट हट जाते हैं। कॉल की पहचान, रिकॉर्डिंग की स्थिति और एक्ज़ीक्यूशन सीमाएँ जारी रहती हैं। अगर नई एंट्री को पिछले पाथ की जानकारी चाहिए, तो वह मान स्पष्ट रूप से आगे भेजना ज़रूरी है।
अगले चरण
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।