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

# إجراء: قالب واتساب من الأتمتة

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

## بطاقة سريعة

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

## الفرق بينه وبين رسالة القالب داخل عقدة "رسالة"

عقدة [رسالة](/ar/help-center/guides/automations/nodes/message) ترسل رسالة (بما فيها قوالب) **للعميل الحالي في سياق المحادثة الجارية**. هذا الإجراء مختلف: يرسل قالباً معتمداً **لرقم هاتف تحدده أنت صريحاً**، بغض النظر عن مصدر التشغيل (Trigger). هذا يعني أنك تستطيع:

* تشغيل الإجراء من [مشغّل شريحة أو عميل](/ar/help-center/guides/automations/triggers/types) لا علاقة له بواتساب أصلاً، وإرسال قالب واتساب كنتيجة.
* إرسال قالب لعميل **لا توجد معه محادثة واتساب مفتوحة حالياً** — الإجراء يُنشئ محادثة جديدة إن لم توجد.

## الحقول

| الحقل                                           | ماذا يعني                                                                                         |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **التكامل (Integration)**                       | رقم واتساب المرسِل الذي تملكه                                                                     |
| **القالب**                                      | يفتح نافذة اختيار قالب معتمَد من ميتا، بمعاينة كاملة لشكله                                        |
| **اللغة**                                       | لغة نسخة القالب المعتمدة المطلوب استخدامها                                                        |
| **رقم المستقبل**                                | رقم الهاتف بصيغة دولية — يقبل متغيرات المسار                                                      |
| **اسم المستقبل** *(اختياري)*                    | يُستخدم لإنشاء بطاقة العميل إن لم تكن موجودة                                                      |
| **معاملات القالب (Params)**                     | قيمة لكل متغيّر داخل نص القالب (`{{1}}`, `{{2}}`...) — تُعبَّأ من داخل نافذة معاينة القالب مباشرة |
| **تسميات الأزرار (Button Labels)** *(إن وُجدت)* | إن كان القالب يحتوي أزراراً ديناميكية، تحدد نصها هنا                                              |

<Info>
  **وسائط مطلوبة:** نافذة اختيار قالب واتساب مفتوحة من داخل الإجراء، تعرض معاينة القالب الحقيقي مع حقول تعبئة المتغيرات ورقم المستقبل.
  المسار المقترح: `/images/help/automations/action-whatsapp-template.webp`
</Info>

## القوالب المعتمدة وسياسات ميتا

القالب المستخدَم هنا **يجب أن يكون معتمداً من ميتا مسبقاً** — نفس القوالب التي تُنشئها وتُرسلها من [الحملات](/ar/help-center/guides/broadcasts/whatsapp). لا يمكن اختيار قالب غير معتمد أو ما زال قيد المراجعة.

<Warning>
  لأن هذا الإجراء يرسل **خارج نطاق أي محادثة قائمة**، ينطبق عليه كل ما ينطبق على حملات القوالب من [أسباب فشل الإرسال](/ar/help-center/guides/broadcasts/whatsapp): رصيد محفظة كافٍ لتكلفة الإرسال، حالة توثيق الأعمال في ميتا، وحدود الإرسال اليومية لحسابك. راجع تلك الصفحة لفهم كل سبب بعمق قبل الاعتماد على هذا الإجراء في مسارات حساسة للوقت.
</Warning>

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

| احتياجك                                                                      | الأنسب                                                                                   |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| إشعار عميل عبر واتساب استناداً لحدث ليس من واتساب (طلب من متجرك، تذكير موعد) | قالب واتساب من الأتمتة                                                                   |
| الرد على العميل داخل محادثة واتساب قائمة                                     | عقدة [رسالة](/ar/help-center/guides/automations/nodes/message) العادية                   |
| إشعار جماعي لقائمة كبيرة من العملاء دفعة واحدة                               | [الحملات](/ar/help-center/guides/broadcasts/whatsapp) — أدق للاستهداف والتقارير الجماعية |

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

| الخطأ                                       | النتيجة                               | الصواب                                                                            |
| ------------------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------- |
| رقم هاتف بصيغة محلية لا دولية               | فشل الإرسال                           | استخدم دائماً الصيغة الدولية الكاملة (مثال: `9665XXXXXXXX`)                       |
| متغيّر قالب بلا قيمة مربوطة                 | فشل الإرسال أو رفض ميتا للرسالة       | تأكد من تعبئة كل معامل داخل نافذة معاينة القالب                                   |
| الاعتماد على هذا الإجراء لحملة جماعية كبيرة | لا تقارير تجميعية، صعوبة تتبع النتائج | استخدم [الحملات](/ar/help-center/guides/broadcasts/whatsapp) للإرسال الجماعي      |
| عدم مراقبة رصيد المحفظة                     | فشل صامت لعدد من الإشعارات            | راجع [أسباب فشل حملات واتساب](/ar/help-center/guides/broadcasts/whatsapp) بانتظام |

## ذات صلة

* [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview)
* [عقدة: إرسال رسالة](/ar/help-center/guides/automations/nodes/message)
* [حملة واتساب لمرة واحدة وأسباب الفشل](/ar/help-center/guides/broadcasts/whatsapp)
* [إجراءات الإشعارات](/ar/help-center/guides/automations/notifications-actions)


## Related topics

- [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview.md)
- [إجراءات الإشعارات](/ar/help-center/guides/automations/notifications-actions.md)
- [إجراء: رسالة مباشرة (فيسبوك/إنستغرام)](/ar/help-center/guides/automations/nodes/actions/send-dm.md)
- [واتساب](/ar/help-center/guides/channels/whatsapp.md)
- [طريقة إنشاء قالب خدمي](/ar/help-center/guides/whatsapp/templates/doc-1914160.md)