Skip to main content

SMS

أرسل رسائل SMS حول العالم عبر بنية بوّابة SMPP في Orbit. تتصل Orbit بمشغّلين ومجمّعين من الفئة الأولى في أكثر من 190 دولة، وتتعامل مع الربط والترميز وتتبّع التسليم تلقائيًا.

إرسال SMS

يُتحقَّق من to وfrom كليهما بصيغة E.164 — الصيغة الدولية الكاملة مع رمز الدولة. كيف تتحقّق Orbit وتطبّع الأرقام موصوف في دورة حياة الأرقام.

الاستجابة

تردّ نقطة النهاية بـ HTTP 202 Accepted — الرسالة محفوظة ومُدرَجة للتسليم. المعرّف id هو معرّف رسالة على المنصّة بالصيغة msg_ متبوعة بـ 32 محرفًا ست عشريًا؛ تتبّع دورة حياتها عبر webhooks التسليم.
اقرأ segments وencoding في كل إرسال — هذا ما تُحتسَب عليه الفاتورة.

أساسيات قابلية التسليم

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

اختيار نوع المرسِل

ما الذي يطلبه بلد وجهتك من حيث التسجيل تسرده متطلبات الامتثال في الدول.

تسجيل 10DLC وأنواع الحملات (الولايات المتحدة)

إذا كنت ترسل إلى وجهات أمريكية عبر رموز طويلة رقمية، يشترط المشغّلون التسجيل؛ وتُرشَح الحركة غير المسجَّلة أو تُثقَل برسوم إضافية أو كليهما. تُقدِّم Orbit التسجيل عبر The Campaign Registry نيابة عنك — الدليل الكامل (علامة ← حملة ← موافقة ← طبقات الإخراج) في دليل تسجيل 10DLC. النقطة الأمريكية المميِّزة: الإخراج بعد التسجيل يُمنَح كـ سقف مقاطع يومي لكل رقم استنادًا إلى درجة تقييم علامتك — لا كمعدّل لكل ثانية. لوجهات خارج الولايات المتحدة التي تبوِّب هويات المرسِل الأبجدية الرقمية (معظم أوروبا والبرازيل وبنغلاديش وأجزاء من APAC)، فالمسار الموازي هو تسجيل هوية المرسل. الهند استثناء: تُسجَّل هويات المرسلين («Headers») عبر DLT/TRAI — راجع الانضمام إلى DLT الهند.

الترميز والربط

الترميز هو متغيّر الكلفة الوحيد الذي ينجو من مسجّلٍ سليم. تُحتَسَب 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 والترميز.

مثال محسوب

شُحِنت طلبيتك — ردّ بـ نعم — 30 حرفًا كلها GSM-7 → مقطع واحد، GSM-7. إضافة إيموجي واحد يقلب الأبجدية؛ ويصبح بريد ASCII من 160 حرفًا فورًا 2 مقطع UCS-2. الحدّ الأقصى الصارم: 10 مقاطع (1٬530 حرف GSM-7 أو 670 حرف UCS-2)؛ وما يزيد عن ذلك يُقتَطع مع ضبط wasTruncated: true.

دورة حياة الحالة

كل SMS صادر يحمل status تتقدّم: queuedsendingsentdelivered (أو failed / undelivered / rejected / expired) اشترك في الانتقالات عبر webhooks باستخدام أحداث message.sent وmessage.delivered وmessage.failed. الأدقّيات التي تلتقط المشغّلين:
  • submitted_no_receipt — قبِل المزوّد الإرسال، لكن لم يأتِ DLR داخل نافذة السماح البالغة 30 دقيقة. عامِله كـ نتيجة مجهولة، لا تسليمًا ولا فشلًا.
  • expired — وصل DLR بعد إغلاق نافذة الوصول المتأخّر؛ الصف مغلَق.
  • rejected — بوّابة مرسِل: تسجيل ناقص أو سياسة محتوى. حتميّ ما لم تُخلَص البوّابة.
الآلة الحالاتية على مستوى المفهوم في دورة حياة التسليم؛ ومعالجة الأعطال في استكشاف الأخطاء: الرسالة غير مُسلَّمة أو فاشلة.

التسعير

تسعير SMS لكل مقطع ويختلف بحسب الدولة الوجهة. راجع صفحة التسعير أو استعلم GET /api/v1/pricing/messaging?country=<ISO> لأسعار اللحظة. يُحتَسَب إرسالان متطابقَين بشكل مختلف حين ينقلب ترميز أحدهما إلى UCS-2 — راجع الترميز والربط.

حدود المعدّل

تُحدَّد إرسالات SMS افتراضيًا بـ 100 طلب/دقيقة لكل مستأجر؛ ويكون الحدّ مفتاحًا على المستأجر (المنظمة)، لا على عنوان IP أو الخطة. تجاوزه يعطي 429 RATE_LIMITED؛ راجع دليل حدود المعدّل. يمكن رفع حدود كل قناة الافتراضية (SMS 100 وWhatsApp 80 والبريد 200 والفاكس 20 وغيرها) عبر channel_rate_overrides في إعدادات المراسلة لمنظمتك.

الميزات

  • مراسلات A2P وP2P — من التطبيق إلى الشخص ومن الشخص إلى الشخص
  • وصول عالمي — أكثر من 190 دولة عبر شبكة المجمّعين لدى Devotel
  • تقارير تسليم — webhooks للحالة في الوقت الحقيقي لكل رسالة
  • رسائل مربوطة — معالجة SMS متعدد الأجزاء بشفافية (حتى 10 مقاطع)
  • تحقّق من E.164 — تحقّق تلقائي من صيغة رقم الهاتف
  • دعم Unicode — ترميز GSM-7 وUCS-2 كامل مع اكتشاف تلقائي وتطبيع علامات الترقيم الذكية