WhatsApp में एक Dynamic Data Flow बनाएं

अवलोकन

एक Dynamic Data Flow एक WhatsApp Flow है जिसकी सूचियां आपकी अपनी API से लाइव भरी जाती हैं। प्रत्येक चरण एक सूची है, और एक चरण में ग्राहक का चयन तय करता है कि अगला चरण क्या दिखाता है। यह फ़्लो ग्राहक को आश्रित चयनों की एक श्रृंखला के माध्यम से ले जाता है।

विशिष्ट उदाहरण:

• Healthcare - Doctor, फिर उपलब्ध Date, फिर उपलब्ध Time slot।
• E-commerce - Category, फिर Product।
• Services - Branch, फिर Service, फिर Staff member।

Form Builder के विपरीत, विकल्प हाथ से दर्ज नहीं किए जाते। जब ग्राहक अगली स्क्रीन पर जाता है, तो WhatsApp एक सुरक्षित ChatMaxima एंडपॉइंट को कॉल करता है, जो आपकी API को कॉल करता है और अगली सूची लौटाता है। कुछ भी हार्डकोड नहीं किया गया है, इसलिए वही फ़्लो आपके द्वारा परिभाषित चरणों की किसी भी श्रृंखला के लिए काम करता है।

यह कैसे काम करता है

1. ग्राहक फ़्लो खोलता है और पहले चरण की सूची देखता है।
2. वे एक चयन करते हैं।
3. WhatsApp उस चयन को ChatMaxima के एन्क्रिप्टेड एंडपॉइंट को भेजता है।
4. ChatMaxima अगले चरण के लिए आपकी API को कॉल करता है, पहले के चयनों को पास करते हुए।
5. अगली सूची दिखाई देती है। यह अंतिम सारांश स्क्रीन तक दोहराया जाता है।

पूर्व-आवश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

• एक कनेक्टेड WhatsApp खाता - ChatMaxima से जुड़ा एक WhatsApp Cloud API नंबर।
• प्रत्येक चरण के लिए एक API - एक HTTPS एंडपॉइंट जो विकल्पों की एक JSON सूची लौटाता है।
• एन्क्रिप्शन की सेट अप - प्रति WhatsApp खाता एक बार का सेटअप, नीचे वर्णित है।

ध्यान दें: Dynamic Data Flow एंडपॉइंट-संचालित होते हैं, इसलिए WhatsApp को एक एन्क्रिप्शन की आवश्यकता होती है। डायनेमिक फ़्लो सहेजने से पहले आपको एन्क्रिप्शन सेटअप पूरा करना होगा।

चरण 1: एक Dynamic Data Flow शुरू करें

1. Campaigns फिर WhatsApp Flows पर जाएं और Create Flow पर क्लिक करें।
2. एक Flow Name दर्ज करें और एक Category चुनें।
3. Flow Type को Dynamic Data Flow पर सेट करें।

बिल्डर Dynamic Steps व्यू पर स्विच हो जाता है।

चरण 2: एन्क्रिप्शन की सेट अप करें

एक Dynamic Data Flow प्रत्येक स्क्रीन के लिए एक ChatMaxima एंडपॉइंट को कॉल करता है, और WhatsApp को आवश्यकता होती है कि वह चैनल एन्क्रिप्टेड हो।

1. Endpoint Encryption कार्ड में, Set up Encryption Key पर क्लिक करें।
2. ChatMaxima खाते के लिए एक RSA की जोड़ी उत्पन्न करता है और सार्वजनिक की को स्वचालित रूप से Meta पर अपलोड करता है।

यह प्रति WhatsApp खाता एक बार की कार्रवाई है। उस खाते पर हर डायनेमिक फ़्लो उसी की का पुनः उपयोग करता है।

चरण 3: चरण जोड़ें

प्रत्येक चरण एक आश्रित सूची है। Add Step पर क्लिक करें और चरण संपादक भरें।

चरण फ़ील्ड

फ़ील्ड	विवरण
Step Title	स्क्रीन का शीर्षक, उदाहरण के लिए Select a Category
Step Key	एक लोअरकेस पहचानकर्ता, उदाहरण के लिए category, बाद में {category} के रूप में संदर्भित
List Label	सूची के ऊपर दिखाया गया लेबल
HTTP Method	API कॉल के लिए GET या POST
API URL	वह एंडपॉइंट जो इस चरण के विकल्प लौटाता है
Authentication	None, Bearer Token, Basic Auth, या Custom Header

पहले के चयनों को पास करना

बाद के चरण को पहले के चरण पर निर्भर बनाने के लिए, पहले के चरण की की को उसके API URL में एक प्लेसहोल्डर के रूप में रखें। ChatMaxima इसे रनटाइम पर ग्राहक के चयन से बदल देता है।

https://api.example.com/products?category={category}

इस उदाहरण में, product चरण का URL चुनी गई category को सम्मिलित करता है।

चरण 4: API प्रतिक्रिया को मैप करें

चरण संपादक का Response Mapping अनुभाग ChatMaxima को बताता है कि आपकी API के JSON को कैसे पढ़ना है।

फ़ील्ड	विवरण
List Path	प्रतिक्रिया में ऐरे का पथ, उदाहरण के लिए data। यदि प्रतिक्रिया पहले से ही एक ऐरे है तो खाली छोड़ दें
ID Field	विकल्प के मान के रूप में उपयोग किया जाने वाला फ़ील्ड, उदाहरण के लिए id
Title Field	विकल्प के मुख्य टेक्स्ट के रूप में दिखाया गया फ़ील्ड, उदाहरण के लिए name
Description Field	एक वैकल्पिक द्वितीयक पंक्ति, उदाहरण के लिए price

नेस्टेड फ़ील्ड के लिए डॉट नोटेशन समर्थित है, जैसे price.amount।

चरण 5: सहेजें और प्रकाशित करें

1. Save Dynamic Flow पर क्लिक करें। ChatMaxima आपके चरणों से WhatsApp Flow स्क्रीन उत्पन्न करता है और उन्हें अपलोड करता है।
2. सहेजे गए ड्राफ़्ट को खोलें और Publish पर क्लिक करें।

अंतिम स्क्रीन एक summary है जो ग्राहक के पुष्टि करने से पहले हर चयन को दोहराती है।

सर्वोत्तम अभ्यास

• स्पष्ट step keys का उपयोग करें - छोटी, लोअरकेस, और अर्थपूर्ण, क्योंकि वे URL में दिखाई देती हैं।
• छोटी सूचियां लौटाएं - WhatsApp सूचियां विकल्पों के एक केंद्रित सेट के साथ सबसे अच्छा काम करती हैं।
• चरणों को सामान्य से विशिष्ट की ओर क्रमबद्ध करें - उदाहरण के लिए Product से पहले Category।
• प्रत्येक API का परीक्षण करें - सहेजने से पहले पुष्टि करें कि प्रत्येक एंडपॉइंट अपेक्षित JSON लौटाता है।

समस्या निवारण

सहेजना विफल होता है और एन्क्रिप्शन की मांगता है

1. Endpoint Encryption कार्ड खोलें।
2. Set up Encryption Key पर क्लिक करें और पुष्टि की प्रतीक्षा करें।
3. डायनेमिक फ़्लो फिर से सहेजें।

एक चरण खाली सूची दिखाता है

1. जांचें कि API URL सही है और HTTPS पर पहुंच योग्य है।
2. सत्यापित करें कि List Path, ID Field, और Title Field आपकी API के JSON से मेल खाते हैं।
3. पुष्टि करें कि URL में कोई भी {placeholder} पहले के चरण की की से मेल खाता है।

एक चरण API तक नहीं पहुंच सकता

1. API एक सार्वजनिक HTTPS एंडपॉइंट होना चाहिए। आंतरिक या निजी पते सुरक्षा के लिए अवरुद्ध हैं।
2. पुष्टि करें कि प्रमाणीकरण विवरण सही हैं।

अगले चरण

• Form Builder के साथ एक Flow बनाएं →
• WhatsApp Flows क्या हैं →
• WhatsApp ब्रॉडकास्टिंग →