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

# إشعارات الرسائل النصية (SMS)

> أرسل إشعارات الرسائل النصية إلى عملائك: اربط مزوّد الرسائل النصية، واختر من 14 نوعًا من الرسائل، واكتب النص، وأرسل تلقائيًا أو يدويًا، وتحقق من وصول الرسائل.

> [!NOTE]
>
> **مكانه في المنصة:** الإعدادات ← Customer Notifs ‏← SMS — [افتح في OTO ↖](https://app.tryoto.com/sms-setup)

الرسائل النصية قناة لا تحتاج إلى تثبيت أي تطبيق أو تسجيل دخول، ويقرؤها الجميع. ولرسالة توصيل يجب أن تصل خلال دقيقة، لا تزال الخيار الأكثر موثوقية.

## شاشة واحدة، وعلامة تجارية واحدة في كل مرة

تُضبط الرسائل النصية من **الإعدادات ← Customer Notifs ‏← SMS** عبر ثلاثة تبويبات: **SMS Settings** و**SMS Providers** و**Connected SMS Providers**.

تبدأ الإعدادات باختيار العلامة التجارية، لأنها ما يراه العميل بوصفه المرسِل. ثم **مزوّد الخدمة** و**Status** — وبعبارة المنتج نفسه: *«Turn SMS notifications ON or OFF for this brand.»* وتحت ذلك يظهر كل نوع من الرسائل في بطاقة، مع وصف يبيّن متى تُرسل بالضبط، وأيقونة قلم **للتعديل**، ومفتاح تفعيل خاص بها.

![شاشة SMS Settings](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/cn-8-sms.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=3a0990aaab0d18265fd4e0249c36d051)

الشكل 1 — نموذج الجوال على اليمين يعرض الرسالة كما ستصل، بما في ذلك اسم المرسِل — فما تعدّله هو بالضبط ما يستلمه العميل.

## أربعة عشر نوعًا من الرسائل

لكل نوع فئة، واسم واضح، وحدث يُطلقه.

| الفئة | الرسالة | تُرسل عندما |
| - | - | - |
| **Shipment Tracking** | **Shipment in Transit** | تكون الشحنة في طريقها إلى عنوان التوصيل. |
| | **Delayed Dispatch** | يتأخر إرسال الشحنة عن الوقت المتوقع. |
| **Delivery Updates** | **Order Confirmation** | يُؤكَّد الطلب بنجاح. |
| | **Delivery Attempt Failed** | لا يتمكن المندوب من إتمام التوصيل. |
| | **Delivery Rescheduled** | بعد محاولة توصيل غير ناجحة، لطلب موعد توصيل جديد. |
| **Address Verification** | **Verify Delivery Address** | يحتاج العنوان إلى تأكيد قبل التوصيل. |
| **Delivery Slot Notifications** | **Delivery Slot Confirmation** | تُنشأ شحنة، لجدولة فترة توصيل. |
| **Delivery OTP** | **Delivery OTP Code** | يلزم رمز تحقق لمرة واحدة لإتمام التوصيل. |
| **Click & Collect** | **Click & Collect Updates** | يُجهَّز طلب للاستلام من المتجر. |
| **Customers Feedback** | **Rate Your Delivery Experience** | بعد التوصيل الناجح، لجمع التقييمات. |
| **Returns** | **Return Request Created** | يبدأ المستلم طلب إرجاع. |
| | **Return Request Approved** | يُقبَل طلب الإرجاع المقدّم من العميل. |
| | **Return Request Rejected** | يُرفض طلب الإرجاع المقدّم من العميل. |
| **Manual Notifications** | **Manual SMS** | يرسلها شخص يدويًا كرسالة مخصّصة. |

![أنواع الرسائل، لكل منها حدث يُطلقها](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/cn-9-types.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=1ecb64d6c19b474e9ca01231d5e0135c)

الشكل 2 — كل بطاقة توضح متى تُرسل. وإيقاف أي منها بنقرة واحدة، وينطبق على هذه العلامة التجارية فقط.

> [!TIP]
>
> **ابدأ بتفعيل Delayed Dispatch**
>
> معظم هذه الرسائل تخبر العميل بشيء حدث. أما **Delayed Dispatch** فتخبره بشيء *لم* يحدث: الطرد الذي كان يجب أن يُرسَل ولم يُرسَل.
>
> هذا هو الصمت الذي يملؤه العملاء بتذكرة دعم، وهي الرسالة الوحيدة هنا التي تستبق الشكوى بدلًا من الرد عليها.

## كتابة الرسالة

![تعديل رسالة](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/cn-10-edit.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=f425bcd5e233dda3a167aa4edca524de)

الشكل 3 — أمران يحددان ما يُرسَل: إلى من تذهب الرسالة، وماذا تقول. وعدّاد الأحرف يتابع مقطع الرسالة النصية أثناء الكتابة.

| | |
| - | - |
| **This message will be sent to** | قائمة بـ**دول الوجهة**. يمكن أن يحمل نوع الرسالة نفسه نصوصًا مختلفة لأسواق مختلفة. |
| **Message Body** | النص، مع حقول ديناميكية داخل `{{ }}` — رقم الطلب، ورابط التتبع، وغيرهما — و**عدّاد أحرف مباشر مقابل مقطع الرسالة النصية البالغ 160 حرفًا**. |

> [!TIP]
>
> **النص الخاص بكل دولة ليس مجرد ميزة إضافية**
>
> الرسالة العربية والإنجليزية بالطول نفسه لا تتساويان في تكلفة الإرسال: فالأحرف غير اللاتينية تستخدم مقطعًا أقصر، ولذلك فالصياغة التي تتسع لها رسالة واحدة بالإنجليزية قد تصبح دون أن تلاحظ رسالتين أو ثلاثًا بالعربية.
>
> كتابة النص لكل وجهة — مع مراقبة العدّاد أثناء ذلك — هي ما يُبقي تكلفة برنامج الإشعارات قابلة للتوقع عند تجاوز الحدود. وهي أيضًا ما يجعل الرسالة تصل باللغة التي يقرؤها المستلم فعلًا.

وقبل التفعيل، يرسل **Send Test SMS** الرسالة الحقيقية إلى رقم تختاره.

> [!NOTE]
>
> **الرابط هو الرسالة**
>
> للرسالة النصية مهمة واحدة: إيصال العميل إلى الصفحة. فكل ما يهم — الحالة، والخريطة، والنموذج، وعلامتك التجارية — موجود هناك، حيث تتسع المساحة ولا توجد تكلفة لكل حرف.
>
> ولهذا فإن نوع الرسالة الذي لا تقف خلفه [صفحة بعلامتك التجارية](https://docs.tryoto.com/ar/modules/customer-notification/branded-pages.md) هو إرسال ضائع: يصل كنص يخبر العميل بشيء دون أن يتيح له فعل أي شيء حياله.

## مزوّدو الخدمة

لا ترسل OTO الرسائل بنفسها، بل تتصل بمزوّد خدمة الرسائل النصية الخاص بك. وتبويب **SMS Providers** كتالوج للمزوّدين المربوطين مسبقًا — *«Easily integrate your preferred SMS provider to send order updates, delivery notifications, and more instantly.»*

![كتالوج مزوّدي الرسائل النصية](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/cn-11-providers.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=e9fbde5e0d5e05af78a9c87f3d1ce7e0)

الشكل 4 — مشغلون إقليميون ومنصات عالمية جنبًا إلى جنب، وكل منها على بُعد نقرة Connect.

وتتجاوز القائمة الأسماء المعتادة بكثير: **STC** و**Mobily** و**Zain** و**Unifonic** و**Unifonic Cloud** و**Msegat** و**Taqnyat** و**4jawaly** و**Hi SMS** و**Bevatel** و**Mrasel** و**Mshastra** و**Gateway** و**iMissive** و**BabSMS** و**GoInfinito** و**TurkeySMS** و**Twilio**، وغيرها.

ويتطلب ربط أي مزوّد **Connection Name**، و**Sender Name** — الاسم الذي يظهر كمرسِل على جوال العميل — و**Token** من المزوّد، ومفتاح **Status**. ثم تعرض **Connected SMS Providers** المزوّدين المربوطين لديك، لكل منهم مفتاح وقائمة خاصة، فيمكن إيقاف أي مزوّد دون حذفه.

> [!TIP]
>
> **لماذا يهم العمق الإقليمي؟**
>
> المنصة العالمية ستُوصل الرسالة إلى Riyadh، لكن تسجيل اسم المرسِل، ومعدلات التسليم المحلية، وسعر الرسالة الواحدة كلها أفضل عبر مشغّل محلي — وفي بعض الأسواق لا تصل الرسالة أصلًا إذا كان اسم المرسِل غير مسجل.
>
> ووجود STC وMobily وZain وTaqnyat وغيرها مربوطة مسبقًا يعني أن الأمر اختيار من قائمة، لا مشروع ربط تقني. ويمكن ربط أكثر من مزوّد في الوقت نفسه.

## تلقائي ويدوي

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

ولكل ما عدا ذلك هناك **Notify** في شاشة الشحنات: اختر طلبًا، ثم **Send SMS**، ثم النوع، وأرسل. وهي تستخدم القوالب المضبوطة نفسها، فيبدو الإرسال اليدوي متسقًا مع بقية تواصلك. والرسائل النصية هي القناة الوحيدة التي يمكن إرسالها لعدة طلبات دفعة واحدة بهذه الطريقة.

وتستحق **Click & Collect** ملاحظة خاصة: رسالة «جاهز للاستلام» تحمل نقطة الاستلام، وإن كنت تستخدمه، **Delivery Confirmation Code** الذي يذكره العميل عند التسليم. انظر [تجهيز الطلبات](https://docs.tryoto.com/ar/modules/omnichannel-oms/order-fulfillment.md).

## هل وصلت؟

تحتوي **الإعدادات ← Logs ‏← Notification Logs** على **SMS Logs** و**Email Logs**. ويضم كل صف من سجلات الرسائل النصية **OTO Order ID** و**Sender Name** و**Phone Number**، و**Message Text** كما أُرسل فعلًا، و**Message Time** و**Message Type** و**Provider**، وردّ المزوّد الخام **Gateway Response**، و**Status**.

> [!TIP]
>
> **اقرأ نص الرسالة، لا الحالة فقط**
>
> تعني حالة *Success* أن المزوّد قبِل الرسالة، ويحمل Gateway Response المرجع الخاص بالمزوّد، وعدد المقاطع، والتكلفة. وكلاهما مفيد.
>
> لكن العمود الذي يستحق المراجعة هو **Message Text**، لأنه يعرض ما استلمه العميل فعلًا — بعد استبدال كل الحقول الديناميكية. فالقالب الذي يبدو صحيحًا في المحرر وخاطئًا على الجوال لا يظهر إلا هنا.

![Notification Logs على تبويب SMS Logs](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/cn-16-sms-logs.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=dd1e07e9486ae751be7171dfc35b4823)

الشكل 5 — صف لكل عملية إرسال، فيه الرسالة كما استلمها العميل وبجانبها ردّ المزوّد نفسه.

ويظهر الفشل بوضوح مع سببه: شارة **Failed**، والسبب مذكور في Gateway Response — إرسال مكرر، أو رقم مرفوض، أو اسم مرسِل غير مسجل.

> [!NOTE]
>
> **ظهور صفّين لطلب واحد أمر طبيعي**
>
> الطلب الذي يُطلق رسالة تتبع ورسالة تأكيد عنوان معًا ينتج صفًا لكل منهما، في الدقيقة نفسها وبرقم الطلب نفسه. وهذا دليل على عمل النظام، لا تكرار.
>
> ما يستحق التحقق هو العكس — طلب له صفوف *أقل* مما تتوقعه أنواع الرسائل المضبوطة.

## صفحات ذات صلة

* [صفحات بعلامتك التجارية](https://docs.tryoto.com/ar/modules/customer-notification/branded-pages.md): ما يفتحه الرابط.
* [واتساب](https://docs.tryoto.com/ar/modules/customer-notification/whatsapp.md): الرسائل نفسها عبر قناة أغنى.
* [إدارة المرتجعات](https://docs.tryoto.com/ar/modules/return-management/overview.md): رسائل الإرجاع الثلاث.


## Related topics

- [إشعارات العملاء](https://docs.tryoto.com/ar/modules/customer-notification/overview.md)
- [إشعارات البريد الإلكتروني](https://docs.tryoto.com/ar/modules/customer-notification/email.md)
- [إشعارات عبر الواتساب](https://docs.tryoto.com/ar/modules/customer-notification/whatsapp.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.