Global Variables - ChatMaxima కోసం సిస్టమ్ వేరియబుల్స్ రిఫరెన్స్
కాంటాక్ట్ మరియు సెషన్ డేటాతో బాట్లు, బ్రాడ్కాస్ట్లు మరియు ఆటో రిప్లయ్లను వ్యక్తిగతీకరించడానికి ఉపయోగించే ChatMaxima Global Variables (sys_ సిస్టమ్ ఫీల్డ్లు) కోసం రిఫరెన్స్.
పరిచయం
Global Variables, వీటిని System Variables అని కూడా పిలుస్తారు, ఇవి ChatMaxima రన్టైమ్లో స్వయంచాలకంగా రిజాల్వ్ చేసే అంతర్నిర్మిత ప్లేస్హోల్డర్లు. ఎలాంటి సెటప్ లేకుండానే ప్రస్తుత కాంటాక్ట్, సంభాషణ, సందేశం, ప్లాట్ఫాం మరియు మీడియా గురించిన సమాచారాన్ని అవి మీకు అందిస్తాయి. ప్రతి Global Variable sys_ ప్రిఫిక్స్తో మొదలవుతుంది మరియు {sys_account_contact_name} లాగా ఒకే కర్లీ బ్రేస్లలో చుట్టబడి ఉంటుంది.
కంటెంట్ను వ్యక్తిగతీకరించడానికి, సంభాషణలను రూట్ చేయడానికి, లేదా ఇంటిగ్రేషన్లలోకి సందర్భాన్ని పంపడానికి అవసరమైన ఎక్కడైనా Global Variables ఉపయోగించండి: బాట్ బిల్డర్ బ్లాక్లు, బ్రాడ్కాస్ట్ టెంప్లేట్లు, ఆటో రిప్లయ్లు, సందేశ టెంప్లేట్లు, మరియు API లేదా webhook పేలోడ్లు.
Global Variable ను ఎలా చొప్పించాలి
ఏదైనా మద్దతు ఉన్న ఇన్పుట్ ఫీల్డ్లో, కేవలం { టైప్ చేయండి, అందుబాటులో ఉన్న ప్రతి Global Variable మరియు Custom Attribute ను జాబితా చేసే ఒక పికర్ కనిపిస్తుంది. మీకు కావలసిన దాన్ని ఎంచుకోండి, ChatMaxima దాన్ని సరైన ఫార్మాట్లో చొప్పిస్తుంది.
- మీరు వేరియబుల్ను చొప్పించాలనుకుంటున్న ఫీల్డ్లో క్లిక్ చేయండి
- ఒకే ఓపెనింగ్ కర్లీ బ్రేస్
{టైప్ చేయండి - కనిపించే డ్రాప్డౌన్ నుండి వేరియబుల్ను ఎంచుకోండి
- పికర్ పూర్తి టోకెన్ను చొప్పిస్తుంది, ఉదాహరణకు
{sys_account_contact_name}
గమనిక: వేరియబుల్ పేర్లు కేస్-సెన్సిటివ్. వేరియబుల్ పేరు చుట్టూ ఎల్లప్పుడూ ఒకే కర్లీ బ్రేస్లను ఉపయోగించండి.
మద్దతు ఉన్న Global Variables
| Variable | వివరణ |
|---|---|
{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} ఉపయోగించండి |
Contact Variables
ఇవి కాంటాక్ట్ ప్రొఫైల్పై నిల్వ చేయబడిన డేటాకు రిజాల్వ్ అవుతాయి.
{sys_account_contact_name}వ్యక్తిగతీకరణ కోసం అత్యంత సాధారణ వేరియబుల్. దీన్ని గ్రీటింగ్లలో, బ్రాడ్కాస్ట్ టెంప్లేట్లలో, మరియు నిర్ధారణ సందేశాలలో ఉపయోగించండి.{sys_account_contact_email}మరియు{sys_account_contact_mobile}గుర్తింపును webhook లు, CRM సింక్, మరియు వెరిఫికేషన్ ఫ్లోలలోకి పంపడానికి ఉపయోగపడతాయి.{sys_contact_reference_id}సంభాషణ థ్రెడ్ను ప్రత్యేకంగా గుర్తిస్తుంది, సిస్టమ్ల అంతటా ఈవెంట్లను సహసంబంధం చేసేటప్పుడు ఉపయోగపడుతుంది.
Conversation Variables
ఇవి ప్రస్తుత సందేశం మరియు చరిత్రను వివరిస్తాయి.
{sys_current_message}యూజర్ ఇప్పుడే పంపిన టెక్స్ట్ను కలిగి ఉంటుంది. ఇన్పుట్ను తిరిగి ప్రతిధ్వనించడానికి, దాన్ని లాగ్ చేయడానికి, లేదా API బ్లాక్కు పంపడానికి దీన్ని ఉపయోగించండి.{sys_current_conversation}టైమ్స్టాంప్లతో పూర్తి చాట్ చరిత్రను కలిగి ఉంటుంది, AI సారాంశీకరణ లేదా హ్యాండ్ఆఫ్ సందర్భం కోసం ఉపయోగపడుతుంది.
Channel and Context Variables
{sys_account_platform}ఛానెల్ ద్వారా లాజిక్ను బ్రాంచ్ చేయడానికి మిమ్మల్ని అనుమతిస్తుంది, ఉదాహరణకు Web Widget లో కంటే WhatsApp లో వేరే సందేశాన్ని పంపడం.{sys_current_page_url}విజిటర్ చాట్ ప్రారంభించినప్పుడు మీ సైట్లో వారు ఎక్కడ ఉన్నారో సంగ్రహిస్తుంది. రూటింగ్ లేదా అనలిటిక్స్ కోసం ఉపయోగపడుతుంది.{sys_current_date_time}అమలు జరిగే క్షణాన్ని ముద్రిస్తుంది, టికెట్లలో లేదా దిగువ సిస్టమ్లలో టైమ్స్టాంప్ల కోసం సహాయపడుతుంది.
AI and Media Variables
{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}Global Variables vs Custom Attributes
ChatMaxima రెండు రకాల డైనమిక్ ప్లేస్హోల్డర్లకు మద్దతు ఇస్తుంది. రెండూ ఒకే { పికర్లో కనిపిస్తాయి.
| Global Variables | Custom Attributes | |
|---|---|---|
| Prefix | sys_ | లేదు (పేరును మీరు ఎంచుకుంటారు) |
| దీని ద్వారా సృష్టించబడింది | ChatMaxima (అంతర్నిర్మితం) | మీరు, Contacts సెట్టింగ్లలో |
| ఉదాహరణలు | {sys_account_contact_name}, {sys_current_message} | {company_name}, {order_id}, {plan_type} |
| విలువ యొక్క మూలం | సెషన్, కాంటాక్ట్ ప్రొఫైల్, సందేశం, లేదా ప్లాట్ఫాం సందర్భం | ప్రతి కాంటాక్ట్పై నిల్వ చేయబడుతుంది, మాన్యువల్గా, CSV ఇంపోర్ట్ ద్వారా, బాట్ బ్లాక్ ద్వారా, లేదా API ద్వారా నింపబడుతుంది |
| ఎప్పుడు ఉపయోగించాలి | డేటా ChatMaxima కు ఇప్పటికే తెలిసిన ఏదైనా అయినప్పుడు | డేటా మీ వ్యాపార లాజిక్కు నిర్దిష్టమైనది అయినప్పుడు |
Global Variables ను ఎక్కడ ఉపయోగించాలి
{ పికర్ అందుబాటులో ఉన్న ప్లాట్ఫాం అంతటా ఎక్కడైనా Global Variables పనిచేస్తాయి:
- Bot Builder blocks: Send Message, Send Email, API Block, Webhook Block, Conditional Block, Set Attribute Block, మరియు ఇతర చాలా బ్లాక్లు తమ టెక్స్ట్ మరియు పారామీటర్ ఫీల్డ్లలో వేరియబుల్స్ను అంగీకరిస్తాయి.
- Broadcast templates: బ్రాడ్కాస్ట్ను సృష్టించేటప్పుడు ఆమోదించబడిన WhatsApp టెంప్లేట్ ప్లేస్హోల్డర్లను (
{{1}},{{2}}) Global Variables కు మ్యాప్ చేయండి. - Auto replies and canned responses: అవే-మెసేజ్లు మరియు సేవ్ చేసిన రిప్లయ్లను వ్యక్తిగతీకరించండి.
- Knowledge Base AI prompts: మీ AI ఏజెంట్ సిస్టమ్ ప్రాంప్ట్లోకి సెషన్ సందర్భాన్ని పంపండి.
- Webhooks and integrations: బాహ్య సిస్టమ్లకు సందర్భాన్ని ఫార్వర్డ్ చేయడానికి webhook 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 లోకి సందర్భాన్ని పంపండి
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}వంటి Global Variable ఒక కాంటాక్ట్ కోసం లేకపోతే, ప్లేస్హోల్డర్ ఖాళీగా రిజాల్వ్ అవుతుంది. బ్రాడ్కాస్ట్ చేసే ముందు మీ కాంటాక్ట్ డేటాను శుభ్రపరచండి. - Custom Attributes తో కలపండి: గుర్తింపు మరియు సెషన్ డేటా కోసం Global Variables ను, మరియు ఆర్డర్ నంబర్లు, ప్లాన్ రకాలు, లేదా అపాయింట్మెంట్ తేదీల వంటి వ్యాపార-నిర్దిష్ట ఫీల్డ్ల కోసం Custom Attributes ను ఉపయోగించండి.
- పంపే ముందు పరీక్షించండి: ప్రతి వేరియబుల్ సరిగ్గా రిజాల్వ్ అవుతుందని నిర్ధారించడానికి మీ స్వంత కాంటాక్ట్ రికార్డ్పై టెస్ట్ బ్రాడ్కాస్ట్ లేదా బాట్ సెషన్ను అమలు చేయండి.
- JSON వేరియబుల్స్ కోసం డాట్ నొటేషన్ ఉపయోగించండి:
{sys_current_media}ఒక JSON ఆబ్జెక్ట్ను అందిస్తుంది. సాదా టెక్స్ట్లో పూర్తి ఆబ్జెక్ట్ను ఉపయోగించడానికి బదులుగా{sys_current_media.url}వంటి నిర్దిష్ట ఫీల్డ్లను ఎల్లప్పుడూ యాక్సెస్ చేయండి. - హార్డ్కోడింగ్ను నివారించండి: మీరు లేకపోతే కాంటాక్ట్ పేరు, మొబైల్, లేదా ఈమెయిల్ను టైప్ చేసే ఎక్కడైనా, బదులుగా Global Variable కోసం చేరుకోండి.
ట్రబుల్షూటింగ్
వేరియబుల్ అవుట్పుట్లో అక్షరార్థ టెక్స్ట్గా చూపబడుతుంది
- వేరియబుల్ డబుల్ కాదు, ఒకే కర్లీ బ్రేస్లలో చుట్టబడిందని తనిఖీ చేయండి:
{sys_account_contact_name}సరైనది,{{sys_account_contact_name}}కాదు (డబుల్ బ్రేస్లు Meta టెంప్లేట్ ప్లేస్హోల్డర్ సింటాక్స్, ఆమోదించబడిన WhatsApp టెంప్లేట్ల లోపల మాత్రమే ఉపయోగించబడతాయి). - స్పెల్లింగ్ పికర్తో సరిగ్గా సరిపోతుందని నిర్ధారించండి. వేరియబుల్స్ కేస్-సెన్సిటివ్.
- మీరు వేరియబుల్ను మద్దతు ఉన్న ఫీల్డ్లో ఉపయోగిస్తున్నారని నిర్ధారించుకోండి. బాట్, బ్రాడ్కాస్ట్, మరియు టెంప్లేట్ ఎడిటర్ల వెలుపలి కొన్ని సాదా-టెక్స్ట్ ఫీల్డ్లు వేరియబుల్స్ను పార్స్ చేయవు.
వేరియబుల్ ఖాళీగా రిజాల్వ్ అవుతుంది
- అంతర్లీన డేటా కాంటాక్ట్ ప్రొఫైల్పై ఉందని తనిఖీ చేయండి (ఉదాహరణకు, కాంటాక్ట్కు నిజంగా పేరు లేదా మొబైల్ సేవ్ చేయబడి ఉందా).
{sys_ai_intent}కోసం, వేరియబుల్ ఉపయోగించబడే పాయింట్ కంటే ముందు ఒక MaxIA బ్లాక్ అమలు అయిందని నిర్ధారించండి.{sys_current_media}కోసం, ఈ సెషన్లో యూజర్ మీడియాను పంపారని నిర్ధారించండి.
ChatMaxima బహిర్గతం చేయని విలువ అవసరం
మీకు అవసరమైన విలువ Global Variables జాబితాలో లేకపోతే, ఒక Custom Attribute ను సృష్టించి, కాంటాక్ట్ ప్రొఫైల్, CSV ఇంపోర్ట్, API కాల్, లేదా Set Attribute బాట్ బ్లాక్ ద్వారా దాన్ని నింపండి.