كيفية إنشاء خادم SMS OTP بدون Twilio

لا ينبغي أن يتطلب بناء مسار آمن للتحقق من المستخدمين التنقل بين موافقات شركات الاتصالات التي لا تنتهي أو دفع أسعار باهظة لكل رسالة. في هذا البرنامج التعليمي، سنوضح لك كيفية إنشاء خادم SMS OTP باستخدام هاتف Android الخاص بك وخلفية برمجية محلية، متجاوزًا التكاليف الباهظة والروتين الإداري لمزودي خدمات A2P SMS التقليديين.

لماذا تقوم ببناء خادم SMS OTP مخصص؟

عندما يبحث المطورون عن أفضل واجهات برمجة التطبيقات (APIs) للمكالمات الصادرة والرسائل النصية القصيرة من الأنظمة الخلفية، غالبًا ما يتم توجيههم إلى شركات الاتصالات العملاقة التقليدية مثل Twilio أو Vonage أو MessageBird. ومع ذلك، بالنسبة للمطورين المستقلين، والشركات الناشئة، وأصحاب الأعمال الصغيرة خارج الولايات المتحدة، أصبحت هذه المنصات غير عملية بشكل متزايد. فبين التسجيل الإلزامي لـ 10DLC، ورسوم فحص شركات الاتصالات، وعمليات الإعداد المعقدة، قد يستغرق مجرد إرسال رمز التحقق لمرة واحدة (OTP) أسابيع من العمل الإداري.

علاوة على ذلك، تفرض بوابات الرسائل التقليدية رسومًا لكل جزء مكون من 160 حرفًا وتتقاضى رسومًا أساسية مرتفعة. إذا كنت تبني خدمة محلية — مثل نظام حجز للعيادات، أو بوابة لمدرسة تعليم القيادة، أو متتبع للحضور — فأنت بحاجة إلى low cost sms api تعمل ببساطة وبدون تعقيد. من خلال تعلم كيفية إنشاء بوابة رسائل قصيرة خاصة بك باستخدام هاتف Android، فإنك تتجنب تسجيل شركات الاتصالات تمامًا وترسل الرسائل مباشرة من رقم يعرفه عملاؤك بالفعل.

مقارنة بين واجهات برمجة تطبيقات SMS التقليدية وبوابة MySMSGate لنظام Android

فيما يلي مقارنة مباشرة لما يتطلبه إرسال رسائل المعاملات (transactional SMS) ورموز التحقق (OTPs) من خلال واجهات برمجة التطبيقات التقليدية مقابل استخدام بوابة تعتمد على نظام Android مثل MySMSGate.

الخطوة 1: إنشاء حساب وتسجيل الدخول إلى تطبيق MySMSGate

لتحويل جهاز Android إلى بوابة رسائل قصيرة قابلة للبرمجة، تحتاج إلى خدمة وسيطة تربط الكود البرمجي الخلفي بنظام تشغيل Android. وهنا يأتي دور MySMSGate.

أولاً، توجه إلى صفحة التسجيل في MySMSGate لإنشاء حسابك المجاني. بمجرد تسجيل الدخول، ستظهر لك مفتاح واجهة برمجة التطبيقات (API key) ورمز QR فريد على لوحة التحكم الخاصة بك. يغنيك رمز QR هذا عن الحاجة إلى نسخ ولصق بيانات اعتماد API الطويلة يدويًا على جهازك المحمول.

بعد ذلك، قم بتنزيل تطبيق Android المصاحب على هاتفك. افتح التطبيق، واختر خيار مسح رمز QR الخاص بالإعداد، ووجّه الكاميرا نحو شاشة الكمبيوتر. سيقوم التطبيق بتهيئة نفسه تلقائيًا، وإنشاء اتصال آمن عبر إشعارات الدفع (push notifications) للبقاء نشطًا في وضع السكون، وربط فتحات شريحة SIM الفعلية بلوحة تحكم المطور الخاصة بك. أنت الآن جاهز لتوجيه الرسائل البرمجية عبر هاتفك.

الخطوة 2: إعداد أجهزتك (الهاتف والكمبيوتر الصغير)

يتساءل العديد من المطورين: كيف يمكنني إنشاء واجهة برمجة تطبيقات SMS خاصة بي محليًا باستخدام هاتف وجهاز كمبيوتر صغير؟ إن بنية الأجهزة لخادم OTP محلي مستضاف ذاتيًا بسيطة ومرنة للغاية. لا تحتاج إلى رفوف خوادم باهظة الثمن؛ يكفي استخدام كمبيوتر صغير أساسي (مثل Intel NUC أو Raspberry Pi) يعمل بنظام التشغيل Linux، مقترنًا بهاتف Android احتياطي.

قم بتوصيل جهاز الكمبيوتر الصغير بشبكتك المحلية. سيستضيف هذا الكمبيوتر الصغير قاعدة بيانات تطبيقك الأساسية ومنطق الخلفية البرمجية (مثل Node.js أو Python أو Go). لا يحتاج هاتف Android إلى أن يكون متصلاً ماديًا بالكمبيوتر الصغير عبر كابل USB. نظرًا لأن MySMSGate يتعامل مع الاتصالات عبر خطافات الويب (webhooks) ونقاط نهاية API الآمنة المستندة إلى السحابة، فإن هاتفك يحتاج فقط إلى اتصال مستقر بالإنترنت عبر Wi-Fi أو بيانات الهاتف. يتيح لك ذلك وضع الهاتف في منطقة ذات تغطية خلوية ممتازة، حتى لو كان الكمبيوتر الصغير الخاص بك موضوعًا داخل خزانة الخوادم.

الاستفادة من دعم الشريحة المزدوجة والأجهزة المتعددة

إذا كنت تدير نشاطًا تجاريًا له فروع متعددة، أو إذا كنت ترغب في فصل رسائل OTP الخاصة بالمعاملات عن التنبيهات التسويقية، فيمكنك ربط عدد غير محدود من هواتف Android بحساب MySMSGate واحد. وإذا كان هاتفك يدعم شريحتين (dual SIM)، فإن المنصة تتيح لك تحديد فتحة الشريحة التي تريد الإرسال منها برمجيًا لكل مكالمة API صادرة، مما يمنحك تحكمًا كاملاً في التوجيه وأسعار شركات الاتصالات المحلية.

الخطوة 3: كتابة كود خادم OTP

الآن بعد توصيل أجهزتك، يمكنك كتابة منطق الخلفية البرمجية لإنشاء كلمات المرور لمرة واحدة وتخزينها وإرسالها. فيما يلي مثال كامل وخفيف الوزن باستخدام Node.js يوضح كيفية إنشاء رمز OTP آمن مكون من 6 أرقام، وتخزينه في الذاكرة مع طابع زمني لانتهاء الصلاحية، وإرساله عبر واجهة برمجة تطبيقات MySMSGate REST API.

const axios = require('axios');

// In-memory store for demonstration (use Redis in production)
const otpCache = new Map();

const MYSMSGATE_API_URL = 'https://mysmsgate.net/api/v1/send';
const API_KEY = 'YOUR_MYSMSGATE_API_KEY';

async function generateAndSendOTP(phoneNumber) {
  // Generate a cryptographically secure 6-digit code
  const otp = Math.floor(100000 + Math.random() * 900000).toString();
  const expiresAt = Date.now() + 5 * 60 * 1000; // 5 minutes expiry

  // Store OTP details
  otpCache.set(phoneNumber, { otp, expiresAt });

  // Prepare payload for MySMSGate API
  const payload = {
    to: phoneNumber,
    message: `Your verification code is ${otp}. It will expire in 5 minutes.`
  };

  try {
    const response = await axios.post(MYSMSGATE_API_URL, payload, {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    });
    console.log('OTP dispatched successfully:', response.data);
    return { success: true };
  } catch (error) {
    console.error('Failed to dispatch OTP via MySMSGate:', error.response ? error.response.data : error.message);
    return { success: false, error: 'SMS gateway communication failure' };
  }
}

يتطلب هذا التكامل البسيط مع REST API طلب POST واحدًا فقط لإرسال الرسالة. لا توجد حزم SDK معقدة تحتاج إلى صيانة، مما يسهل نقل هذا المنطق إلى لغات أخرى مثل Python أو Go أو PHP أو Ruby باستخدام مستندات التكامل القياسية الخاصة بنا.

الخطوة 4: إضافة التحقق وتتبع الويب هوك (Webhook)

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

function verifyOTP(phoneNumber, userSubmittedCode) {
  const record = otpCache.get(phoneNumber);
  if (!record) {
    return { verified: false, reason: 'No OTP requested or code expired' };
  }

  if (Date.now() > record.expiresAt) {
    otpCache.delete(phoneNumber);
    return { verified: false, reason: 'OTP has expired' };
  }

  if (record.otp === userSubmittedCode) {
    otpCache.delete(phoneNumber); // Clear code after successful use
    return { verified: true };
  } 

  return { verified: false, reason: 'Incorrect code' };
}

لمراقبة حالة التسليم في الوقت الفعلي، قم بتهيئة عنوان URL للويب هوك (webhook) في لوحة تحكم MySMSGate الخاصة بك. عندما يرسل هاتف Android الرسالة ويتلقى إشعار تسليم من شبكة الاتصالات، سيقوم MySMSGate بإرسال تحديث الحالة إلى خادمك المحلي. وإذا فشل تسليم الرسالة بسبب رقم غير صالح أو خطأ من شركة الاتصالات، فسيتم استرداد رسوم واجهة برمجة التطبيقات تلقائيًا إلى رصيد حسابك، مما يضمن عدم دفعك مقابل محاولات التحقق غير المسلمة.

توسيع الخادم: تتبع الحضور والتنبيهات

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

من خلال ربط كشك تسجيل الدخول أو ورقة الحضور الرقمية بالخلفية البرمجية للكمبيوتر الصغير، يمكنك إرسال تنبيهات تلقائية صادرة. عندما يمسح الطالب بطاقة هويته أو يسجل حضوره، يمكن لنظامك الاتصال فورًا بواجهة برمجة تطبيقات MySMSGate لإرسال رسالة مخصصة: "مرحبًا، لقد وصل طفلك بأمان إلى مركز التدريس في تمام الساعة 3:15 مساءً."

وبالمثل، يمكن للأنشطة الخدمية المحلية مثل ورش إصلاح السيارات، وعيادات الأسنان، وصالونات التجميل استخدام هذا الإعداد لـ إنشاء قوالب تنبيهات SMS لتأكيدات الحجز، وتذكيرات المواعيد، وإشعارات "جاهز للاستلام". وبما أنك ترسل هذه التنبيهات من شريحة SIM الخاصة بك، يمكن للعملاء الرد مباشرة على الرسائل النصية. يتم توجيه هذه الردود مرة أخرى إلى لوحة تحكم MySMSGate الخاصة بك في الوقت الفعلي، مما يتيح لك إجراء محادثات ثنائية الاتجاه مباشرة من متصفحك دون الحاجة إلى الإمساك بهاتفك.

الأسئلة الشائعة (FAQ)

اعثر على إجابات للأسئلة الأكثر شيوعًا حول بناء بوابة رسائل SMS المحلية وخادم OTP الخاص بك.

كيف يمكنني إنشاء واجهة برمجة تطبيقات SMS خاصة بي محليًا باستخدام هاتف وجهاز كمبيوتر صغير؟

لإرسال رسائل SMS عبر واجهة برمجة تطبيقات محلية، قم بإعداد كمبيوتر صغير (مثل Raspberry Pi أو Intel NUC) يقوم بتشغيل الخلفية البرمجية لتطبيقك، واقرنه بهاتف Android يقوم بتشغيل تطبيق MySMSGate. يقوم الكمبيوتر الصغير بإنشاء محتوى الرسالة وإرساله إلى نقطة نهاية MySMSGate REST API. تقوم البوابة السحابية بتوجيه الطلب إلى هاتف Android المتصل عبر إشعارات الدفع الآمنة، وتقوم شريحة SIM الفعلية في الهاتف بإرسال الرسالة محليًا.

هل أحتاج إلى موافقة شركة الاتصالات أو تسجيل 10DLC لإرسال رموز التحقق (OTPs)؟

لا. نظرًا لأن MySMSGate يوجه الرسائل عبر هاتف Android وشريحة SIM الشخصية أو التجارية الخاصة بك، فلن تحتاج إلى التسجيل في A2P 10DLC، أو الخضوع للتحقق من العلامة التجارية، أو انتظار موافقات شركات الاتصالات. يمكنك البدء في إرسال تنبيهات المعاملات ورموز التحقق فورًا بعد إعداد التطبيق.

كيف يتعامل MySMSGate مع فشل تسليم الرسائل القصيرة؟

إذا فشل تسليم الرسالة بسبب مشاكل في الشبكة، أو رقم هاتف غير صالح، أو نقص رصيد شريحة SIM الخاصة بك، فإن MySMSGate يتتبع حالة الفشل عبر الويب هوك (webhooks) ويعيد تلقائيًا رسوم واجهة برمجة التطبيقات البالغة $0.02 إلى رصيد حسابك. أنت تدفع فقط مقابل الرسائل التي يتم إرسالها بنجاح من جهازك.

هل يمكنني استخدام شريحتين (dual SIM) لتوجيه رسائل OTP؟

نعم. يدعم تطبيق MySMSGate لنظام Android الأجهزة ثنائية الشريحة بالكامل. عند إجراء طلب POST إلى واجهة برمجة التطبيقات الخاصة بنا، يمكنك تحديد فتحة الشريحة (SIM 1 أو SIM 2) التي يجب استخدامها لإرسال الرسالة برمجيًا، مما يتيح لك تحسين التوجيه بناءً على أسعار شركات الاتصالات المحلية.