يمكن للإجراءات قراءة البيانات من متجرك المتصل ومن الإجراءات المتصلة الخاصة بنشاطك التجاري، ثم استخدام أي حقل من النتيجة في الخطوات اللاحقة. يسرد هذا المقال ما هو متاح وما تحتويه كل نتيجة.
إجراءات المتجر
عند ربط متجر إلكتروني، تظهر إجراءاته في قائمة / تحت المتجر · <متجرك>. يكون Search products متاحًا دائمًا للمتجر المتصل. أما الإجراءات الأخرى فلا تظهر إلا إذا كان متجرك يدعمها. وما دام المتجر مفصولًا أو غير نشط أو يحتاج إلى إعادة التفويض، لا تظهر أي إجراءات للمتجر.
الإجراء | المُدخل | ما يُرجعه |
Search products | query (مطلوب) | قائمة تضم حتى 10 منتجات |
Get product by id | product_id (مطلوب)، variant_id (اختياري) | منتج واحد. من دون خيار محدد (variant)، يُرجع الخيار الافتراضي للمنتج |
Get order by id | order_id (مطلوب) | طلب واحد |
Get orders by contact | contact_phone (مطلوب) | قائمة تضم أحدث طلب للعميل (فارغة إذا لم يكن لديه طلبات) |
Get discount coupon | contact_phone (مطلوب)، coupon_type (اختياري) | كوبون واحد، أو العرض الجاري |
لا تحتاج إجراءات المتجر إلى تأكيد العميل. جميعها تقرأ البيانات فقط، باستثناء Get discount coupon الذي يُنشئ رمز كوبون.
ما تحتويه كل نتيجة
استخدم هذه الحقول مع @، في الشروط وفي «تشغيل كود»، مثل @get_order_by_id.order_status (استخدم الاسم الذي حفظت الخطوة نتيجتها به).
المنتج
الحقل | النوع |
product_id, variant_id, sku | نص |
title, description | نص |
url, image_url | نص |
price, discounted_price | رقم |
currency | نص |
availability | نص، مثل IN_STOCK أو OUT_OF_STOCK |
الطلب
الحقل | النوع |
order_id, order_number | نص |
order_status | نص، كما يسمّيه متجرك |
created_at, updated_at | نص، بالصيغة YYYY-MM-DD HH:MM:SS (UTC) |
order_total | رقم |
currency | نص |
tracking_link, tracking_number, carrier_name | نص |
customer_phone | نص |
products | قائمة عناصر، لكل منها id وname وquantity |
shipping_address | city, country, postal_code, street |
الكوبون
الحقل | النوع |
coupon_code | نص |
coupon_type | LEAD أو WIN_BACK أو DEFAULT (فارغ للعرض المخصص) |
description | نص |
source | نص |
تأتي حالات الطلب من متجرك، لذا اكتب الشروط بكلمات متجرك نفسها، مثل "إذا كانت حالة الطلب «تم التوصيل»…".
كيف يعمل Get discount coupon
لا يظهر هذا الإجراء إلا عندما يستطيع متجرك إنشاء الكوبونات وتكون بطاقة إجراء كوبون الخصم مفعّلة لنشاطك التجاري.
إذا كان لديك عرض مخصص جارٍ الآن، يُرجع وصف ذلك العرض من دون رمز: يكون coupon_code وcoupon_type فارغين، وتكون قيمة source هي custom_offer. وفي غير ذلك تكون قيمة source هي coupon.
وإلا، يختار نوع الكوبون المناسب للعميل:
LEAD: ليس لديه طلبات بعد.
WIN_BACK: آخر طلب له أقدم من أيام الاستعادة المحددة في بطاقة كوبون الخصم (30 افتراضيًا).
DEFAULT: جميع العملاء الآخرين.
لفرض نوع معيّن، عبّئ coupon_type بـ LEAD أو WIN_BACK أو DEFAULT. يظل للعرض المخصص الجاري الأولوية.
لمعالجة متجر لا يستطيع إنشاء الكوبون، أضف شرطًا مثل "إذا تعذّر إنشاء الكوبون، اعتذر وحوّل إلى Customer Service."
إجراءاتك المتصلة الخاصة
تظهر إجراءات وكيل الذكاء الاصطناعي لديك، مثل البحث عن الحجوزات أو إلغاء موعد، تحت الإجراءات في قائمة /. اكتب جزءًا من الاسم للعثور على أحدها.
الإجراءات التي تجلب البيانات هي إجراءات قراءة. والإجراءات التي تغيّر شيئًا هي إجراءات كتابة، يؤكدها العميل دائمًا.
عندما يحتاج إجراء إلى اختيار يقوم به وكيل الذكاء الاصطناعي عادةً، مثل طبيب أو فرع، أو عندما لم يُجمع مُدخل مطلوب، يتولى وكيل الذكاء الاصطناعي تلك الخطوة ويسأل العميل عمّا يحتاجه. لا تُسلَّم إجراءات المتجر إلى الوكيل: اجمع مدخلاتها المطلوبة في سطر سابق.
المتغيرات المدمجة
يمكن لكل إجراء استخدام هذه المتغيرات دون جمعها:
المتغير | ما يحمله |
@customer.name | اسم جهة الاتصال |
@customer.phone | رقم هاتف جهة الاتصال |
@customer.language | لغة العميل |
@system.today | تاريخ اليوم (UTC) |
@system.now | الوقت الحالي (UTC) |
التواريخ في الشروط
عند الحكم على شرط، يأتي كل تاريخ يطّلع عليه مصحوبًا بمدى بُعده عن اليوم، بالمنطقة الزمنية لنشاطك التجاري. مثال: "2026-10-13 10:00:00 (3 days ago)". لذا تعمل شروط مثل "إذا كان الطلب قد أُنشئ قبل أكثر من 14 يومًا" دون كود.
إذا انفصل متجرك
الإجراء المنشور الذي يستخدم إجراء متجر لم يعد متجرك يوفّره يُعلَّم بـ متوقف من النظام، مع السبب "تم فصل تطبيق المتجر الإلكتروني". ويحدث الأمر نفسه عند إيقاف بطاقة كوبون الخصم. هذه التسمية مجرد تحذير: يظل الإجراء يبدأ، لكن خطوات المتجر تلك تفشل، وتُحوَّل المحادثة إلى فريقك ما لم يعالج شرطٌ هذا الفشل. تزول الحالة تلقائيًا بعد عودة المتجر، خلال 15 دقيقة تقريبًا.