> ## 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.

# إنشاء واستخدام الماكرو

> الماكرو خطوات جاهزة يشغّلها الوكيل بضغطة من داخل المحادثة: كيف تصنعه، أين يظهر في البريد الوارد، ومتى يكون أفضل من الأتمتة والرد السريع.

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

مثال: طلب استرجاع. قرار قبوله بشري، لكن ما بعده ثابت دائماً — وسم، ملاحظة، تحديث حقل، إسناد لقسم المستودع، رسالة تأكيد. الماكرو ينفّذ ذلك كله بضغطة.

في التطبيق: **الأتمتة** ← **الماكرو** (`/automations/macros`).

## الماكرو أم الأتمتة أم الرد السريع؟

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

القاعدة: إن كان ما تحتاجه **نصاً فقط**، فالرد السريع أسرع وأنسب — راجع [الردود السريعة](/ar/help-center/guides/inbox/quick-responses). وإن كان يتضمن **إجراءات** (وسم، إسناد، حالة، تحديث بيانات)، فهو ماكرو.

## كيف تنشئ ماكرو

<Steps>
  <Step title="افتح صفحة الماكرو">
    **الأتمتة** ← **الماكرو**، ثم **إنشاء الماكرو**.
  </Step>

  <Step title="ابنِ الخطوات">
    يفتح المحرر في وضع الماكرو. أضف عقدة **إجراء** بما تريد تنفيذه، وعقدة **إرسال رسالة** إن كان هناك نص يصل العميل.
  </Step>

  <Step title="علّم العقدة كماكرو">
    من أدوات العقدة اختر **تعيين كماكرو** — هذه هي الخطوة التي تجعلها قابلة للتشغيل من البريد الوارد. لإلغاء ذلك استخدم **إزالة الماكرو**.
  </Step>

  <Step title="سمّه باسم يفهمه الوكيل">
    الاسم هو ما سيراه الموظف تحت ضغط العمل. «معالجة استرجاع» أوضح من «ماكرو ٣».
  </Step>

  <Step title="انشر">
    الماكرو يتبع حالة الأتمتة الحاوية له. **مسودة = لا يظهر للوكلاء.**
  </Step>

  <Step title="اختبره على محادثة حقيقية">
    شغّله على محادثة تجريبية وتحقق من كل إجراء وقع فعلاً.
  </Step>
</Steps>

<Info>
  **وسائط مطلوبة:** عقدة في المحرر وقد عُلّمت كماكرو، وبجانبها قائمة الماكرو في صفحة `/automations/macros`.\
  المسار المقترح: `/images/help/automations/macro-mark-and-list.webp`\
  **فيديو (مستحسن):** 30 ثانية: بناء ماكرو من عقدة إجراء ثم تشغيله من محادثة.
</Info>

## قائمة الماكرو

صفحة `/automations/macros` تعرض:

| العمود      | ماذا يخبرك                                 |
| ----------- | ------------------------------------------ |
| **الاسم**   | اسم الماكرو كما يراه الوكيل                |
| **النوع**   | نوع العقدة التي بُني عليها                 |
| **الأتمتة** | الأتمتة الحاوية له — من هنا تفتحها للتعديل |
| **الحالة**  | مفعّلة أو غير متصلة، تبعاً للأتمتة الحاوية |
| **الوصف**   | شرح مختصر يساعد الوكيل على الاختيار الصحيح |

اكتب **الوصف** دائماً. الوكيل الذي يرى خمسة أسماء متشابهة سيشغّل الخطأ منها.

## تشغيل الماكرو من البريد الوارد

الوكيل يفتح المحادثة، ويجد قسم **الماكرو** في لوحة تفاصيل المحادثة على الجانب. يختار الماكرو ويضغط **تشغيل**؛ تظهر حالة **جارٍ التشغيل...** ثم تُنفَّذ الخطوات على **هذه المحادثة وهذا العميل** تحديداً.

إذا زاد عدد الماكرو، يظهر حقل بحث للعثور السريع. وإن لم يوجد شيء تظهر رسالة **لا توجد وحدات ماكرو متاحة** — والسبب الغالب أن الأتمتات الحاوية ما زالت مسودة.

<Warning>
  الماكرو ينفّذ إجراءات حقيقية فوراً على محادثة عميل حقيقي: يغيّر الحالة، يعيّن، يرسل رسالة. لا توجد خطوة تأكيد بعد الضغط. تأكد من اختيار الماكرو الصحيح، ولا تجعل أسماء الماكرو متشابهة.
</Warning>

## ماكرو يستحق البناء

| السيناريو        | ما يفعله الماكرو                                                         |
| ---------------- | ------------------------------------------------------------------------ |
| **طلب استرجاع**  | وسم «استرجاع» + ملاحظة + إسناد للمستودع + رسالة تأكيد بالخطوات           |
| **تصعيد للمشرف** | وسم «تصعيد» + ملاحظة بالسياق + إسناد للمشرف + تغيير الحالة               |
| **عميل جملة**    | وسم عميل «جملة» + تحديث حقل + إسناد لمسؤول الحسابات + رسالة بشروط الجملة |
| **بلاغ عطل**     | وسم «عطل فني» + ملاحظة + إسناد للدعم الفني + رسالة بزمن المعالجة المتوقع |
| **إغلاق مهذب**   | رسالة ختامية + حل المحادثة + وسم نوع الطلب للتقارير                      |
| **خارج الدوام**  | رسالة بساعات العمل + تأجيل المحادثة لبداية الدوام                        |

<Tip>
  أفضل مصدر لأفكار الماكرو هو فريقك نفسه. اسأل: «ما الخطوات التي تكررها أكثر من عشر مرات يومياً؟» الجواب هو قائمة عملك.
</Tip>

## عادات تحافظ على جودة الماكرو

* سمّه بالنتيجة لا بالأداة: «معالجة استرجاع» لا «ماكرو الوسوم».
* اجعل كل ماكرو يفعل شيئاً واحداً واضحاً؛ الماكرو الذي يفعل سبعة أشياء يخيف الوكلاء فلا يستخدمونه.
* درّب الفريق عليه عملياً؛ الماكرو غير المعروف = ماكرو غير مستخدم.
* راجع الماكرو عند تغيّر الأقسام أو الحقول — المرجع المحذوف يكسر التنفيذ.
* تابع نتائجه في [سجل التنفيذ](/ar/help-center/guides/automations/execution-history)؛ التشغيلات القادمة من ماكرو تحمل شارة **ماكرو**.

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

| الخطأ                                | النتيجة                               | الصواب                 |
| ------------------------------------ | ------------------------------------- | ---------------------- |
| الأتمتة الحاوية **مسودة**            | الماكرو لا يظهر للوكلاء               | انشرها                 |
| نسيان **تعيين كماكرو**               | العقدة موجودة لكنها غير قابلة للتشغيل | علّمها                 |
| أسماء متشابهة                        | تشغيل الماكرو الخطأ على عميل حقيقي    | أسماء مميزة + وصف      |
| ماكرو يرسل رسالة لا تناسب كل الحالات | نص غريب في سياق مختلف                 | اجعله محايداً أو قسّمه |
| استخدام ماكرو لنص فقط                | تعقيد بلا داعٍ                        | استخدم رداً سريعاً     |
| ماكرو ضخم متعدد الأغراض              | لا أحد يجرؤ على استخدامه              | قسّمه لماكروات صغيرة   |

## ذات صلة

* [الردود السريعة](/ar/help-center/guides/inbox/quick-responses)
* [الماكرو وتسليم البوت والأتمتة](/ar/help-center/guides/inbox/macros-and-handoff)
* [الإسناد والوسوم والملاحظات](/ar/help-center/guides/automations/assign-tag-note)
* [النشر والمسودة والحالات](/ar/help-center/guides/automations/publish-and-status)


## Related topics

- [الماكرو وتسليم البوت والأتمتة](/ar/help-center/guides/inbox/macros-and-handoff.md)
- [ما هي قوالب الرسائل؟](/ar/help-center/guides/whatsapp/templates/doc-1890476.md)
- [أفضل الممارسات والاسئلة الشائعة](/ar/help-center/guides/whatsapp/templates/doc-1890479.md)
- [المشاركة](/ar/help-center/guides/file-manager/sharing.md)
- [التحديث المباشر والتصدير](/ar/help-center/guides/insights/live-and-export.md)