ग्लोबल वेरिएबल्स - ChatMaxima के लिए सिस्टम वेरिएबल्स संदर्भ

अवलोकन

ग्लोबल वेरिएबल्स, जिन्हें सिस्टम वेरिएबल्स भी कहा जाता है, बिल्ट-इन प्लेसहोल्डर्स हैं जिन्हें ChatMaxima रनटाइम पर स्वचालित रूप से रिज़ॉल्व करता है। ये आपको वर्तमान कॉन्टैक्ट, बातचीत, संदेश, प्लेटफ़ॉर्म और मीडिया के बारे में जानकारी तक बिना किसी सेटअप के पहुँच देते हैं। प्रत्येक ग्लोबल वेरिएबल sys_ प्रिफ़िक्स से शुरू होता है और सिंगल कर्ली ब्रेसेस में लपेटा जाता है, जैसे {sys_account_contact_name}।

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

ग्लोबल वेरिएबल कैसे डालें

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

1. उस फ़ील्ड पर क्लिक करें जहाँ आप वेरिएबल डालना चाहते हैं
2. एक सिंगल ओपनिंग कर्ली ब्रेस { टाइप करें
3. दिखाई देने वाले ड्रॉपडाउन से वेरिएबल चुनें
4. पिकर पूरा टोकन डाल देता है, उदाहरण के लिए {sys_account_contact_name}

ध्यान दें: वेरिएबल नाम केस-सेंसिटिव होते हैं। वेरिएबल नाम के चारों ओर हमेशा सिंगल कर्ली ब्रेसेस का उपयोग करें।

समर्थित ग्लोबल वेरिएबल्स

Variable	Description
{sys_account_contact_name}	चैटबॉट सेशन से जुड़े कॉन्टैक्ट का नाम
{sys_account_contact_email}	चैटबॉट के साथ बातचीत कर रहे कॉन्टैक्ट का ईमेल पता
{sys_account_contact_mobile}	कॉन्टैक्ट के अकाउंट से जुड़ा मोबाइल नंबर
{sys_contact_reference_id}	वर्तमान बातचीत के लिए संदर्भ आईडी
{sys_current_message}	बॉट में प्रोसेस किया जा रहा वर्तमान संदेश
{sys_account_platform}	बॉट में प्रोसेस किया जा रहा वर्तमान प्लेटफ़ॉर्म (उदाहरण के लिए, WhatsApp, Facebook, Telegram)
{sys_current_date_time}	निष्पादन के क्षण की वर्तमान तारीख और समय
{sys_current_page_url}	उस वेबपेज का URL जहाँ चैटबॉट वर्तमान में सक्रिय है
{sys_current_conversation}	संदेशों और टाइमस्टैम्प सहित पूरी बातचीत का इतिहास
{sys_ai_intent}	MaxIA ब्लॉक्स में उपयोगकर्ता की क्वेरी से पता लगाया गया इंटेंट (उदाहरण के लिए, general_query, human_agent, booking_request)
{sys_current_media}	उपयोगकर्ता द्वारा अपलोड किए गए सबसे हालिया मीडिया (इमेज, वीडियो, ऑडियो, डॉक्यूमेंट) का URL, टाइप और फ़ाइलनाम, एक JSON ऑब्जेक्ट के रूप में। विशिष्ट फ़ील्ड्स के लिए {sys_current_media.url} या {sys_current_media.type} का उपयोग करें

कॉन्टैक्ट वेरिएबल्स

ये कॉन्टैक्ट प्रोफ़ाइल के विरुद्ध संग्रहीत डेटा में रिज़ॉल्व होते हैं।

• {sys_account_contact_name} व्यक्तिगतकरण के लिए सबसे आम वेरिएबल है। इसे अभिवादन, ब्रॉडकास्ट टेम्पलेट्स और पुष्टिकरण संदेशों में उपयोग करें।
• {sys_account_contact_email} और {sys_account_contact_mobile} वेबहुक, CRM सिंक और सत्यापन फ़्लो में पहचान पास करने के लिए उपयोगी हैं।
• {sys_contact_reference_id} बातचीत थ्रेड को विशिष्ट रूप से पहचानता है, जो सिस्टम भर में घटनाओं को सहसंबंधित करते समय उपयोगी है।

बातचीत वेरिएबल्स

ये वर्तमान संदेश और इतिहास का वर्णन करते हैं।

• {sys_current_message} उस टेक्स्ट को रखता है जो उपयोगकर्ता ने अभी भेजा है। इसका उपयोग इनपुट को वापस इको करने, लॉग करने, या किसी API ब्लॉक में पास करने के लिए करें।
• {sys_current_conversation} में टाइमस्टैम्प के साथ पूरा चैट इतिहास होता है, जो AI सारांशीकरण या हैंडऑफ़ संदर्भ के लिए उपयोगी है।

चैनल और संदर्भ वेरिएबल्स

• {sys_account_platform} आपको चैनल के अनुसार लॉजिक को ब्रांच करने देता है, उदाहरण के लिए WhatsApp पर वेब विजेट की तुलना में अलग संदेश भेजना।
• {sys_current_page_url} यह कैप्चर करता है कि जब विज़िटर ने चैट करना शुरू किया तब वे आपकी साइट पर कहाँ थे। रूटिंग या एनालिटिक्स के लिए उपयोगी।
• {sys_current_date_time} निष्पादन के क्षण पर टाइमस्टैम्प लगाता है, जो टिकट या डाउनस्ट्रीम सिस्टम में टाइमस्टैम्प के लिए सहायक है।

AI और मीडिया वेरिएबल्स

• {sys_ai_intent} इंटेंट डिटेक्शन के बाद MaxIA ब्लॉक्स द्वारा पॉपुलेट किया जाता है। अपने बॉट को इस आधार पर ब्रांच करें कि उपयोगकर्ता human_agent, booking_request, general_query, इत्यादि चाहता है या नहीं।
• {sys_current_media} एक JSON ऑब्जेक्ट है जो उपयोगकर्ता द्वारा भेजी गई सबसे हालिया फ़ाइल का वर्णन करता है। डॉट नोटेशन के साथ अलग-अलग फ़ील्ड्स तक पहुँचें:

{sys_current_media.url}
{sys_current_media.type}
{sys_current_media.filename}

ग्लोबल वेरिएबल्स बनाम कस्टम एट्रिब्यूट्स

ChatMaxima दो प्रकार के डायनामिक प्लेसहोल्डर्स का समर्थन करता है। दोनों एक ही { पिकर में दिखाई देते हैं।

	Global Variables	Custom Attributes
प्रिफ़िक्स	sys_	कोई नहीं (आप नाम चुनते हैं)
द्वारा निर्मित	ChatMaxima (बिल्ट-इन)	आप, कॉन्टैक्ट्स सेटिंग्स में
उदाहरण	{sys_account_contact_name}, {sys_current_message}	{company_name}, {order_id}, {plan_type}
मान का स्रोत	सेशन, कॉन्टैक्ट प्रोफ़ाइल, संदेश, या प्लेटफ़ॉर्म संदर्भ	प्रत्येक कॉन्टैक्ट के विरुद्ध संग्रहीत, मैन्युअल रूप से, CSV इम्पोर्ट से, बॉट ब्लॉक से, या API से पॉपुलेट
कब उपयोग करें	जब डेटा वह हो जो ChatMaxima पहले से जानता हो	जब डेटा आपके व्यावसायिक लॉजिक के लिए विशिष्ट हो

ग्लोबल वेरिएबल्स का उपयोग कहाँ करें

ग्लोबल वेरिएबल्स पूरे प्लेटफ़ॉर्म में वहाँ काम करते हैं जहाँ { पिकर उपलब्ध है:

• बॉट बिल्डर ब्लॉक्स: Send Message, Send Email, API Block, Webhook Block, Conditional Block, Set Attribute Block, और अधिकांश अन्य ब्लॉक्स अपने टेक्स्ट और पैरामीटर फ़ील्ड्स में वेरिएबल्स स्वीकार करते हैं।
• ब्रॉडकास्ट टेम्पलेट्स: ब्रॉडकास्ट बनाते समय स्वीकृत WhatsApp टेम्पलेट प्लेसहोल्डर्स ({{1}}, {{2}}) को ग्लोबल वेरिएबल्स से मैप करें।
• ऑटो रिप्लाई और कैन्ड रिस्पॉन्सेस: अवे-मैसेज और सहेजे गए रिप्लाई को व्यक्तिगत बनाएँ।
• नॉलेज बेस AI प्रॉम्प्ट्स: अपने AI एजेंट के सिस्टम प्रॉम्प्ट में सेशन संदर्भ पास करें।
• वेबहुक और इंटीग्रेशन: बाहरी सिस्टम को संदर्भ अग्रेषित करने के लिए वेबहुक URL, हेडर और रिक्वेस्ट बॉडी में वेरिएबल्स शामिल करें।

उदाहरण उपयोग के मामले

एक WhatsApp ब्रॉडकास्ट को व्यक्तिगत बनाएँ

स्वीकृत टेम्पलेट:

Hello {{1}}, your order {{2}} has been confirmed.

ब्रॉडकास्ट कंपोज़र में, {{1}} को {sys_account_contact_name} से और {{2}} को अपने कस्टम एट्रिब्यूट {order_id} से मैप करें। प्रत्येक प्राप्तकर्ता को "Hello Priya, your order ORD-1042 has been confirmed." जैसा संदेश मिलता है।

एक बॉट में नाम से अभिवादन करें

अपने फ़्लो की शुरुआत में एक Send Message ब्लॉक रखें:

Hi {sys_account_contact_name}, how can we help you today?

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

AI इंटेंट के अनुसार रूट करें

एक MaxIA ब्लॉक के बाद Conditional Block में {sys_ai_intent} का उपयोग करें:

• यदि {sys_ai_intent} human_agent के बराबर है, तो लाइव चैट पर रूट करें
• यदि {sys_ai_intent} booking_request के बराबर है, तो अपने बुकिंग फ़्लो पर जाएँ
• अन्यथा, FAQ फ़्लो के साथ जारी रखें

एक वेबहुक में संदर्भ पास करें

एक Webhook Block बॉडी में:

{
  "name": "{sys_account_contact_name}",
  "phone": "{sys_account_contact_mobile}",
  "message": "{sys_current_message}",
  "platform": "{sys_account_platform}",
  "page": "{sys_current_page_url}"
}

ChatMaxima रिक्वेस्ट भेजने से पहले हर वेरिएबल को लाइव मान से बदल देता है।

एक अपलोड की गई फ़ाइल को अपने बैकएंड पर अग्रेषित करें

यदि कोई उपयोगकर्ता एक इमेज भेजता है और आपको इसे सर्वर-साइड सहेजने की ज़रूरत है, तो उपयोग करें:

{
  "file_url": "{sys_current_media.url}",
  "file_type": "{sys_current_media.type}",
  "file_name": "{sys_current_media.filename}"
}

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

• अपने कॉन्टैक्ट डेटा को सत्यापित करें: यदि किसी कॉन्टैक्ट के लिए {sys_account_contact_mobile} जैसा ग्लोबल वेरिएबल गायब है, तो प्लेसहोल्डर खाली में रिज़ॉल्व होता है। ब्रॉडकास्ट करने से पहले अपने कॉन्टैक्ट डेटा को साफ़ करें।
• कस्टम एट्रिब्यूट्स के साथ संयोजित करें: पहचान और सेशन डेटा के लिए ग्लोबल वेरिएबल्स का उपयोग करें, और ऑर्डर नंबर, प्लान प्रकार, या अपॉइंटमेंट तारीख जैसे व्यवसाय-विशिष्ट फ़ील्ड्स के लिए कस्टम एट्रिब्यूट्स का उपयोग करें।
• भेजने से पहले परीक्षण करें: यह पुष्टि करने के लिए कि हर वेरिएबल सही ढंग से रिज़ॉल्व होता है, अपने स्वयं के कॉन्टैक्ट रिकॉर्ड के विरुद्ध एक टेस्ट ब्रॉडकास्ट या बॉट सेशन चलाएँ।
• JSON वेरिएबल्स के लिए डॉट नोटेशन का उपयोग करें: {sys_current_media} एक JSON ऑब्जेक्ट लौटाता है। प्लेन टेक्स्ट में पूरे ऑब्जेक्ट का उपयोग करने के बजाय हमेशा {sys_current_media.url} जैसे विशिष्ट फ़ील्ड्स तक पहुँचें।
• हार्डकोडिंग से बचें: जहाँ भी आप अन्यथा किसी कॉन्टैक्ट का नाम, मोबाइल, या ईमेल टाइप करते, उसके बजाय एक ग्लोबल वेरिएबल का उपयोग करें।

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

वेरिएबल आउटपुट में लिटरल टेक्स्ट के रूप में दिखता है

1. जाँचें कि वेरिएबल सिंगल कर्ली ब्रेसेस में लपेटा गया है, डबल में नहीं: {sys_account_contact_name} सही है, {{sys_account_contact_name}} नहीं (डबल ब्रेसेस Meta टेम्पलेट प्लेसहोल्डर सिंटैक्स है, जो केवल स्वीकृत WhatsApp टेम्पलेट्स के अंदर उपयोग होता है)।
2. पुष्टि करें कि वर्तनी पिकर से बिल्कुल मेल खाती है। वेरिएबल केस-सेंसिटिव होते हैं।
3. सुनिश्चित करें कि आप वेरिएबल का उपयोग किसी समर्थित फ़ील्ड में कर रहे हैं। बॉट, ब्रॉडकास्ट और टेम्पलेट एडिटर के बाहर कुछ प्लेन-टेक्स्ट फ़ील्ड्स वेरिएबल्स को पार्स नहीं करते।

वेरिएबल खाली में रिज़ॉल्व होता है

1. जाँचें कि अंतर्निहित डेटा कॉन्टैक्ट प्रोफ़ाइल पर मौजूद है (उदाहरण के लिए, कॉन्टैक्ट के पास वास्तव में एक नाम या मोबाइल सहेजा गया है)।
2. {sys_ai_intent} के लिए, पुष्टि करें कि उस बिंदु से पहले एक MaxIA ब्लॉक चला जहाँ वेरिएबल का उपयोग किया गया है।
3. {sys_current_media} के लिए, पुष्टि करें कि उपयोगकर्ता ने इस सेशन में मीडिया भेजा है।

एक ऐसा मान चाहिए जो ChatMaxima उजागर नहीं करता

यदि आपको जो मान चाहिए वह ग्लोबल वेरिएबल्स सूची में नहीं है, तो एक कस्टम एट्रिब्यूट बनाएँ और इसे कॉन्टैक्ट प्रोफ़ाइल, एक CSV इम्पोर्ट, एक API कॉल, या एक Set Attribute बॉट ब्लॉक के माध्यम से पॉपुलेट करें।

अगले कदम

• Studio - Bot Builder Overview
• Campaigns - WhatsApp Broadcasting