باختصار
يتيح SMS API من Digital Connect للشركات في السعودية إرسال الرسائل النصية من أنظمتها مباشرة. يدعم ثلاث طرق للربط: REST و SMPP و SOAP، ويرسل كل رسالة باسم مرسل مسجّل لتلك الشركة. كل رسالة يعود عنها تقرير تسليم. ويُمنح الوصول بعد إعداد حساب الشركة واسم المرسل.
ثلاث طرق للربط
الطرق الثلاث تربط أنظمتكم بالمنصة نفسها. اختاروا بحسب حجم رسائلكم وما يدعمه نظامكم اليوم.
| الطريقة | متى تناسب | ما تحتاجونه |
|---|---|---|
| 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"
}'
ما يمكنكم إرساله
- رموز التحقق OTP للتسجيل والدخول وتأكيد الدفع.
- تنبيهات تشغيلية عن طلب العميل أو حسابه أو خدمته.
- حملات للعملاء الذين اختاروا استقبالها.
- تذكيرات بالمواعيد وتواريخ الاستحقاق.
من الطلب إلى أول رسالة
- اطلبوا الوصول إلى API من النموذج في هذه الصفحة.
- إعداد الحساب واسم المرسل. تسجّل إنتركي اسم المرسل لكم أثناء التهيئة.
- استلام بيانات الربط والاتفاق على عناوين IP المسموح لها بالاتصال، أو على اتصال VPN.
- إرسال رسائل اختبار بالعربية والإنجليزية وفحصها على أجهزة حقيقية قبل الإرسال بالحجم الكامل.
تقارير التسليم والإشعارات
يخبركم تقرير التسليم هل وصلت الرسالة إلى هاتف المستلم، أم فشلت، أم ما زالت في الطريق. وهذا غير قبول المزوّد للرسالة للإرسال. يعطيكم 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 تُسعَّر منفصلة عن الرسائل الدعائية. كيف تُسعَّر الرسائل النصية
