تكوين إعدادات الويب هوك (Webhook) لواجهة برمجة تطبيقات SMS للجوال

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

لماذا يعد تتبع التسليم في الوقت الفعلي مهماً للشركات المحلية

بالنسبة للشركات المحلية — مثل عيادات طب الأسنان، وورش إصلاح السيارات، والصالونات — تعد الرسائل النصية القصيرة (SMS) الطريقة الأكثر فعالية للتواصل. إن إرسال تأكيدات المواعيد، أو إشعارات "جاهز للاستلام"، أو تحديثات الجدول الزمني يحافظ على سير العمليات بسلاسة. ومع ذلك، فإن إرسال الرسالة هو نصف المعركة فقط؛ فأنت بحاجة إلى معرفة ما إذا كانت قد وصلت بالفعل إلى هاتف العميل. قد تعني الرسالة الفاشلة موعداً فائتاً أو طلباً لم يتم استلامه، مما يكلف عملك الوقت والمال.

تجعل واجهات برمجة تطبيقات SMS التقليدية مثل Twilio أو Plivo تتبع التسليم أمراً صعباً ومكلفاً. فهي تفرض رسوماً عليك مقابل كل جزء مكون من 160 حرفاً، وتجبرك على الخضوع لأسابيع من التسجيل المعقد لنظام A2P 10DLC، وتفرض رسوماً شهرية لمجرد الحفاظ على نشاط الرقم الافتراضي. وإذا فشلت الرسالة بسبب تصفية شركة الاتصالات أو رقم غير صالح، فستظل تدفع ثمنها.

من خلال استخدام بوابة SMS مقابل واجهة برمجة تطبيقات SMS التي تحول هاتف Android الخاص بك إلى جهاز إرسال، فإنك تتجاوز هذه القيود تماماً. يمكنك إرسال الرسائل من رقم هاتفك المحمول المعروف باستخدام باقة بطاقة SIM الحالية لديك. ولجعل هذا الإعداد مؤتمتاً بالكامل، يجب عليك تكوين إعدادات الويب هوك (webhook) الخاصة بك حتى يتم إشعار نظامك الخلفي فوراً عند إرسال رسالة أو تسليمها أو فشلها.

مشكلة واجهات برمجة تطبيقات الاستطلاع (Polling APIs)

بدون الويب هوك، يتعين على تطبيقك "استطلاع" خوادم بوابة SMS باستمرار للسؤال: "هل تم تسليم الرسالة ذات المعرف 9876 بعد؟" هذا يهدر النطاق الترددي للخادم، ويزيد من زمن الاستجابة، ويبطئ تطبيقك. تحل الويب هوك هذه المشكلة عن طريق دفع تحديث الحالة إلى خادمك في نفس الملي ثانية التي تتغير فيها على جهاز المحمول.

كيف يحل توجيه رسائل SMS المستند إلى Android مشكلة تصفية شركات الاتصالات

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

فهم إعدادات الويب هوك لواجهة برمجة تطبيقات SMS للجوال وكيفية عملها

الويب هوك هي في الأساس "واجهات برمجة تطبيقات عكسية". فبدلاً من قيام خادمك بتقديم طلب إلى MySMSGate، يقوم MySMSGate بتقديم طلب HTTP POST إلى خادمك. عندما ترسل رسالة SMS عبر REST API أو لوحة تحكم الويب الخاصة بك، يتم وضع الرسالة في قائمة الانتظار وإرسالها إلى هاتف Android المتصل بك. بمجرد أن يقوم نظام تشغيل الهاتف بنقل الرسالة وتلقي تقرير الحالة من شبكة الهاتف المحمول، فإنه ينقل هذه الحالة مرة أخرى إلى MySMSGate، والذي يقوم على الفور بتشغيل الويب هوك الخاص بك.

لمعالجة هذه الإشعارات الواردة، تحتاج إلى تكوين إعدادات الويب هوك لواجهة برمجة تطبيقات SMS للجوال في لوحة تحكم المطورين الخاصة بك. يتطلب ذلك تحديد عنوان URL للوجهة على خادمك يكون جاهزاً لقبول حمولات JSON الواردة.

فيما يلي مثال على حمولة JSON التي يرسلها MySMSGate إلى عنوان URL الخاص بالويب هوك عندما تتغير حالة الرسالة:

{
  "message_id": "msg_987654321",
  "status": "delivered",
  "phone_number": "+447700900077",
  "device_id": "dev_android_01",
  "sim_slot": 1,
  "sent_at": "2026-07-08T14:30:15Z",
  "delivered_at": "2026-07-08T14:30:18Z",
  "error_code": null,
  "cost": 0.02
}

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

كيفية تكوين إعدادات الويب هوك لواجهة برمجة تطبيقات SMS للجوال في MySMSGate

إن إعداد تكامل الويب هوك الخاص بك أمر مباشر ولا يتطلب أي موافقات معقدة من شركات الاتصالات. اتبع هذه الخطوات لتكوين بيئتك:

1. إنشاء حسابك: سجل في MySMSGate. لا تحتاج إلى بطاقة ائتمان للبدء، ولا توجد رسوم اشتراك شهرية.
2. ربط هاتف Android الخاص بك: قم بتنزيل تطبيق MySMSGate لنظام Android على جهازك. افتح لوحة تحكم الويب، وامسح رمز QR المعروض باستخدام التطبيق، وسيتصل هاتفك على الفور. لا يتطلب إدخال مفتاح API يدوياً.
3. إعداد نقطة النهاية المستلمة: أنشئ عنوان URL عاماً على خادمك الخلفي (على سبيل المثال، https://api.yourdomain.com/v1/sms-webhook) يقبل طلبات HTTP POST.
4. تكوين إعدادات الويب هوك: انتقل إلى علامة تبويب إعدادات المطور (Developer Settings) في لوحة تحكم MySMSGate. الصق عنوان URL لنقطة النهاية في حقل "Webhook URL" ضمن إعدادات الويب هوك لواجهة برمجة تطبيقات SMS للجوال الخاصة بك.
5. تحديد أحداث التشغيل (Trigger Events): اختر الأحداث التي يجب أن تشغل الويب هوك. تمكن معظم الشركات أحداث "تم إرسال الرسالة"، و"تم تسليم الرسالة"، و"فشلت الرسالة"، و"تم استلام رسالة واردة".
6. اختبار الاتصال: انقر فوق الزر "إرسال حمولة تجريبية" للتحقق من أن خادمك يستقبل بيانات JSON ويعالجها بشكل صحيح.

بمجرد التكوين، ستقوم أي رسالة معاملات يتم إرسالها عبر واجهة برمجة التطبيقات أو لوحة تحكم المحادثات على الويب بالإبلاغ تلقائياً عن حالتها إلى نظامك في الوقت الفعلي.

التعامل مع الأجهزة ثنائية الشريحة (Dual SIM)

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

دليل المطور: معالجة الويب هوك في نظامك الخلفي

عند دمج ميزات SMS في تطبيقاتك المخصصة أو منصات SaaS، فأنت بحاجة إلى وحدة تحكم خلفية (backend controller) قوية لمعالجة أحداث الويب هوك الواردة. يُعتبر MySMSGate على نطاق واسع بوابة SMS لنظام Android تتكامل بسهولة مع لغات البرمجة الخلفية الحديثة.

فيما يلي أمثلة برمجية نظيفة وعملية بلغتي Node.js و Python لمساعدتك في معالجة استدعاءات الويب هوك وتحديث قاعدة بياناتك في الوقت الفعلي.

مثال على مستقبل ويب هوك في Node.js (Express)

const express = require('express');
const app = express();

// Middleware to parse JSON payloads
app.use(express.json());

app.post('/v1/sms-webhook', (req, res) => {
  const { message_id, status, phone_number, error_code } = req.body;

  console.log(`Received status update for ${message_id}: ${status}`);

  if (status === 'delivered') {
    // Update your database: Mark appointment reminder as confirmed
    console.log(`SMS successfully delivered to ${phone_number}`);
  } else if (status === 'failed') {
    // Handle failure: Alert staff or try alternative communication channel
    console.error(`SMS to ${phone_number} failed with error: ${error_code}`);
  }

  // Always return a 200 OK to acknowledge receipt of the webhook
  res.status(200).send({ received: true });
});

app.listen(3000, () => console.log('SMS Webhook server running on port 3000'));

مثال على مستقبل ويب هوك في Python (Flask)

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/v1/sms-webhook', methods=['POST'])
def sms_webhook():
    data = request.json
    message_id = data.get('message_id')
    status = data.get('status')
    phone_number = data.get('phone_number')
    
    print(f"Webhook event: Message {message_id} is now {status}")
    
    if status == 'delivered':
        # Code to update your local database
        pass
    elif status == 'failed':
        # Code to handle delivery failures and trigger alerts
        pass
        
    return jsonify({"status": "success"}), 200

if __name__ == '__main__':
    app.run(port=3000)

مقارنة تتبع التسليم: MySMSGate مقابل البوابات التقليدية

عند البحث عن أفضل واجهة برمجة تطبيقات SMS لتكامل تطبيقات الهاتف المحمول في عام 2026، غالباً ما تكون التكلفة والعقبات الإدارية هي العوامل الحاسمة. تفرض منصات الاتصالات السحابية التقليدية لوائح صارمة ورسوماً خفية تجعلها غير عملية للشركات المحلية الصغيرة والمتوسطة.

يوضح الجدول أدناه الاختلافات بين MySMSGate ومزودي خدمة SMS التجاريين التقليديين:

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

الأسئلة الشائعة

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

ما هي واجهة برمجة تطبيقات SMS منخفضة التكلفة التي تدعم الويب هوك؟

يُعد MySMSGate واجهة برمجة تطبيقات SMS اقتصادية للغاية تفرض رسوماً ثابتة تبلغ 0.02 دولار لكل رسالة دون رسوم اشتراك شهرية أو عقود. وهو يدعم بالكامل تكامل الويب هوك في الوقت الفعلي، مما يسمح للمطورين بتلقي تحديثات تسليم فورية على خوادمهم الخاصة دون دفع ثمن أرقام هواتف افتراضية مكلفة.

هل أحتاج إلى التسجيل في نظام A2P 10DLC لتلقي ويب هوك لتسليم رسائل SMS؟

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

كيف يتعامل MySMSGate مع عمليات استرداد الأموال للرسائل الفاشلة؟

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

هل يمكنني استخدام شريحتين (Dual SIM) مع ويب هوك MySMSGate؟

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