المتغيرات العامة - مرجع متغيرات النظام في ChatMaxima

نظرة عامة

المتغيرات العامة، التي تسمى أيضًا متغيرات النظام، هي عناصر نائبة مدمجة يقوم ChatMaxima بحلها تلقائيًا أثناء التشغيل. تمنحك إمكانية الوصول إلى معلومات حول جهة الاتصال الحالية والمحادثة والرسالة والمنصة والوسائط دون أي إعداد. يبدأ كل متغير عام بالبادئة sys_ ويُحاط بأقواس معقوفة مفردة، مثل {sys_account_contact_name}.

استخدم المتغيرات العامة في أي مكان تحتاج فيه إلى تخصيص المحتوى أو توجيه المحادثات أو تمرير السياق إلى عمليات التكامل: كتل منشئ الروبوت، وقوالب البث، والردود التلقائية، وقوالب الرسائل، وحمولات واجهة برمجة التطبيقات أو الويب هوك.

كيفية إدراج متغير عام

في أي حقل إدخال مدعوم، ما عليك سوى كتابة { وسيظهر منتقي يسرد كل متغير عام وسمة مخصصة متاحة. اختر المتغير الذي تريده وسيقوم 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}** مفيدان لتمرير الهوية إلى الويب هوك ومزامنة إدارة علاقات العملاء وتدفقات التحقق.
• {sys_contact_reference_id} يحدد سلسلة المحادثة بشكل فريد، وهو مفيد عند ربط الأحداث عبر الأنظمة المختلفة.

متغيرات المحادثة

تصف هذه الرسالة الحالية والسجل.

• {sys_current_message} يحتوي على النص الذي أرسله المستخدم للتو. استخدمه لإعادة عرض المدخلات أو تسجيلها أو تمريرها إلى كتلة واجهة برمجة التطبيقات.
• {sys_current_conversation} يحتوي على سجل الدردشة الكامل مع الطوابع الزمنية، وهو مفيد لتلخيص الذكاء الاصطناعي أو سياق التحويل.

متغيرات القناة والسياق

• {sys_account_platform} يتيح لك تفريع المنطق حسب القناة، على سبيل المثال إرسال رسالة مختلفة على WhatsApp عما على أداة الويب.
• {sys_current_page_url} يلتقط المكان الذي كان فيه الزائر على موقعك عند بدء الدردشة. مفيد للتوجيه أو التحليلات.
• {sys_current_date_time} يضع طابعًا زمنيًا للحظة التنفيذ، وهو مفيد للطوابع الزمنية في التذاكر أو الأنظمة اللاحقة.

متغيرات الذكاء الاصطناعي والوسائط

• {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 أو كتلة روبوت أو واجهة برمجة التطبيقات
استخدمها عندما	تكون البيانات شيئًا يعرفه ChatMaxima بالفعل	تكون البيانات خاصة بمنطق عملك التجاري

أين تستخدم المتغيرات العامة

تعمل المتغيرات العامة عبر المنصة في أي مكان يتوفر فيه منتقي {:

• كتل منشئ الروبوت: إرسال رسالة، وإرسال بريد إلكتروني، وكتلة واجهة برمجة التطبيقات، وكتلة الويب هوك، والكتلة الشرطية، وكتلة تعيين السمة، ومعظم الكتل الأخرى تقبل المتغيرات في حقول النص والمعلمات الخاصة بها.
• قوالب البث: قم بربط العناصر النائبة لقوالب WhatsApp المعتمدة ({{1}}، {{2}}) بالمتغيرات العامة عند إنشاء بث.
• الردود التلقائية والردود الجاهزة: خصّص رسائل الغياب والردود المحفوظة.
• مطالبات الذكاء الاصطناعي لقاعدة المعرفة: مرّر سياق الجلسة إلى المطالبة النظامية لوكيل الذكاء الاصطناعي الخاص بك.
• الويب هوك وعمليات التكامل: قم بتضمين المتغيرات في عناوين 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."

التحية بالاسم في الروبوت

ضع كتلة إرسال رسالة في بداية تدفقك بما يلي:

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

إذا لم يكن لدى جهة الاتصال اسم مسجّل، فسيتم حل العنصر النائب إلى فارغ، لذا أضف فرعًا احتياطيًا عند الحاجة.

التوجيه حسب نية الذكاء الاصطناعي

استخدم {sys_ai_intent} في كتلة شرطية بعد كتلة MaxIA:

• إذا كان {sys_ai_intent} يساوي human_agent، فقم بالتوجيه إلى الدردشة المباشرة
• إذا كان {sys_ai_intent} يساوي booking_request، فانتقل إلى تدفق الحجز الخاص بك
• وإلا، فتابع مع تدفق الأسئلة الشائعة

تمرير السياق إلى الويب هوك

في جسم كتلة الويب هوك:

{
  "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 أو استدعاء واجهة برمجة التطبيقات أو كتلة روبوت تعيين السمة.

الخطوات التالية

• استوديو - نظرة عامة على منشئ الروبوت
• الحملات - بث WhatsApp