# العربية والسوق السعودي

التفاصيل المهمة لأي نشاط تجاري سعودي، مجموعة في مكان واحد.

## أرقام الهاتف {#phones}

يقبل كل حقل هاتف ما تحفظه أنظمتك أصلًا: `+966501234567` أو `00966501234567` أو `966501234567` أو الصيغة المحلية `0501234567` (تُقرأ كرقم سعودي). تجيب الواجهة البرمجية دائمًا بصيغة E.164 (`+966501234567`)، فاحفظ هذه الصيغة وقارن عليها.

## النص العربي {#arabic}

- أرسل العربية بترميز UTF-8 كما هي: دون ترميز خاص ودون إعادة تشكيل. يعرضها واتساب من اليمين إلى اليسار على هاتف العميل.
- حدود الطول تُحسب بالأحرف لا بالبايتات: نص من 1024 حرفًا يتسع لـ 1024 حرفًا عربيًا.
- الرموز التعبيرية والتشكيل والنص المختلط بين العربية والإنجليزية كلها مقبولة. يُقرأ السطر المختلط بأفضل صورة حين يبدأ باللغة الغالبة عليه.
- أسماء القوالب بحروف لاتينية (صغيرة وأرقام و`_`)، أما نص القالب وأزراره وأمثلته فيمكن أن تكون بالعربية.

## إلغاء الاشتراك برسالة {#opt-out}

عندما تكون حماية كلمات الإيقاف مفعّلة في مساحة العمل، فالعميل الذي يرسل إحدى هذه الكلمات وحدها يُلغى اشتراكه، وإحدى كلمات القائمة الثانية تعيد اشتراكه:

| تلغي الاشتراك | تعيد الاشتراك |
|---|---|
| `إيقاف` و`إلغاء` و`إلغاء الاشتراك` و`توقف` و`STOP` و`UNSUBSCRIBE` | `ابدأ` و`اشتراك` و`START` و`SUBSCRIBE` |

تُطابَق اختلافات الكتابة أيضًا (أ / ا، والأحرف الكبيرة). الكلمة الواردة داخل جملة أطول لا تعني إلغاء الاشتراك، بل تُعلَّم لفريقك، لأن الإلغاء الخاطئ يُفقدك عميلًا حقيقيًا دون أن تشعر. وفي الحالتين يصلك `contact.opted_out` أو `contact.opted_in`.

## الوقت والجدولة {#time}

تتحدث الواجهة البرمجية بتوقيت UTC (`…Z`) في كل مكان. عند جدولة حملة أرسل وقتًا محليًا مع `"timezone": "Asia/Riyadh"`، فتُرسل في ذلك الوقت المحلي.

## الأسعار {#prices}

يحتسب واتساب السعر لكل رسالة قالب حسب الفئة وبلد المستلم. يعطيك `estimated_cost` للحملة هذا السعر بالريال بأسعار اليوم قبل أن تبدأها. يغطي التقدير رسائل القوالب، وهي ما ترسله الحملات، وتجد أرصدة باقتك في [`GET /usage`](/docs/reference/account#getUsage).

## البيانات التي ترسلها إلينا {#data}

- تُحفظ أجسام الطلبات والاستجابات في **المطورين ← السجلات** لمدة 30 يومًا لتتمكن من تتبع المشكلات، ثم تُحذف.
- حذف جهة اتصال عبر الواجهة البرمجية يزيل سجلها ووسومها وحقولها المخصصة، ويبقى سجل محادثاتها في صندوق الوارد.
- الملفات التي ترفعها إلى مكتبة الوسائط تحصل على رابط عام يصعب تخمينه، لأن واتساب يحمّلها منه. لا ترفع أي شيء يجب أن يبقى خاصًا.
