انتقل إلى المحتوى

ربط الرسائل مع أنظمتك

ربط SMS API للأنظمة والتطبيقات

اربط تطبيقك أو CRM أو متجرك برسائل ITBeep في الأردن. دليل للمصادقة الآمنة، العربية، معرّفات الرسائل، معالجة الأخطاء واختيار API أو SMPP.

01
ربط من الخادم

احتفظ بالمفاتيح خارج المتصفح والسجلات.

02
تابع حالة الرسالة

من قبول طلب الإرسال إلى تقرير التسليم.

03
ربط يناسب نظامك

نساعدك في إعداد الإرسال والتقارير.

من التطبيق إلى الرسالة

مصادقة واضحة ورسائل قابلة للتتبع

ينفذ خادم تطبيقك الإرسال باستخدام مفتاح الحساب وطريقة المصادقة الواردة في توثيق الربط المعتمد. لا تضع المفتاح في JavaScript عام أو رابط تحليلات أو مستودع الكود. احجب بيانات الاعتماد ونصوص OTP من سجلات الطلبات، واستخدم HTTPS.

يحتاج طلب الإرسال إلى مفتاح الحساب api-token واسم المرسل SenderText ورقم الجوال MobileNumber ونص الرسالة MessageBody. احفظ عنوان الربط والمفتاح في إعدادات الخادم. بعد الإرسال، افحص حالة HTTP وقيمة success لمعرفة نتيجة الطلب، ثم تابع تقرير التسليم. تجد تفاصيل الاستجابة ومعرّفات الرسائل في توثيق الربط الخاص بحسابك.

  • ✓نسّق الجوال دولياً: 962 ثم الرقم دون الصفر المحلي.
  • ✓اختبر العربية والنص المختلط والأجزاء قبل حساب الكلفة.
  • ✓اربط مرجع العملية في نظامك بمعرّف الرسالة المتاح في الاستجابة.
server-send.js
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");
}
i
مثال من الخادم: اضبط الموصل وفق توثيق حسابك، ولا تسجل الرابط لأنه يتضمن المفتاح.القبول ليس تأكيد تسليم

API أم SMPP؟

API أم SMPP: ما الأنسب لنظامك؟

SMS API مناسب للمتاجر والتطبيقات وCRM: يرسل نظامك رسالة عند حدوث طلب أو تسجيل دخول أو موعد. أما SMPP فيناسب الأنظمة التي تدير اتصالاً مستمراً وأحجام إرسال كبيرة. نحدد معك معدل الإرسال المناسب للحساب والوجهات.

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

عند استخدام Webhook لتحديث الحالات، تحقق من مصدر الإشعار وفق إعدادات الربط. قد يصل الإشعار أكثر من مرة أو بترتيب مختلف؛ حدّث حالة الرسالة باستخدام مرجعها دون إعادة إرسال النص.

دليل SMPP ↗

احسب أجزاء الرسالة ↗

خطوات التنفيذ

كيف نجهز الخدمة ونطلقها

نراجع الاستخدام والمتطلبات، ثم نختبر الإعداد قبل بدء الإرسال الفعلي.

  1. 01جلسة تقنية قصيرة

    الأحداث والدول والحجم والأنظمة.

  2. 02مفاتيح واختبار

    طلبات عينة وحالات خطأ مقصودة.

  3. 03ربط التقارير

    Webhook محمي ومعالجة بلا تكرار.

  4. 04إطلاق مراقب

    حجم محدود ثم توسع مضبوط.

المعلومات المطلوبة

زوّدنا بهذه التفاصيل لإعداد العرض

هذه المعلومات تساعدنا على تحديد السعر والمتطلبات وطريقة التشغيل المناسبة من أول تواصل.

  • 01لغة البرمجة والنظام المصدر
  • 02الاستخدامات والقوالب
  • 03الدول والحجم والذروة
  • 04متطلبات Webhook والسجلات

أسئلة شائعة

إجابات مختصرة عن الخدمة

هل توفرون بيئة اختبار؟+

نحدد أسلوب الاختبار والبيانات المتاحة ضمن الإعداد التقني قبل تسليم مفاتيح الإنتاج، ونختبر النجاح والأخطاء والتقارير.

هل تدعم API رسائل OTP والحملات؟+

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

ما الفرق بين API وSMPP؟+

HTTP API أبسط لمعظم التطبيقات، بينما SMPP يناسب عادة مزودي الرسائل والأحجام الكبيرة التي تحتاج اتصالاً دائماً وإدارة جلسات.

نموذج طلب الخدمة

حمّل قائمة أسعار الرسائل القصيرة

أدخل بياناتك وحجم الإرسال المتوقع لتحصل على قائمة الأسعار المناسبة لاستخدامك.

نستخدم بياناتك للتواصل معك بخصوص هذا الطلب.