Global Variables - ChatMaxima-க்கான System Variables குறிப்பு

கண்ணோட்டம்

System Variables என்றும் அழைக்கப்படும் Global Variables, இயக்க நேரத்தில் ChatMaxima தானாகவே தீர்வு செய்யும் உள்ளமைந்த placeholder-களாகும். தற்போதைய தொடர்பு, உரையாடல், செய்தி, தளம், மற்றும் ஊடகம் பற்றிய தகவலுக்கு எந்த அமைப்பும் இல்லாமல் இவை உங்களுக்கு அணுகலை வழங்குகின்றன. ஒவ்வொரு Global Variable-உம் sys_ முன்னொட்டுடன் தொடங்கி, {sys_account_contact_name} போன்று ஒற்றை curly brace-களுக்குள் சுற்றப்படுகிறது.

உள்ளடக்கத்தை தனிப்பயனாக்க, உரையாடல்களை வழிநடத்த, அல்லது integrations-க்குள் context-ஐ அனுப்ப தேவைப்படும் எந்த இடத்திலும் Global Variables-ஐ பயன்படுத்துங்கள்: bot builder blocks, broadcast templates, auto replies, message templates, மற்றும் API அல்லது webhook payloads.

ஒரு Global Variable-ஐ எவ்வாறு செருகுவது

ஆதரிக்கப்படும் எந்த உள்ளீட்டு புலத்திலும், { என்று தட்டச்சு செய்தால், கிடைக்கக்கூடிய ஒவ்வொரு Global Variable மற்றும் Custom Attribute-ஐயும் பட்டியலிடும் ஒரு picker தோன்றும். உங்களுக்கு வேண்டியதைத் தேர்ந்தெடுத்தால் ChatMaxima அதை சரியான வடிவத்தில் செருகும்.

1. variable-ஐ செருக விரும்பும் புலத்தில் கிளிக் செய்யவும்
2. ஒற்றை திறப்பு curly brace { ஐ தட்டச்சு செய்யவும்
3. தோன்றும் dropdown-இலிருந்து variable-ஐ தேர்ந்தெடுக்கவும்
4. picker முழு token-ஐ செருகுகிறது, எடுத்துக்காட்டாக {sys_account_contact_name}

குறிப்பு: Variable பெயர்கள் எழுத்து வழக்கை உணரக்கூடியவை (case-sensitive). எப்போதும் variable பெயரைச் சுற்றி ஒற்றை curly brace-களைப் பயன்படுத்தவும்.

ஆதரிக்கப்படும் Global Variables

Variable	விளக்கம்
{sys_account_contact_name}	chatbot அமர்வுடன் தொடர்புடைய தொடர்பின் பெயர்
{sys_account_contact_email}	chatbot-உடன் தொடர்பு கொள்ளும் தொடர்பின் மின்னஞ்சல் முகவரி
{sys_account_contact_mobile}	தொடர்பின் கணக்குடன் தொடர்புடைய கைபேசி எண்
{sys_contact_reference_id}	தற்போதைய உரையாடலுக்கான குறிப்பு id
{sys_current_message}	ஒரு bot-இல் தற்போது செயலாக்கப்படும் செய்தி
{sys_account_platform}	ஒரு bot-இல் தற்போது செயலாக்கப்படும் தளம் (எடுத்துக்காட்டாக, WhatsApp, Facebook, Telegram)
{sys_current_date_time}	செயல்படுத்தப்படும் தருணத்தில் தற்போதைய தேதி மற்றும் நேரம்
{sys_current_page_url}	chatbot தற்போது செயலில் உள்ள இணையப் பக்கத்தின் URL
{sys_current_conversation}	செய்திகள் மற்றும் timestamps உள்ளிட்ட முழு உரையாடல் வரலாறு
{sys_ai_intent}	MaxIA blocks-இல் பயனரின் வினவலிலிருந்து கண்டறியப்பட்ட intent (எடுத்துக்காட்டாக, general_query, human_agent, booking_request)
{sys_current_media}	பயனர் பதிவேற்றிய மிக சமீபத்திய ஊடகத்தின் (image, video, audio, document) URL, type, மற்றும் filename, ஒரு JSON object-ஆக. குறிப்பிட்ட புலங்களுக்கு {sys_current_media.url} அல்லது {sys_current_media.type} ஐ பயன்படுத்தவும்

தொடர்பு Variables

இவை தொடர்பு சுயவிவரத்தில் சேமிக்கப்பட்ட தரவுக்கு தீர்வு செய்கின்றன.

• {sys_account_contact_name} என்பது தனிப்பயனாக்கத்திற்கான மிகவும் பொதுவான variable. வாழ்த்துகள், broadcast templates, மற்றும் உறுதிப்படுத்தல் செய்திகளில் இதைப் பயன்படுத்தவும்.
• {sys_account_contact_email} மற்றும் {sys_account_contact_mobile} என்பவை webhooks, CRM sync, மற்றும் சரிபார்ப்பு flows-க்குள் அடையாளத்தை அனுப்புவதற்கு பயனுள்ளவை.
• {sys_contact_reference_id} உரையாடல் thread-ஐ தனிப்பட்ட முறையில் அடையாளம் காண்கிறது, அமைப்புகளுக்கு இடையில் நிகழ்வுகளை தொடர்புபடுத்தும்போது பயனுள்ளது.

உரையாடல் Variables

இவை தற்போதைய செய்தி மற்றும் வரலாற்றை விவரிக்கின்றன.

• {sys_current_message} என்பது பயனர் இப்போது அனுப்பிய உரையைக் கொண்டுள்ளது. உள்ளீட்டை மீண்டும் echo செய்ய, அதை log செய்ய, அல்லது API block-க்கு அனுப்ப இதைப் பயன்படுத்தவும்.
• {sys_current_conversation} என்பது timestamps உடன் முழு உரையாடல் வரலாற்றைக் கொண்டுள்ளது, AI summarization அல்லது handoff context-க்கு பயனுள்ளது.

சேனல் மற்றும் Context Variables

• {sys_account_platform} சேனல் வாரியாக logic-ஐ branch செய்ய அனுமதிக்கிறது, எடுத்துக்காட்டாக Web Widget-ஐ விட WhatsApp-இல் வேறு செய்தியை அனுப்புவது.
• {sys_current_page_url} உரையாடலைத் தொடங்கியபோது பார்வையாளர் உங்கள் தளத்தில் எங்கிருந்தார் என்பதைப் பிடிக்கிறது. வழிநடத்தல் அல்லது analytics-க்கு பயனுள்ளது.
• {sys_current_date_time} செயல்படுத்தப்பட்ட தருணத்தை முத்திரையிடுகிறது, tickets அல்லது downstream அமைப்புகளில் timestamps-க்கு உதவியாக இருக்கும்.

AI மற்றும் ஊடக Variables

• {sys_ai_intent} என்பது intent கண்டறிதலுக்குப் பிறகு MaxIA blocks-ஆல் நிரப்பப்படுகிறது. பயனர் human_agent, booking_request, general_query போன்றவற்றை விரும்புகிறாரா என்பதன் அடிப்படையில் உங்கள் bot-ஐ branch செய்யவும்.
• {sys_current_media} என்பது பயனர் அனுப்பிய மிக சமீபத்திய கோப்பை விவரிக்கும் ஒரு JSON object. dot notation மூலம் தனிப்பட்ட புலங்களை அணுகவும்:

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

Global Variables vs Custom Attributes

ChatMaxima இரண்டு வகையான dynamic placeholder-களை ஆதரிக்கிறது. இரண்டும் ஒரே { picker-இல் தோன்றும்.

	Global Variables	Custom Attributes
முன்னொட்டு	sys_	இல்லை (பெயரை நீங்கள் தேர்வு செய்கிறீர்கள்)
உருவாக்கியவர்	ChatMaxima (உள்ளமைந்தது)	நீங்கள், Contacts settings-இல்
எடுத்துக்காட்டுகள்	{sys_account_contact_name}, {sys_current_message}	{company_name}, {order_id}, {plan_type}
மதிப்பின் ஆதாரம்	அமர்வு, தொடர்பு சுயவிவரம், செய்தி, அல்லது தள context	ஒவ்வொரு தொடர்புக்கும் சேமிக்கப்படுகிறது, கைமுறையாக, CSV import மூலம், bot block மூலம், அல்லது API மூலம் நிரப்பப்படுகிறது
எப்போது பயன்படுத்துவது	ChatMaxima ஏற்கனவே அறிந்த ஒரு தரவு இருக்கும்போது	உங்கள் வணிக logic-க்கு குறிப்பிட்ட தரவு இருக்கும்போது

Global Variables-ஐ எங்கே பயன்படுத்துவது

{ picker கிடைக்கும் எந்த இடத்திலும் தளம் முழுவதும் Global Variables செயல்படுகின்றன:

• Bot Builder blocks: Send Message, Send Email, API Block, Webhook Block, Conditional Block, Set Attribute Block, மற்றும் மற்ற பெரும்பாலான blocks அவற்றின் உரை மற்றும் parameter புலங்களில் variables-ஐ ஏற்கின்றன.
• Broadcast templates: ஒரு broadcast-ஐ உருவாக்கும்போது அங்கீகரிக்கப்பட்ட WhatsApp template placeholders ({{1}}, {{2}}) ஐ Global Variables-உடன் map செய்யவும்.
• Auto replies மற்றும் canned responses: away-messages மற்றும் சேமிக்கப்பட்ட பதில்களை தனிப்பயனாக்கவும்.
• Knowledge Base AI prompts: உங்கள் AI agent-இன் system prompt-க்குள் அமர்வு context-ஐ அனுப்பவும்.
• Webhooks மற்றும் integrations: external அமைப்புகளுக்கு context-ஐ அனுப்ப webhook URLs, headers, மற்றும் request bodies-இல் variables-ஐ சேர்க்கவும்.

எடுத்துக்காட்டு பயன்பாட்டு நிலைகள்

ஒரு WhatsApp broadcast-ஐ தனிப்பயனாக்கவும்

அங்கீகரிக்கப்பட்ட template:

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

broadcast composer-இல், {{1}} ஐ {sys_account_contact_name} உடனும் {{2}} ஐ உங்கள் custom attribute {order_id} உடனும் map செய்யவும். ஒவ்வொரு பெறுநரும் "Hello Priya, your order ORD-1042 has been confirmed." போன்ற செய்தியைப் பெறுகிறார்.

ஒரு bot-இல் பெயரால் வாழ்த்துங்கள்

உங்கள் flow-இன் தொடக்கத்தில் ஒரு Send Message block-ஐ இடவும்:

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

தொடர்புக்கு கோப்பில் பெயர் இல்லை எனில், placeholder காலியாக தீர்வு செய்யப்படும், எனவே தேவைப்படும்போது ஒரு fallback branch-ஐ சேர்க்கவும்.

AI intent மூலம் வழிநடத்தவும்

ஒரு MaxIA block-க்குப் பிறகு ஒரு Conditional Block-இல் {sys_ai_intent} ஐ பயன்படுத்தவும்:

• {sys_ai_intent} human_agent-க்கு சமமாக இருந்தால், live chat-க்கு வழிநடத்தவும்
• {sys_ai_intent} booking_request-க்கு சமமாக இருந்தால், உங்கள் booking flow-க்கு செல்லவும்
• இல்லையெனில், FAQ flow-உடன் தொடரவும்

ஒரு webhook-க்குள் context-ஐ அனுப்பவும்

ஒரு Webhook Block body-இல்:

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

request-ஐ அனுப்புவதற்கு முன் ChatMaxima ஒவ்வொரு variable-ஐயும் நேரடி மதிப்புடன் மாற்றுகிறது.

பதிவேற்றிய கோப்பை உங்கள் backend-க்கு அனுப்பவும்

ஒரு பயனர் ஒரு image-ஐ அனுப்பினால், அதை server-side-இல் சேமிக்க வேண்டுமெனில், பயன்படுத்தவும்:

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

சிறந்த நடைமுறைகள்

• உங்கள் தொடர்பு தரவை சரிபார்க்கவும்: ஒரு தொடர்புக்கு {sys_account_contact_mobile} போன்ற ஒரு Global Variable காணவில்லை எனில், placeholder காலியாக தீர்வு செய்யப்படும். broadcasting-க்கு முன் உங்கள் தொடர்பு தரவை சுத்தம் செய்யவும்.
• Custom Attributes-உடன் இணைக்கவும்: அடையாளம் மற்றும் அமர்வு தரவுக்கு Global Variables-ஐயும், order numbers, plan types, அல்லது appointment dates போன்ற வணிகம் சார்ந்த புலங்களுக்கு Custom Attributes-ஐயும் பயன்படுத்தவும்.
• அனுப்புவதற்கு முன் சோதிக்கவும்: ஒவ்வொரு variable-உம் சரியாக தீர்வு செய்கிறதா என்பதை உறுதிப்படுத்த உங்கள் சொந்த தொடர்பு பதிவுக்கு எதிராக ஒரு test broadcast அல்லது bot அமர்வை இயக்கவும்.
• JSON variables-க்கு dot notation-ஐ பயன்படுத்தவும்: {sys_current_media} ஒரு JSON object-ஐ வழங்குகிறது. முழு object-ஐ plain text-இல் பயன்படுத்துவதற்குப் பதிலாக எப்போதும் {sys_current_media.url} போன்ற குறிப்பிட்ட புலங்களை அணுகவும்.
• Hardcoding-ஐ தவிர்க்கவும்: ஒரு தொடர்பின் பெயர், கைபேசி, அல்லது மின்னஞ்சலை நீங்கள் தட்டச்சு செய்யும் எந்த இடத்திலும், அதற்குப் பதிலாக ஒரு Global Variable-ஐ பயன்படுத்தவும்.

சிக்கல் தீர்த்தல்

output-இல் variable அப்படியே உரையாக காண்பிக்கப்படுகிறது

1. variable இரட்டை அல்ல, ஒற்றை curly brace-களுக்குள் சுற்றப்பட்டுள்ளதா எனச் சரிபார்க்கவும்: {sys_account_contact_name} சரியானது, {{sys_account_contact_name}} சரியல்ல (இரட்டை brace-கள் Meta template placeholder syntax, அங்கீகரிக்கப்பட்ட WhatsApp templates-க்குள் மட்டுமே பயன்படுத்தப்படுகிறது).
2. picker-உடன் சரியாக எழுத்துப்பிழை பொருந்துகிறதா என்பதை உறுதிப்படுத்தவும். Variables எழுத்து வழக்கை உணரக்கூடியவை.
3. நீங்கள் variable-ஐ ஆதரிக்கப்படும் புலத்தில் பயன்படுத்துகிறீர்கள் என்பதை உறுதிசெய்யவும். bot, broadcast, மற்றும் template editors-க்கு வெளியே சில plain-text புலங்கள் variables-ஐ பாகுபடுத்தாது.

variable காலியாக தீர்வு செய்யப்படுகிறது

1. அடிப்படை தரவு தொடர்பு சுயவிவரத்தில் உள்ளதா எனச் சரிபார்க்கவும் (எடுத்துக்காட்டாக, தொடர்புக்கு உண்மையில் ஒரு பெயர் அல்லது கைபேசி சேமிக்கப்பட்டுள்ளதா).
2. {sys_ai_intent}-க்கு, variable பயன்படுத்தப்படும் புள்ளிக்கு முன் ஒரு MaxIA block இயங்கியதா என்பதை உறுதிப்படுத்தவும்.
3. {sys_current_media}-க்கு, இந்த அமர்வில் பயனர் ஊடகத்தை அனுப்பியுள்ளார் என்பதை உறுதிப்படுத்தவும்.

ChatMaxima வெளிப்படுத்தாத ஒரு மதிப்பு தேவைப்படுகிறது

உங்களுக்குத் தேவையான மதிப்பு Global Variables பட்டியலில் இல்லையெனில், ஒரு Custom Attribute-ஐ உருவாக்கி, அதை தொடர்பு சுயவிவரம், CSV import, API அழைப்பு, அல்லது Set Attribute bot block மூலம் நிரப்பவும்.

அடுத்த படிகள்

• Studio - Bot Builder Overview
• Campaigns - WhatsApp Broadcasting