> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karzoun.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# العمليات والتجارة الإلكترونية

> الإجراءات التشغيلية الجاهزة: إنشاء موعد، إدارة سلة تسوق واتساب، الاستعلام عن طلبات العميل وتاريخ مشترياته، وبدء الدفع — كل واحد مع شرح كامل.

هذه الإجراءات كلّها من فئة **تشغيلي**. أغلبها مصمَّم أصلاً ليكون **أدوات يستخدمها [وكيل المساعد الذكي](/ar/help-center/guides/automations/nodes/ai-agent) تلقائياً** أثناء محادثة واتساب — لكنها متاحة أيضاً لتضيفها بنفسك يدوياً داخل [عقدة الإجراء](/ar/help-center/guides/automations/nodes/actions/overview) في أي مسار.

<Info>
  **وسائط مطلوبة:** محادثة واتساب حقيقية تُظهر عميلاً يطلب من الوكيل الذكي إضافة منتج للسلة، ثم عرض السلة، ثم بدء الدفع — سلسلة كاملة من ٣-٤ رسائل.
  المسار المقترح: `/images/help/automations/operations-actions-flow.webp`
</Info>

## إنشاء موعد

|                   |                 |
| ----------------- | --------------- |
| **الاسم البرمجي** | `createMeeting` |

ينشئ موعداً جديداً في نظام [المواعيد](/ar/help-center/guides/meetings/overview) — عنوان، وصف، تاريخ بداية ونهاية، نوع (داخلي/خارجي)، طريقة (عن بُعد/حضوري)، مشاركون، ووسوم. تستطيع أيضاً ربطه تلقائياً بصفقة أو جهة اتصال موجودة عبر **نوع العلاقة** و**معرّف الهدف**.

<Tip>
  مثال عملي: بعد أن يطلب عميل "أريد حجز موعد استشارة"، يجمع [سؤال آلي](/ar/help-center/guides/automations/nodes/question) التاريخ المفضّل، ثم يستخدم هذا الإجراء لإنشاء الموعد فعلياً وربطه بصفقة العميل.
</Tip>

## إدارة سلة تسوق واتساب

أربعة إجراءات تدير سلة تسوق خاصة بكل عميل ضمن محادثة واتساب — الأساس الذي تُبنى عليه تجربة الشراء داخل واتساب:

| الإجراء            | الاسم البرمجي    | ماذا يفعل                                                                                                             |
| ------------------ | ---------------- | --------------------------------------------------------------------------------------------------------------------- |
| **إضافة للسلة**    | `addToCart`      | يضيف منتجاً (وتحديداً متغيّراً منه إن كان له مقاسات/ألوان) بكمية معينة. لو لم تكن هناك سلة نشطة، يُنشئ واحدة تلقائياً |
| **إزالة من السلة** | `removeFromCart` | يزيل منتجاً كاملاً، أو يقلّل كميته فقط إن حددت عدد الوحدات المطلوب إزالتها                                            |
| **عرض السلة**      | `viewCart`       | يُرجع محتوى السلة الحالية: المنتجات، الكميات، والإجمالي — بلا حاجة لأي معامل                                          |
| **تفريغ السلة**    | `clearCart`      | يحذف كل محتوى السلة دفعة واحدة                                                                                        |

<Warning>
  لكل عميل **سلة نشطة واحدة فقط** لكل قناة واتساب. إضافة نفس المنتج بنفس الخيارات (المقاس/اللون) مرتين تجمع الكمية في سطر واحد، لا سطرين مكررين — النظام يتعرّف على "نفس السطر" تلقائياً عبر هوية المنتج والمتغيّر.
</Warning>

## الاستعلام عن الطلبات وتاريخ المشتريات

| الإجراء                  | الاسم البرمجي                | ماذا يفعل                                                                                                                                          |
| ------------------------ | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **طلبات العميل**         | `getCustomerOrders`          | يبحث عن طلبات محددة برقم الطلب، معرّف الطلب، بريد العميل، أو رقم جواله — مفيد حين يسأل العميل عن طلب بعينه                                         |
| **تاريخ مشتريات العميل** | `getCustomerPurchaseHistory` | يُرجع كل الطلبات السابقة للعميل مع **إحصاءات تراكمية**: إجمالي المصروف، متوسط قيمة الطلب، أكثر العلامات والفئات شراءً — مفيد لتخصيص الردود والعروض |

<Tip>
  استخدم **تاريخ مشتريات العميل** قبل تفعيل عرض أو خصم داخل المسار — يمنحك سياقاً حقيقياً (هل هذا عميل جديد أم متكرر؟ ما العلامات التي يفضّلها؟) بدل عرض عام لا يناسب الجميع.
</Tip>

## بدء الدفع (Checkout)

|                   |                    |
| ----------------- | ------------------ |
| **الاسم البرمجي** | `initiateCheckout` |

يرسل للعميل **نموذج دفع تفاعلي (WhatsApp Flow)** يمشيه خطوة بخطوة: اختيار المتغيّرات النهائية، العنوان، طريقة الشحن، ثم مراجعة وتأكيد الطلب — كل ذلك داخل واتساب دون مغادرة المحادثة.

يتطلب وجود **سلة نشطة بها عناصر فعلاً**؛ إن كانت السلة فارغة يفشل الإجراء برسالة واضحة تطلب إضافة عناصر أولاً.

<Tip>
  خصّص **نص الترويسة** و**نص الزر** لتناسب نغمة متجرك، مثال: زر "أكمل طلبك الآن 🛍️" بدل النص الافتراضي.
</Tip>

## متى تستخدمها؟

| احتياجك                                                           | الأنسب                                                                                            |
| ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| السماح للوكيل الذكي بإدارة السلة والطلبات تلقائياً أثناء المحادثة | فعّل هذه القدرات في [ملف تعريف الوكيل](/ar/help-center/guides/automations/nodes/ai-agent)         |
| بناء مسار يدوي واضح الخطوات (سؤال → إضافة للسلة → دفع)            | أضف الإجراءات مباشرة في [عقدة الإجراء](/ar/help-center/guides/automations/nodes/actions/overview) |
| متجر متكامل عبر سلة/زد بدل واتساب مباشرة                          | راجع [تكاملات التجارة الإلكترونية](/ar/help-center/guides/automations/apps/ecommerce)             |

## أخطاء شائعة

| الخطأ                                                            | النتيجة                         | الصواب                                                              |
| ---------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------- |
| بدء الدفع بلا سلة أو بسلة فارغة                                  | فشل الإجراء برسالة واضحة        | تأكد من عرض السلة ووجود عناصر قبل بدء الدفع                         |
| إزالة منتج بمعرّف غير مطابق لما في السلة فعلاً                   | فشل "المنتج غير موجود في السلة" | استخدم `productRef`/`variantRef` من نتيجة **عرض السلة** نفسها       |
| الاعتماد على معرّف عميل غير موجود في السياق ولا في المعاملات     | فشل تحديد العميل في الاستعلامات | مرّر البريد أو رقم الجوال إن لم يكن العميل معروفاً من سياق المحادثة |
| توقّع أن "تاريخ المشتريات" يشمل طلبات من قنوات غير مرتبطة بكرزون | نتائج غير كاملة                 | تأكد أن كل قنوات البيع مرتبطة ومزامنة في كرزون                      |

## ذات صلة

* [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview)
* [عقدة: وكيل المساعد](/ar/help-center/guides/automations/nodes/ai-agent)
* [أدوات الوكيل الذكي](/ar/help-center/guides/automations/ai-tools-actions)
* [تكاملات التجارة الإلكترونية](/ar/help-center/guides/automations/apps/ecommerce)


## Related topics

- [أدوات الوكيل الذكي](/ar/help-center/guides/automations/ai-tools-actions.md)
- [عقدة: وكيل المساعد](/ar/help-center/guides/automations/nodes/ai-agent.md)
- [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview.md)
- [التجارة الإلكترونية](/ar/miniapps/guides/ecommerce.md)
- [نظرة عامة](/ar/help-center/guides/whatsapp/commerce/overview.md)