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

# إجراءات الإشعارات

> إجراء إشعار واتساب مباشر داخل محادثة قائمة، وإجراء الإشعار الفوري (Push) للفرق والعملاء عبر تطبيق الجوال.

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

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

<Info>
  **وسائط مطلوبة:** عقدة إجراء مفتوحة على «إشعار فوري» مع عنوان ونص ومعرّف موظف واحد، وبجانبها لقطة إشعار على تطبيق الجوال.
  المسار المقترح: `/images/help/automations/notifications-push-example.webp`
</Info>

## إشعار واتساب

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

يرسل رسالة واتساب (نصية أو رسائل مركّبة) لرقم هاتف تحدده — مشابه لـ[قالب واتساب من الأتمتة](/ar/help-center/guides/automations/nodes/actions/whatsapp-template) في أنه يستهدف رقماً محدداً بدل العميل الحالي في السياق، لكنه أبسط: نص مباشر بدل قالب معتمد رسمياً من ميتا.

| الحقل                 | ماذا يعني                        |
| --------------------- | -------------------------------- |
| **التكامل**           | رقم واتساب المرسِل               |
| **رقم المستقبل**      | بصيغة دولية، يقبل متغيرات المسار |
| **الرسالة / الرسائل** | نص واحد، أو مصفوفة رسائل مركّبة  |

<Warning>
  لأن هذا الإجراء يرسل **نصاً حراً لا قالباً معتمداً**، تنطبق عليه سياسة نافذة ٢٤ ساعة لواتساب: لا يمكن استخدامه لبدء تواصل جديد مع عميل لم يتفاعل معك خلال آخر ٢٤ ساعة. لهذا الغرض استخدم [قالب واتساب من الأتمتة](/ar/help-center/guides/automations/nodes/actions/whatsapp-template) الذي يستخدم قوالب معتمدة مسبقاً من ميتا ولا يخضع لهذا القيد.
</Warning>

## إشعار فوري (Push Notification)

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

يرسل إشعاراً فورياً لتطبيق الجوال — لأعضاء الفريق، للعملاء، أو للاثنين معاً في نفس الإجراء.

| الحقل                            | ماذا يعني                                                                         |
| -------------------------------- | --------------------------------------------------------------------------------- |
| **العنوان**                      | عنوان الإشعار الظاهر للمستقبل *(مطلوب)*                                           |
| **النص**                         | نص الإشعار *(مطلوب)*                                                              |
| **معرّفات أعضاء الفريق**         | قائمة معرّفات موظفين لإشعارهم                                                     |
| **معرّفات العملاء**              | قائمة معرّفات عملاء لإشعارهم                                                      |
| **بيانات إضافية (Data Payload)** | مفتاح/قيمة اختيارية لتوجيه عميق (Deep Linking) داخل التطبيق عند الضغط على الإشعار |

<Info>
  يجب تحديد **أعضاء فريق أو عملاء** على الأقل واحد منهما — إجراء بلا مستقبلين يفشل بصمت برسالة "لا مستقبلين محددين". كذلك، إن لم يكن للمستقبل رمز جهاز مسجّل (لم يفتح التطبيق أو رفض الإشعارات)، لا يصله الإشعار — يُنظّف النظام تلقائياً الرموز منتهية الصلاحية.
</Info>

<Tip>
  مثال عملي: بعد [التصعيد](/ar/help-center/guides/inbox/response-and-escalation) لمحادثة حساسة، استخدم هذا الإجراء لإشعار مدير الفريق فورياً على تطبيق الجوال — أسرع من انتظار فتحه للبريد الوارد على المتصفح.
</Tip>

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

| احتياجك                                                | الأنسب                                                                                       |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| بدء محادثة واتساب جديدة مع عميل خارج نافذة ٢٤ ساعة     | [قالب واتساب من الأتمتة](/ar/help-center/guides/automations/nodes/actions/whatsapp-template) |
| رسالة واتساب حرة لعميل تفاعل معك أخيراً                | إشعار واتساب                                                                                 |
| تنبيه فوري لموظف أو عميل يستخدم تطبيق كرزون على الجوال | إشعار فوري (Push)                                                                            |

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

| الخطأ                                                                     | النتيجة                                      | الصواب                                                 |
| ------------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------ |
| إشعار واتساب لعميل خارج نافذة ٢٤ ساعة                                     | فشل الإرسال من ميتا                          | استخدم قالب معتمد لبدء تواصل جديد                      |
| إشعار فوري بلا أي مستقبل محدد                                             | فشل صامت                                     | تأكد من تعبئة قائمة موظفين أو عملاء                    |
| توقّع استلام الإشعار الفوري من مستقبل لم يثبّت التطبيق أو يفعّل الإشعارات | لا يصل الإشعار بلا أي رسالة خطأ ظاهرة للعميل | لا تعتمد على هذا الإجراء كقناة اتصال وحيدة لحالات حرجة |

## ذات صلة

* [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview)
* [قالب واتساب من الأتمتة](/ar/help-center/guides/automations/nodes/actions/whatsapp-template)
* [معايير الرد والتصعيد](/ar/help-center/guides/inbox/response-and-escalation)


## Related topics

- [الإشعارات](/ar/help-center/guides/team-chat/notifications.md)
- [تفضيلات الإشعارات](/ar/help-center/guides/notifications/preferences.md)
- [عقدة: إجراء — نظرة عامة](/ar/help-center/guides/automations/nodes/actions/overview.md)
- [إجراء: قالب واتساب من الأتمتة](/ar/help-center/guides/automations/nodes/actions/whatsapp-template.md)
- [إجراءات التسويق](/ar/help-center/guides/automations/marketing-actions.md)
