> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.
# إشعارات عبر الواتساب
> أرسل تحديثات التوصيل عبر WhatsApp Business: اربط حسابك، واحصل على اعتماد نماذج الرسائل، وأرسل الرسائل يدويًا، واضبط رسائل السائقين.
> [!NOTE]
>
> **مكانه في المنصة:** الإعدادات ← Customer Notifs ← Whatsapp — [افتح في OTO ↖](https://app.tryoto.com/whatsapp)
في معظم أنحاء الشرق الأوسط، ليس واتساب مجرد تطبيق مراسلة آخر على هواتف الناس، بل هو المكان الذي يقضون فيه وقتهم. ورسالة التوصيل التي تصل إليه تُقرأ في المكان نفسه الذي يقرؤون فيه كل ما يهمهم.
## ثلاث خطوات، بالترتيب
واتساب للأعمال أكثر صرامة من الرسائل النصية بحكم تصميمه: لا يمكنك إرسال أي نص تشاء إلى عميل لم يراسلك أولًا. بل يجب أن تكون الرسائل قوالب معتمدة مسبقًا. وهذا ما يقسّم الإعداد إلى ثلاث خطوات.
| الخطوة | المكان | ما هي |
| - | - | - |
| **1 · الربط** | **Add Connection** | حساب واتساب للأعمال الخاص بك. يمكن ربط أكثر من حساب — عادةً حساب لكل علامة تجارية. |
| **2 · القالب** | **Whatsapp Templates** | الرسالة نفسها، وتُرسَل إلى Meta لاعتمادها. |
| **3 · الإعداد** | **Whatsapp Settings** | ما يربط قالبًا معتمدًا بحدث معيّن. |
### الربط
الشكل 1 — ثلاث خطوات، أولاها دليل من سبع خطوات للجانب الخاص بـ Meta — لأن الأخطاء عادةً تقع هناك.
يمر **Add Connection** بالمراحل **Instructions ← Credentials ← Settings**. وتذكر مرحلة التعليمات المتطلب المسبق بوضوح: *«user must have a meta business account, a whatsapp app linked to that business account and developer account linked to the business account with needed permissions»*، ثم تشرح سبع خطوات مرقّمة على موقع Meta للمطورين.
بيانات الاعتماد هي **Whatsapp Business ID** و**Whatsapp User Access Token**، وهناك زر **Verify Connection** — ولا يتابع المعالج قبل التحقق من صحة هذه البيانات.
> [!TIP]
>
> **لوجود دليل الإعداد داخل المنتج سبب**
>
> ربط واتساب للأعمال يعني إنشاء حساب أعمال على Meta، وربط تطبيق، وربط حساب مطوّر، ومنح الصلاحيات — أربعة أمور على منصة جهة أخرى، لا تستطيع OTO القيام بأي منها نيابةً عنك.
>
> ووضع الدليل داخل المعالج، ورفض المتابعة حتى يتم التحقق من بيانات الاعتماد، هما ما يمنع الخطأ المعتاد: ربط يبدو مضبوطًا، ويُحفظ دون مشاكل، ثم لا يرسل شيئًا دون أي تنبيه.
### القوالب
الشكل 2 — اللغة والفئة وحالة الاعتماد لكل قالب — مع عمود Created by OTO يفصل القوالب الجاهزة عن قوالبك الخاصة.
| | |
| - | - |
| **Template Name** | الاسم الذي تميّز به القالب. |
| **Language** | قالب لكل لغة — ويظهر English والعربية كلاهما. |
| **Category** | تصنيف Meta نفسها — **utility** أو **marketing**. ويؤثر فيما يُسمح لك بإرساله وفي تكلفته. |
| **Status** | **Approved**، أو **Need Parameter Check** ما دام هناك ما يجب حلّه. |
| **Created by OTO** | هل هذا أحد قوالب OTO الجاهزة أم قالب كتبته أنت. |
> [!NOTE]
>
> **utility أو marketing ليس مجرد تسمية**
>
> تتعامل Meta مع الفئتين بشكل مختلف: رسائل utility مرتبطة بمعاملة يخوضها العميل بالفعل، أما رسائل marketing فترويجية وتخضع لقواعد موافقة أشد وسعر مختلف.
>
> وتصنيف إشعار توصيل على أنه marketing طريقة شائعة لجعل رسالة بسيطة أصعب في الإرسال وأعلى تكلفة مما يلزم.
### الإعداد
الشكل 3 — اللغة للقراءة فقط — تأتي من القالب، لا من اختيار تقوم به هنا.
| | |
| - | - |
| **Name** إلزامي | الاسم الذي تمنحه لهذا الإعداد. |
| **Message Type** إلزامي | الحدث الذي يستجيب له. |
| **Connection Name** إلزامي | حساب واتساب للأعمال الذي يرسله. |
| **Template Name** إلزامي | القالب المعتمد الذي يحمل النص. |
| **Language** | تُملأ تلقائيًا من القالب. |
| **Brands** | العلامة التجارية التي ينطبق عليها. |
| **Status** إلزامي | مفعّل أم لا. |
ثم تعرض قائمة الإعدادات صفًا لكل إعداد — **Message Type · Setting Name · Connection Name · Brand Name · Language · Status** — فتظهر في جدول واحد أي علامة تجارية تقول ماذا، وبأي لغة، ومن أي حساب.
الشكل 4 — يمكن الفلترة بكل الأعمدة، وهذا مهم حين يكون لكل علامة تجارية مجموعتها الخاصة.
### أنواع الرسائل
| | |
| - | - |
| **Tracking** | تحديثات الشحنة ورابط التتبع. |
| **Feedback** | طلب تقييم بعد التوصيل. |
| **Undelivered Attempt** | فشلت محاولة التوصيل، وهذه طريقة إعادة الجدولة. |
| **Address Verification** | تأكيد عنوان التوصيل أو تصحيحه. |
| **Return Request** | بدء إرجاع. |
| **Delivery OTP** | رمز التأكيد عند التسليم. |
> [!WARNING]
>
> **القوالب تحتاج إلى اعتماد، والاعتماد يستغرق وقتًا**
>
> تراجع واتساب كل قالب قبل إمكانية إرساله، والقالب المرفوض لا يمكن استخدامه إطلاقًا. وهذا يجعل مكتبة القوالب شيئًا يُعدّ قبل الإطلاق لا أثناءه — ويعني أن تغيير الصياغة في اللحظات الأخيرة ليس عملًا يستغرق خمس دقائق.
>
> ولهذا أيضًا لا يمكن تفعيل إعداد واتساب دون قالب صالح خلفه: لا يوجد بديل يُلجأ إليه.
> [!TIP]
>
> **لماذا يستحق الأمر هذا الجهد الإضافي؟**
>
> اعتماد القوالب تكلفة حقيقية. وما تحصل عليه في المقابل رسالة في التطبيق الذي يعيش فيه عميلك فعلًا، تحمل اسم نشاطك التجاري الموثّق، في محادثة يستطيع الرد فيها — بدلًا من رسالة نصية من رقم مختصر لا يعرفه.
>
> وفي المنطقة التي تخدمها OTO، يكون الفرق في طريقة استقبال الرسالة عادةً أكبر من الفرق في طريقة إرسالها.
## الإرسال اليدوي
يرسل **Notify** في شاشة الشحنات رسالة واتساب لطلب محدد، باستخدام القالب المضبوط. وبخلاف الرسائل النصية، يتم ذلك لطلب واحد في كل مرة.
## للسائقين رسائلهم الخاصة
بمعزل عن إشعارات العملاء، يرسل سائقو OTO FLEX رسائل واتساب إلى العملاء من تطبيق السائق، باستخدام قوالب محددة مسبقًا خاصة بهم. القناة نفسها، لكن المرسِل والغرض مختلفان — انظر [التوصيل](https://docs.tryoto.com/ar/modules/oto-flex/delivery.md).
## صفحات ذات صلة
* [الرسائل النصية (SMS)](https://docs.tryoto.com/ar/modules/customer-notification/sms.md): البديل حين لا يكون واتساب متاحًا.
* [صفحات بعلامتك التجارية](https://docs.tryoto.com/ar/modules/customer-notification/branded-pages.md): ما ترتبط به الرسالة.
* [التوصيل](https://docs.tryoto.com/ar/modules/oto-flex/delivery.md): المراسلة من السائق إلى العميل.
## Related topics
- [إشعارات العملاء](https://docs.tryoto.com/ar/modules/customer-notification/overview.md)
- [إشعارات البريد الإلكتروني](https://docs.tryoto.com/ar/modules/customer-notification/email.md)
- [إشعارات الرسائل النصية (SMS)](https://docs.tryoto.com/ar/modules/customer-notification/sms.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.