الربط التقني · SMS API

ربط الرسائل النصية عبر SMS API للشركات في السعودية

أرسلوا رموز التحقق والتنبيهات والحملات من أنظمتكم عبر REST أو SMPP أو SOAP، باسم المرسل المسجّل لكم، مع تقرير تسليم لكل رسالة.

  • أسماء مرسل مسجّلة
  • ضمان وقت تشغيل 99.9%
  • تقرير تسليم لكل رسالة

شركاء الاتصالات المباشرون

STCموبايليزين

باختصار

يتيح SMS API من Digital Connect للشركات في السعودية إرسال الرسائل النصية من أنظمتها مباشرة. يدعم ثلاث طرق للربط: REST و SMPP و SOAP، ويرسل كل رسالة باسم مرسل مسجّل لتلك الشركة. كل رسالة يعود عنها تقرير تسليم. ويُمنح الوصول بعد إعداد حساب الشركة واسم المرسل.

ثلاث طرق للربط

الطرق الثلاث تربط أنظمتكم بالمنصة نفسها. اختاروا بحسب حجم رسائلكم وما يدعمه نظامكم اليوم.

طرق الربط عبر SMS API
الطريقةمتى تناسبما تحتاجونه
REST APIرسائل التطبيقات: رموز التسجيل وتحديثات الطلبات والأحداث من تطبيقكممهارات تطوير الويب المعتادة، وخوادم مدرجة في قائمة عناوين IP المعتمدة
SMPPالإرسال بأحجام كبيرة ومستمرة، أو الأنظمة المبنية على بروتوكولات الاتصالاتبرنامج SMPP وتفاصيل الجلسة التي نتفق عليها أثناء التهيئة
SOAPنظام أعمال قائم، مثل نظام ERP، لا يدعم غير SOAPوصف الخدمة وبيانات الدخول التي نرسلها مع الوصول

هكذا يبدو طلب REST يرسل رسالة واحدة. ومكان YOUR_API_KEY المفتاح الذي تستلمونه مع الوصول.

curl -X POST https://api.connect.interkey.com.sa/v1/sms \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+966501234567",
    "from": "YourBrand",
    "message": "Your OTP is 123456"
  }'

ما يمكنكم إرساله

من الطلب إلى أول رسالة

  1. اطلبوا الوصول إلى API من النموذج في هذه الصفحة.
  2. إعداد الحساب واسم المرسل. تسجّل إنتركي اسم المرسل لكم أثناء التهيئة.
  3. استلام بيانات الربط والاتفاق على عناوين IP المسموح لها بالاتصال، أو على اتصال VPN.
  4. إرسال رسائل اختبار بالعربية والإنجليزية وفحصها على أجهزة حقيقية قبل الإرسال بالحجم الكامل.

اطلبوا سعرًا لحجم رسائلكم

تقارير التسليم والإشعارات

يخبركم تقرير التسليم هل وصلت الرسالة إلى هاتف المستلم، أم فشلت، أم ما زالت في الطريق. وهذا غير قبول المزوّد للرسالة للإرسال. يعطيكم Digital Connect تقرير تسليم لكل رسالة، وتقارير عن الأداء ونتائج التسليم في المنصة يمكن تصديرها، وإشعارات ترسل حالة التسليم إلى نظامكم مباشرة. فتستطيع مسارات رموز التحقق والتنبيهات والتذكيرات لديكم أن تتصرف بحسب النتيجة، كأن تعرض رمزًا جديدًا حين تفشل رسالة. واسألونا كيف تصل حالات التسليم إلى نظامكم على طريقة الربط التي تختارونها.

شرح تقارير تسليم الرسائل النصية

الأمان

تتصل خوادمكم من عناوين IP معتمدة أو عبر اتصال VPN، فلا يكفي تسرّب بيانات الدخول وحده للاتصال من عنوان خارج قائمتكم. احفظوا بيانات الدخول إلى API على خوادمكم، لا داخل تطبيق جوال ولا في شيفرة المتصفح. ويدخل مستخدمو المنصة بالتحقق بخطوتين ويعملون بصلاحية مدير أو مستخدم، وتعتمد القوالب من فريقكم ومن إنتركي، وعلى حسابكم حماية من الاحتيال وحظر للدول وحدود للإنفاق.

ضوابط بوابة الرسائل النصية الآمنة

الرسائل العربية وطولها

يُرسل النص العربي بترميز Unicode، فتتسع الرسالة الواحدة لـ70 حرفًا، وكل جزء من الرسالة الطويلة لـ67 حرفًا. أما النص الإنجليزي بترميز GSM-7 فيتسع لـ160 حرفًا، أو 153 لكل جزء. وكل جزء يُحسب رسالة، فافحصوا القوالب الطويلة قبل إرسالها بأحجام كبيرة.

حاسبة مقاطع الرسائل النصية

أسئلة عن SMS API

ما هو SMS API؟

SMS API واجهة تتيح لنظامكم إرسال الرسائل النصية آليًا عبر مزوّد، دون أن يكتبها أحد يدويًا. يستدعيها تطبيقكم حين يقع حدث، مثل تسجيل دخول أو طلب شراء، فتخرج الرسالة باسم المرسل المسجّل لكم ومعها تقرير تسليم.

أي طريقة أستخدم: REST أم SMPP أم SOAP؟

REST يناسب أغلب التطبيقات، و SMPP يناسب الأحجام الكبيرة المستمرة، و SOAP يناسب أنظمة الأعمال القائمة التي لا تدعم غيره. ابدؤوا من حجم رسائلكم ومما يدعمه نظامكم اليوم، ويمكنكم البدء بـREST ثم مناقشة SMPP مع نمو الحجم. المقارنة بين SMPP و REST

هل أحتاج اسم مرسل مسجّلًا لاستخدام API؟

نعم. كل رسالة تخرج باسم مرسل مسجّل لشركتكم، وتتولى إنتركي التسجيل أثناء التهيئة. أرسلوا الرسائل باسم شركتكم

كيف أعرف أن الرسالة وصلت؟

يعود عن كل رسالة تقرير تسليم يبيّن هل وصلت أم فشلت أم ما زالت في الطريق. تجدونه في المنصة، ويمكنكم تصديره أو استقباله في نظامكم. تقارير تسليم الرسائل النصية

كيف يُسعَّر SMS API؟

بعرض سعر مبني على حجم رسائلكم الشهري ونوعها. ورسائل OTP تُسعَّر منفصلة عن الرسائل الدعائية. كيف تُسعَّر الرسائل النصية

اطلبوا الوصول إلى API

أخبرونا بما سترسلونه، وحجم رسائلكم الشهري المتوقع، وطريقة الربط التي يدعمها نظامكم. وسنرد عليكم بخطوات التهيئة وعرض سعر لرسائلكم.

  1. نقرأ رسالتكم
  2. نسألكم عن الحجم وأنواع الرسائل
  3. يصلكم عرض مكتوب

بإرسالك هذا النموذج، فأنت توافق على سياسة الخصوصية.