> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # SMS – أرسل واستقبل حول العالم > إعداد SMS على Orbit بجاهزية إنتاجية: إرفاق مرسل والتسجيل حيثما يلزم وتوقُّع الترميز وكلفة المقاطع وقراءة حالات التسليم والتوسّع عبر مجمّعات المرسلين. # SMS أرسل رسائل SMS حول العالم عبر بنية بوّابة SMPP في Orbit. تتصل Orbit بمشغّلين ومجمّعين من الفئة الأولى في أكثر من 190 دولة، وتتعامل مع الربط والترميز وتتبّع التسليم تلقائيًا. ## إرسال SMS ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/sms \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "from": "+18005551234", "body": "مرحبًا من Orbit!" }' ``` يُتحقَّق من `to` و`from` كليهما بصيغة [E.164](https://ar.wikipedia.org/wiki/E.164) — الصيغة الدولية الكاملة مع رمز الدولة. كيف تتحقّق Orbit وتطبّع الأرقام موصوف في [دورة حياة الأرقام](/concepts/number-lifecycle). ### الاستجابة تردّ نقطة النهاية بـ **HTTP 202 Accepted** — الرسالة محفوظة ومُدرَجة للتسليم. المعرّف `id` هو معرّف رسالة على المنصّة بالصيغة `msg_` متبوعة بـ 32 محرفًا ست عشريًا؛ تتبّع دورة حياتها عبر [webhooks التسليم](/webhooks/overview). ```json theme={null} { "data": { "id": "msg_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "status": "queued", "channel": "sms", "segments": 1, "encoding": "GSM-7" } } ``` اقرأ `segments` و`encoding` في كل إرسال — هذا ما تُحتسَب عليه الفاتورة. ## أساسيات قابلية التسليم تعتمد قابلية تسليم SMS على ثلاثة أشياء بهذا الترتيب: **مَن ترُسل منه**، **إلى أين**، و**بأي سرعة**. عالجها بشكل صحيح، فيبقى الترميز المتغيّر الوحيد في الكلفة. ### اختيار نوع المرسِل | نوع المرسِل | الأفضل لـ | القيد | | -------------------------------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | **هوية مرسل أبجدية رقمية** (`MyBrand`) | تعرّف العلامة التجارية؛ الأسواق التي تُكمَت فيها هويات المرسيلين الرقمية | تسجيل مطلوب في العديد من الدول؛ لا يدعم الردود (أحادي الاتجاه) | | **رمز طويل رقمي** (`+14155550123`) | SMS ثنائي الاتجاه، الردود، الدعم الحواري | يتفاوت الإخراج بحسب الدولة (الولايات المتحدة: سجّل في [10DLC](#تسجيل-10dlc-وأنواع-الحملات-الولايات-المتحدة) للإخراج الكامل) | | **رمز قصير** (`12345`) | حملات عالية الإخراج، إرسالات OTP سهلة الحفظ | زمن قيادة مشغّل طويل، كلفة أعلى | | **مجمّع مرسِلين** | حجم عالٍ، حضور محلي، تدوير المرسِل المتدهور | راجع [مجمّعات المرسِلين](/guides/sender-pools) | ما الذي يطلبه بلد وجهتك من حيث التسجيل تسرده [متطلبات الامتثال في الدول](/compliance/country-requirements). ## تسجيل 10DLC وأنواع الحملات (الولايات المتحدة) إذا كنت ترسل إلى وجهات أمريكية عبر رموز طويلة رقمية، يشترط المشغّلون التسجيل؛ وتُرشَح الحركة غير المسجَّلة أو تُثقَل برسوم إضافية أو كليهما. تُقدِّم Orbit التسجيل عبر The Campaign Registry نيابة عنك — الدليل الكامل (علامة ← حملة ← موافقة ← طبقات الإخراج) في [دليل تسجيل 10DLC](/guides/10dlc-registration). النقطة الأمريكية المميِّزة: الإخراج بعد التسجيل يُمنَح كـ **سقف مقاطع يومي لكل رقم** استنادًا إلى درجة تقييم علامتك — لا كمعدّل لكل ثانية. لوجهات خارج الولايات المتحدة التي تبوِّب هويات المرسِل الأبجدية الرقمية (معظم أوروبا والبرازيل وبنغلاديش وأجزاء من APAC)، فالمسار الموازي هو [تسجيل هوية المرسل](/compliance/sender-id-registration). الهند استثناء: تُسجَّل هويات المرسلين («Headers») عبر DLT/TRAI — راجع [الانضمام إلى DLT الهند](/compliance/dlt-india). ## الترميز والربط الترميز هو متغيّر الكلفة الوحيد الذي ينجو من مسجّلٍ سليم. تُحتَسَب SMS لكل مقطع، ويعتمد عدد المقاطع كليًا على الأبجدية التي يقع فيها النص. ### GSM-7 مقابل UCS-2 * **GSM-7** — أبجدية GSM ذات 7 بت (ASCII بالإضافة إلى بعض الإضافات: `@` و`£` و`€` وبعض اليونانية). يحصل النص الذي يلائمها على **160 حرفًا لكل مقطع**، أو **153 حرفًا** في الإرسال متعدد الأجزاء (تذهب 7 أحرف لكل مقطع إلى ترويسة الربط UDH). * **UCS-2** — أي محرف خارج GSM-7 (الإيموجي، وCJK، وعلامات الاقتباس الذكية، ومعظم الأبجديات غير اللاتينية) يقلب الرسالة بأكملها إلى ترميز 16 بت. يحصل النص على **70 حرفًا لكل مقطع**، أو **67** في المتعدد. محرف واحد غير GSM-7 يعيد تصنيف الرسالة كلها. تطبيع Orbit المخالفات العرضية — علامات الاقتباس الذكية الملصَقة، والشرطات الطويلة، والفواصل العلوية الملتوية، والمحارف الصفرية العرض غير المرئية — إلى مكافئات آمنة مع GSM-7 قبل العدّ، بحيث لا تضاعف أخطاء اللصق فاتورة مقاطعك. النموذج الكامل للترميز والتقسيم في [مفهوم مقاطع SMS والترميز](/concepts/sms-segments-and-encoding). ### مثال محسوب `شُحِنت طلبيتك — ردّ بـ نعم` — 30 حرفًا كلها GSM-7 → **مقطع واحد، `GSM-7`**. إضافة إيموجي واحد يقلب الأبجدية؛ ويصبح بريد ASCII من 160 حرفًا فورًا **2 مقطع UCS-2**. الحدّ الأقصى الصارم: **10 مقاطع** (1٬530 حرف GSM-7 أو 670 حرف UCS-2)؛ وما يزيد عن ذلك يُقتَطع مع ضبط `wasTruncated: true`. ## دورة حياة الحالة كل SMS صادر يحمل `status` تتقدّم: `queued` → `sending` → `sent` → `delivered` (أو `failed` / `undelivered` / `rejected` / `expired`) اشترك في الانتقالات عبر [webhooks](/webhooks/overview) باستخدام أحداث `message.sent` و`message.delivered` و`message.failed`. الأدقّيات التي تلتقط المشغّلين: * `submitted_no_receipt` — قبِل المزوّد الإرسال، لكن لم يأتِ DLR داخل نافذة السماح البالغة 30 دقيقة. عامِله كـ *نتيجة مجهولة*، لا تسليمًا ولا فشلًا. * `expired` — وصل DLR بعد إغلاق نافذة الوصول المتأخّر؛ الصف مغلَق. * `rejected` — بوّابة مرسِل: تسجيل ناقص أو سياسة محتوى. حتميّ ما لم تُخلَص البوّابة. الآلة الحالاتية على مستوى المفهوم في [دورة حياة التسليم](/concepts/delivery-lifecycle)؛ ومعالجة الأعطال في [استكشاف الأخطاء: الرسالة غير مُسلَّمة أو فاشلة](/troubleshooting/message-undelivered-failed). ## التسعير تسعير SMS لكل مقطع ويختلف بحسب الدولة الوجهة. راجع [صفحة التسعير](https://orbit.devotel.io/pricing) أو استعلم `GET /api/v1/pricing/messaging?country=` لأسعار اللحظة. يُحتَسَب إرسالان متطابقَين بشكل مختلف حين ينقلب ترميز أحدهما إلى UCS-2 — راجع [الترميز والربط](#الترميز-والربط). ## حدود المعدّل تُحدَّد إرسالات SMS افتراضيًا بـ **100 طلب/دقيقة لكل مستأجر**؛ ويكون الحدّ مفتاحًا على المستأجر (المنظمة)، لا على عنوان IP أو الخطة. تجاوزه يعطي `429 RATE_LIMITED`؛ راجع [دليل حدود المعدّل](/guides/rate-limits). يمكن رفع حدود كل قناة الافتراضية (SMS 100 وWhatsApp 80 والبريد 200 والفاكس 20 وغيرها) عبر `channel_rate_overrides` في إعدادات المراسلة لمنظمتك. ## الميزات * **مراسلات A2P وP2P** — من التطبيق إلى الشخص ومن الشخص إلى الشخص * **وصول عالمي** — أكثر من 190 دولة عبر شبكة المجمّعين لدى Devotel * **تقارير تسليم** — webhooks للحالة في الوقت الحقيقي لكل رسالة * **رسائل مربوطة** — معالجة SMS متعدد الأجزاء بشفافية (حتى 10 مقاطع) * **تحقّق من E.164** — تحقّق تلقائي من صيغة رقم الهاتف * **دعم Unicode** — ترميز GSM-7 وUCS-2 كامل مع اكتشاف تلقائي وتطبيع علامات الترقيم الذكية