احتفظ بالمفاتيح خارج المتصفح والسجلات.
ربط الرسائل مع أنظمتك
ربط SMS API للأنظمة والتطبيقات
اربط تطبيقك أو CRM أو متجرك برسائل ITBeep في الأردن. دليل للمصادقة الآمنة، العربية، معرّفات الرسائل، معالجة الأخطاء واختيار API أو SMPP.
من قبول طلب الإرسال إلى تقرير التسليم.
نساعدك في إعداد الإرسال والتقارير.
من التطبيق إلى الرسالة
مصادقة واضحة ورسائل قابلة للتتبع
ينفذ خادم تطبيقك الإرسال باستخدام مفتاح الحساب وطريقة المصادقة الواردة في توثيق الربط المعتمد. لا تضع المفتاح في JavaScript عام أو رابط تحليلات أو مستودع الكود. احجب بيانات الاعتماد ونصوص OTP من سجلات الطلبات، واستخدم HTTPS.
يحتاج طلب الإرسال إلى مفتاح الحساب api-token واسم المرسل SenderText ورقم الجوال MobileNumber ونص الرسالة MessageBody. احفظ عنوان الربط والمفتاح في إعدادات الخادم. بعد الإرسال، افحص حالة HTTP وقيمة success لمعرفة نتيجة الطلب، ثم تابع تقرير التسليم. تجد تفاصيل الاستجابة ومعرّفات الرسائل في توثيق الربط الخاص بحسابك.
- ✓نسّق الجوال دولياً: 962 ثم الرقم دون الصفر المحلي.
- ✓اختبر العربية والنص المختلط والأجزاء قبل حساب الكلفة.
- ✓اربط مرجع العملية في نظامك بمعرّف الرسالة المتاح في الاستجابة.
const url = new URL(process.env.SMS_SEND_URL);
url.search = new URLSearchParams({
"api-token": process.env.SMS_TOKEN,
SenderText: approvedSender,
MobileNumber: recipient,
MessageBody: messageText
}).toString();
const response = await fetch(url, {
redirect: "error",
signal: AbortSignal.timeout(10000)
});
const result = await response.json();
if (!response.ok || result.success !== true) {
throw new Error("Submission not confirmed");
}API أم SMPP؟
API أم SMPP: ما الأنسب لنظامك؟
SMS API مناسب للمتاجر والتطبيقات وCRM: يرسل نظامك رسالة عند حدوث طلب أو تسجيل دخول أو موعد. أما SMPP فيناسب الأنظمة التي تدير اتصالاً مستمراً وأحجام إرسال كبيرة. نحدد معك معدل الإرسال المناسب للحساب والوجهات.
صحّح أخطاء البيانات، مثل الرقم غير الصحيح، قبل إعادة الطلب. عند انقطاع مؤقت، انتظر مدة متزايدة بين المحاولات. وإذا انتهت مهلة الطلب دون نتيجة، تحقق من حالته أولاً لتجنب إرسال الرسالة مرتين. احتفظ بمرجع ثابت لكل عملية في نظامك.
عند استخدام Webhook لتحديث الحالات، تحقق من مصدر الإشعار وفق إعدادات الربط. قد يصل الإشعار أكثر من مرة أو بترتيب مختلف؛ حدّث حالة الرسالة باستخدام مرجعها دون إعادة إرسال النص.
خطوات التنفيذ
كيف نجهز الخدمة ونطلقها
نراجع الاستخدام والمتطلبات، ثم نختبر الإعداد قبل بدء الإرسال الفعلي.
- 01جلسة تقنية قصيرة
الأحداث والدول والحجم والأنظمة.
- 02مفاتيح واختبار
طلبات عينة وحالات خطأ مقصودة.
- 03ربط التقارير
Webhook محمي ومعالجة بلا تكرار.
- 04إطلاق مراقب
حجم محدود ثم توسع مضبوط.
المعلومات المطلوبة
زوّدنا بهذه التفاصيل لإعداد العرض
هذه المعلومات تساعدنا على تحديد السعر والمتطلبات وطريقة التشغيل المناسبة من أول تواصل.
- 01لغة البرمجة والنظام المصدر
- 02الاستخدامات والقوالب
- 03الدول والحجم والذروة
- 04متطلبات Webhook والسجلات
أسئلة شائعة
إجابات مختصرة عن الخدمة
هل توفرون بيئة اختبار؟+
نحدد أسلوب الاختبار والبيانات المتاحة ضمن الإعداد التقني قبل تسليم مفاتيح الإنتاج، ونختبر النجاح والأخطاء والتقارير.
هل تدعم API رسائل OTP والحملات؟+
يمكن استخدامها لعدة أنواع، لكننا نفصل التدفقات والقوالب ومعدلات الإرسال حتى لا تختلط الرسائل الحساسة بالحملات.
ما الفرق بين API وSMPP؟+
HTTP API أبسط لمعظم التطبيقات، بينما SMPP يناسب عادة مزودي الرسائل والأحجام الكبيرة التي تحتاج اتصالاً دائماً وإدارة جلسات.
خدمات مرتبطة