كل خطوة في الإجراء هي أحد الإجراءات أدناه. يُضاف معظمها لك من كلماتك. ويمكنك أيضًا إدراج أي منها عبر /، وفتح أي شريحة لتغيير إعداداتها.
الإجراء | ما يفعله | مجموعة القائمة |
قل | يخبر العميل بشيء؛ نص السطر نفسه هو الرسالة | المسار |
سؤال العميل | يطرح سؤالًا وينتظر الإجابة | المسار |
شرط | يفرّع المسار بـ إذا / وإلا إذا / وإلا | المسار |
تحويل إلى فريق | يصعّد المحادثة إلى فريق | المسار |
إنهاء | يُنهي المحادثة بوصفها محلولة، مع رسالة اختيارية | المسار |
تشغيل إجراء فرعي | يشغّل إجراءً آخر كخطوة واحدة | المسار |
إجراء قراءة | يجلب بيانات من تكامل | البيانات / المتجر / الإجراءات |
إجراء كتابة | يعدّل بيانات في تكامل (يُطلب التأكيد دائمًا) | البيانات / الإجراءات |
البحث في المحتوى | يبحث في قاعدة المعرفة | البيانات |
تعيين متغير | يخزّن قيمة أو متغيرًا أو أول عنصر في قائمة | البيانات |
استبدال قيمة متغيّر | يعطي متغيّرًا موجودًا قيمة جديدة | البيانات |
تشغيل كود | يحسب قيمة بمقطع Python قصير | البيانات |
إضافة ملاحظة | يترك ملاحظة داخلية لفريقك | صندوق الوارد |
إضافة موضوع | يضيف موضوعًا أو أكثر من مواضيع محادثاتك | صندوق الوارد |
إنشاء تذكرة | يفتح تذكرة ويعبّئ حقولها من قيم أو متغيرات أو إجابات العميل | صندوق الوارد |
إنشاء مهمة | يفتح مهمة على المحادثة لفريقك | صندوق الوارد |
وسم جهة الاتصال | يضع أحد وسوم جهات الاتصال لديك على العميل | صندوق الوارد |
تعيين سمة جهة الاتصال | يحفظ القيم التي جُمعت في سمات جهة اتصال العميل | صندوق الوارد |
تظهر إجراءات المتجر تحت "المتجر · <متجرك>"، وتظهر إجراءاتك الخاصة تحت "الإجراءات" بمجرد أن تكتب جزءًا من اسمها. لا يمكن أن يحتوي السطر إلا على شريحة واحدة من سؤال العميل أو إنهاء أو تحويل، ولا يجوز أن يأتي بعدها أي شيء (لا نص ولا شريحة أخرى).
سؤال العميل
اسم المتغير: مكان حفظ الإجابة. في وضع النص الحر، يتيح + إضافة متغير آخر لسؤال واحد أن يجمع عدة إجابات، يمكن للعميل تقديمها في رسالة واحدة.
نوع الإجابة:
نص حر، مع نوع قيمة text أو number أو date.
اختيار من خيارات ثابتة: خيار واحد في كل سطر. على واتساب تظهر الخيارات كقائمة للنقر عليها.
اختيار من قائمة: يختار العميل سجلًا واحدًا من متغير قائمة، مثل @bookings. اختر حقول عنوان الصف وحقول العنوان الفرعي المراد عرضها.
أقصى عدد محاولات: عدد مرات طرح السؤال قبل التوقف عن المحاولة. الافتراضي: 2.
إذا لم تكن هناك إجابة: تحويل (الافتراضي)، أو إنهاء أو متابعة. السؤال الذي يضيفه المحرر لإجابة اختيارية يبدأ على «متابعة».
إذا كان العميل قد ذكر الإجابة صراحةً منذ بدء الإجراء، يُتخطّى السؤال.
إجراء قراءة وإجراء كتابة
الإجراء: الإجراء المراد تنفيذه. تعرض إجراءات المتجر اسم المتجر بعدها، مثل "Get order by id · Salla".
المدخلات: متغير واحد لكل مُدخل. المدخلات المطلوبة معلَّمة بـ *. إذا تركت مُدخلًا مطلوبًا فارغًا، سيسأل الوكيل العميل عنه. تحتاج إجراءات المتجر إلى تعبئة كل مُدخل مطلوب.
حفظ النتيجة باسم: المتغير الذي يحمل النتيجة.
يطلب إجراء الكتابة دائمًا من العميل التأكيد قبل تنفيذه. إذا فشل إجراء قراءة أو كتابة، يحوّل الإجراء المحادثة، ما لم يتحقق شرط لاحق من هذا الفشل.
البحث في المحتوى
الاستعلام: ما يُبحث عنه في قاعدة المعرفة.
حد التطابق (0–1): مدى القرب المطلوب للمقال. الافتراضي: 0.3.
حفظ النتيجة باسم.
تعيين متغير واستبدال قيمة متغيّر
تعيين متغير يخزّن قيمة ثابتة، أو متغيرًا آخر، أو أول عنصر في قائمة. حدّد تذكّر طوال الجلسة للاحتفاظ به للإجراءات اللاحقة في المحادثة نفسها.
استبدال قيمة متغيّر يعطي متغيّرًا موجودًا قيمة جديدة، من متغير آخر أو من قيمة ثابتة.
إضافة ملاحظة
اكتب الملاحظة وأشر إلى المتغيرات، مثل "سأل العميل عن الطلب @order.number". الملاحظات داخلية: يراها فريقك في صندوق الوارد، ولا يراها العميل أبدًا.
إضافة موضوع
اختر من المواضيع الموجودة لدى نشاطك التجاري. تُنشأ المواضيع الجديدة من الإعدادات.
إنشاء تذكرة
نوع التذكرة. لا يمكن استخدام نوع يتطلب مرفقًا، لأن الوكيل لا يستطيع جمع الملفات.
العنوان: اختياري. إذا تُرك فارغًا، تُسمّى التذكرة باسم نوعها.
الوصف، والحالة الابتدائية، والفريق المُسند والوسوم: اختيارية.
الحقول: الحقول المطلوبة مضمّنة دائمًا. لكل حقل، اختر سؤال العميل أو قيمة ثابتة أو من متغير.
حفظ النتيجة باسم: يحتوي على التذكرة المُنشأة، أو على خطأ يمكنك التفرّع عليه.
إنشاء مهمة
نوع المهمة، والعنوان والوصف الاختياريان، والفريق المُسند، والوسوم، وحفظ النتيجة باسم.
وسم جهة الاتصال وتعيين سمة جهة الاتصال
وسم جهة الاتصال: وسم واحد لكل مجموعة. تعيين وسم يستبدل الوسم الحالي لجهة الاتصال في تلك المجموعة.
تعيين سمة جهة الاتصال: اختر السمات المراد حفظها ومصدر كل قيمة. يجب أن تطابق القيمة المحفوظة في سمة من نوع الاختيار أحد خياراتها.
لا يضيف المحرر «تعيين متغير» أو «وسم جهة الاتصال» أو «تعيين سمة جهة الاتصال» من كلماتك. أدرجها عبر /.
تحويل إلى فريق
اختر الفريق. تنتقل المحادثة إلى ذلك الفريق، ويتوقف الإجراء.
إنهاء
رسالة الختام: اختيارية. أشر إلى المتغيرات بـ @.
تشغيل إجراء فرعي
اختر الإجراء الفرعي المنشور وعبّئ المدخلات الخاصة به. تظهر مخرجاته بالشكل "ينتج: …". راجع "الإجراءات الفرعية" أدناه.
الشروط وتشغيل كود
ترسل الشروط العملاء في مسارات مختلفة. ويحسب «تشغيل كود» قيمًا دقيقة يمكن أن تعتمد عليها تلك الشروط أو الخطوات اللاحقة.
شكل الشرط
الشرط هو كتلة إذا تضم فرعًا واحدًا أو أكثر:
إذا الحالة الأولى
وإلا إذا حالة أخرى (بالعدد الذي تحتاجه)
وإلا كل ما عدا ذلك
يحتوي كل فرع على خطواته الخاصة، مرقّمة 1. و2. و… داخله. استخدم قائمة + على الشرط لاختيار إضافة «وإلا إذا» أو إضافة «وإلا» أو إزالة الشرط.
من دون «وإلا»، يواصل العميل الذي لا يطابق أي فرع إلى الخطوة التالية بعد الكتلة. ويعرض الشرط: "وإلا، تابع إلى الخطوة التالية."
طريقتان للحكم على الفرع
استخدم المُحدِّد في نهاية حقل شرط الفرع، الذي يعرض لغة طبيعية أو كود، لاختيار طريقة الحكم على الفرع:
الوضع | كيف يقرّر | مثال |
لغة طبيعية | يحكم الذكاء الاصطناعي على الجملة | جميع الحجوزات ملغاة |
كود | تعبير Python، صحيح أو خطأ | len(bookings) == 0 |
اللغة الطبيعية هي الأسهل. عندما لا يستطيع الذكاء الاصطناعي الحسم بعد، يسأل العميل سؤالًا قصيرًا واحدًا، ويحوّل المحادثة إذا ظل غير قادر على الحسم. استخدم كود عندما يجب أن تكون الإجابة دقيقة.
قواعد الشروط
لا يمكن وضع شرط داخل فرع شرط آخر. للتحقق من أمرين، اكتبهما كشرط واحد ("إذا كان الطلب قد سُلّم ومرّ عليه أكثر من 14 يومًا…")، أو كشروط منفصلة واحدًا تلو الآخر.
يجب ألا يترك الإجراء العميل أبدًا دون خطوة تالية. يجب أن يصل كل مسار إلى إنهاء أو تحويل، وإلا يعرض «اختبار» و«نشر»: "the workflow can run out of steps here". تأكد من أن كل فرع، بما فيه «وإلا»، ينتهي بـ «إنهاء» أو «تحويل»، أو تليه خطوات تنتهي بأحدهما.
لمعالجة إجراء فاشل، أضف فرعًا مثل "إذا لم يُعثر على الطلب…". عندها يواصل ذلك الإجراء عند فشله بدلًا من تحويل المحادثة.
تشغيل كود
يحسب «تشغيل كود» قيمة بمقطع Python قصير. استخدمه للتواريخ والمجاميع والأعداد والقوائم المُصفّاة.
افتح الشريحة وانقر فتح المحرر. في محرر كود Python:
انقر إنشاء بالذكاء الاصطناعي وصِف ما يجب حسابه، مثل "عدّ الحجوزات الملغاة". انقر اكتب الكود. يكتب كودًا يجتاز الفحص مسبقًا ويعرض النتيجة على قيم تجريبية.
أو اكتبه بنفسك. استخدم إدراج متغير لقراءة متغير. يجب أن يُرجع السطر الأخير قيمة.
اختر نوع النتيجة: بدون نوع (الافتراضي)، أو رقم، أو نص، أو تاريخ، أو نعم / لا، أو واحدة من قائمة، أو، عندما تتوفر سجلات في النطاق، قائمة منها أو سجل واحد منها، مثل «قائمة من …» للحجوزات.
انقر اختبار الكود بقيم تجريبية. لا يمكنك الحفظ إلا بعد أن يجتاز الكود الحالي تشغيلًا تجريبيًا. تغيير نوع النتيجة يعني الاختبار مجددًا.
حدّد حفظ النتيجة باسم، ثم انقر تم.
لعرض النتيجة كقائمة اختيار، اضبط نوع النتيجة على قائمة سجلات، مثل قائمة حجوزات. ثم وجّه حقل القائمة في السؤال إلى ذلك المتغير.
ما يمكن للكود استخدامه
المتغيرات التي جُمعت قبله، بأسمائها. وقيم @customer و@system متاحة أيضًا.
هذه الوحدات فقط: math, decimal, re, datetime, datetime.timezone, json, random, time.
يعمل الكود 5 ثوانٍ كحد أقصى، ولا يمكنه الاتصال بالإنترنت أو قراءة الملفات أو تشغيل الإجراءات.
إذا فشل الكود أثناء وجود عميل في الإجراء، تحمل نتيجته خطأً ويواصل الإجراء. أما شرط كود الذي يفشل فيوقف الإجراء ويحوّل المحادثة.
الإجراءات الفرعية
الإجراء الفرعي مجموعة خطوات تكتبها مرة واحدة وتشغّلها من أي إجراء، مثل "التحقق من العميل" أو "جمع بيانات التوصيل". لا يبدأ العملاء إجراءً فرعيًا مباشرة أبدًا. يشغّله الإجراء كخطوة واحدة، ثم يواصل.
إنشاء إجراء فرعي
في الإجراءات الذكية، افتح تبويب الإجراءات الفرعية وانقر إجراء جديد. أو اختر إجراء فرعي ضمن النوع في نافذة الإنشاء.
عبّئ المدخلات: ما يجب أن يوفره المستدعي عند تشغيل هذا الإجراء الفرعي. انقر إضافة وأعطِ كل مُدخل الاسم والنوع (text افتراضيًا). يكون مطلوب محدَّدًا؛ ألغِ تحديده للمُدخل الاختياري.
اكتب التعليمات كما في أي إجراء. المدخلات متاحة عبر @.
عبّئ المخرجات: المتغيرات التي تُعاد إلى المستدعي. يجب أن تنتج إحدى الخطوات كل مُخرج.
انقر نشر.
لا يوجد للإجراء الفرعي متى يُستخدم ولا قنوات ولا زر اختبار. تختبره من خلال إجراء يستدعيه.
لا يلزم أن ينتهي بـ إنهاء أو تحويل: عندما تنتهي خطواته، يواصل الإجراء المستدعي. ويظل بإمكانه تحويل المحادثة أو إنهاؤها بنفسه.
تشغيله من إجراء
اكتب سطرًا مثل "شغّل الإجراء الفرعي التحقق من العميل"، أو أدرج تشغيل إجراء فرعي من مجموعة المسار في قائمة /.
الإجراء الفرعي: لا تظهر إلا الإجراءات الفرعية المنشورة، بالشكل "الاسم (vN)".
المدخلات: اختر متغيرًا لكل مُدخل. المدخلات المطلوبة معلَّمة بـ *.
ينتج: المخرجات التي يمكنك استخدامها في الخطوات اللاحقة.
قواعد الإجراءات الفرعية
انشر الإجراء الفرعي قبل أن يتمكن أي إجراء من استدعائه.
لا يمكن للإجراء الفرعي استدعاء نفسه، ولا يمكن لسلسلة استدعاءات أن تعود في حلقة إلى الإجراء الذي بدأها.
يمكن أن يصل عمق الإجراء مع الإجراءات الفرعية التي يستدعيها إلى 5 مستويات كحد أقصى.
ما دام إجراء منشور يستدعي إجراءً فرعيًا، لا يمكنك إلغاء نشر الإجراء الفرعي أو حذفه. تسرد الرسالة تلك الإجراءات، ولكل منها رابط فتح: أزِل الاستدعاء منها وانشرها، ثم حاول مرة أخرى.
عندما تنشر إصدارًا جديدًا من إجراء فرعي، يشغّل كل إجراء يستدعيه الإصدار الجديد من ذلك الحين. لا تحتاج إلى إعادة نشر الإجراءات المستدعية.