Webhook SMS: كيفية إرسال وتتبع رسائل SMS باستخدام الويب هوك

تعتمد أتمتة الأعمال الحديثة على الاتصالات الفورية، وتعتبر برمجيات الويب هوك (webhooks) بمثابة الغراء الذي يربط برامجك بالعالم الحقيقي. في هذا الدليل الشامل، سنستكشف كيفية تنفيذ رسائل Webhook SMS لتشغيل الرسائل النصية الصادرة وتتبع حالة تسليمها في الوقت الفعلي، مما يساعدك على بناء سير عمل اتصالات مؤتمت وسلس.

ما هو SMS Webhook وكيف يعمل؟

إذا كنت تقوم ببناء نظام مؤتمت لعملك، فمن المحتمل أنك واجهت مصطلح webhook. ولكن ما هي تقنية sms webhook، وكيف تنطبق على إرسال الرسائل النصية؟ ببساطة، الويب هوك (webhook) هو استدعاء HTTP (HTTP callback): رسالة مؤتمتة يتم إرسالها من تطبيق إلى آخر عند حدوث شيء ما. في سياق رسائل SMS، تعمل الويب هوك في اتجاهين متميزين: محفزات الصادر وتحديثات الحالة الواردة.

أولاً، هناك عملية إرسال ويب هوك لتشغيل رسالة قصيرة (sending a webhook to trigger an sms). عندما يقع حدث ما في نظام إدارة علاقات العملاء (CRM)، أو برنامج الحجز، أو قاعدة البيانات الخاصة بك — مثل قيام عميل بحجز موعد طبيب أسنان أو قيام ورشة إصلاح سيارات بتحديد مركبة على أنها "جاهزة للاستلام" — يرسل نظامك طلب HTTP POST (ويب هوك) إلى بوابة SMS. تستقبل البوابة هذه البيانات وترسل الرسالة النصية فوراً إلى المستلم.

ثانياً، تُستخدم برمجيات الويب هوك لتتبع التسليم في الوقت الفعلي. عندما ترسل رسالة SMS، فأنت بحاجة إلى معرفة ما إذا كانت قد وصلت بالفعل إلى هاتف العميل. بدلاً من الاستعلام المستمر من واجهة برمجة التطبيقات (API) للتحقق من الحالة، يمكنك إعداد عنوان URL للويب هوك في مجمع رسائل SMS الخاص بك (set up webhook url in your sms aggregator). بمجرد تسليم الرسالة (أو فشلها)، يرسل المجمع ويب هوك مجدداً إلى خادمك مع حالة التسليم. يتيح ذلك لنظامك تحديث لوحة التحكم الخاصة به على الفور، أو إطلاق متابعات، أو معالجة عمليات استرداد الأموال للرسائل الفاشلة.

الفرق بين واجهة برمجة تطبيقات رسائل SMS (SMS API) والويب هوك (SMS Webhook)

على الرغم من أنهما مرتبطان ارتباطاً وثيقاً، إلا أن واجهة برمجة تطبيقات SMS (SMS API) والويب هوك (SMS Webhook) يخدمان أنماط اتصال متعاكسة. تعتمد واجهة برمجة التطبيقات (API) على السحب (pull-based): حيث يبدأ خادمك طلباً إلى بوابة SMS لتنفيذ إجراء ما (مثل إرسال رسالة). بينما يعتمد الويب هوك على الدفع (push-based): حيث تبدأ بوابة SMS طلباً إلى خادمك لإعلامك بحدث ما (مثل إيصال التسليم أو رسالة واردة). يعد فهم هذا الاختلاف أمراً بالغ الأهمية عند تصميم سير عمل مؤتمت وموثوق. لمزيد من التفاصيل حول هذه الاختلافات الهيكلية، اقرأ دليلنا المفصل مقارنة بين بوابة SMS وواجهة برمجة تطبيقات SMS.

كيفية إعداد عنوان URL للويب هوك في مجمع رسائل SMS الخاص بك

لتلقي تحديثات في الوقت الفعلي حول رسائلك المرسلة، يجب عليك تهيئة نظامك للاستماع إلى الويب هوك الواردة. تختلف عملية تهيئة ويب هوك SMS (configurar sms webhook) قليلاً اعتماداً على المزود الخاص بك، ولكن الخطوات الأساسية تظل متطابقة في جميع أنحاء الصناعة.

أولاً، تحتاج إلى عنوان URL متاح للعامة على خادمك يمكنه استقبال طلبات HTTP POST. أثناء التطوير المحلي، قد تستخدم منفذ تطوير محلي، مما ينتج عنه نقطة نهاية مثل POST http://localhost:5678/webhook/sms. وفي بيئة الإنتاج، سيكون هذا عنوان URL عاماً وآمناً مستضافاً على بنيتك التحتية، أو دالة بدون خادم (serverless function) مثل https://sms-webhook.956312457.workers.dev/smswebhook.

بمجرد أن تصبح نقطة النهاية جاهزة، تقوم بتسجيل عنوان URL هذا في لوحة تحكم المطورين الخاصة ببوابة SMS الخاصة بك. من تلك اللحظة فصاعداً، في كل مرة تتغير فيها حالة رسالة SMS (على سبيل المثال، من "sent" إلى "delivered" أو "failed")، ستُرسل البوابة حمولة JSON إلى عنوان URL المسجل الخاص بك. فيما يلي مثال على الحمولة القياسية التي ستتلقاها من MySMSGate:

{
  "message_id": "msg_987654321",
  "status": "delivered",
  "phone": "+447700900077",
  "error_code": null,
  "timestamp": "2026-06-28T14:30:00Z"
}

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

إرسال رسائل SMS عبر الويب هوك: سير العمل للمطورين وبدون كود

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

في الأسواق الناطقة بالفرنسية، غالباً ما يبحث المشغلون عن webhook qui lance des sms (ويب هوك يقوم بإطلاق/تشغيل رسائل SMS). هذا المفهوم قابل للتطبيق عالمياً. من خلال تهيئة نظام CRM أو تطبيق الويب الخاص بك لإرسال ويب هوك إلى MySMSGate، يمكنك إخطار العملاء على الفور دون أي تدخل يدوي.

تكامل المطورين: إرسال رسائل SMS عبر واجهة برمجة تطبيقات REST API

بالنسبة للمطورين، فإن تشغيل رسالة SMS بسيط للغاية مثل إجراء طلب POST واحد إلى نقطة نهاية واجهة برمجة تطبيقات MySMSGate. فيما يلي مثال عملي على curl يوضح كيفية إرسال رسالة SMS باستخدام مفتاح واجهة برمجة التطبيقات (API key) الخاص بك:

curl -X POST https://mysmsgate.net/api/v1/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900077",
    "message": "Your vehicle is ready for pickup at AutoRepair Pro. Total: £120. Open until 6 PM."
  }'

توجه هذه الحمولة البسيطة هاتف Android المتصل لإرسال رسالة SMS مباشرة من خلال بطاقة SIM الفعلية الخاصة به. إذا كنت تقوم ببناء واجهة خلفية مخصصة، يمكنك العثور على أمثلة كاملة للأكواد بلغات Python وNode.js وPHP وGo وRuby في وثائق واجهة برمجة التطبيقات (API documentation) الخاصة بنا.

الأتمتة بدون كود: معالجة المستندات وتشغيل رسائل SMS

بالنسبة لمشغلي الأعمال غير التقنيين، تتيح لك منصات مثل Zapier وMake.com وn8n بناء سير عمل معقد بشكل مرئي. على سبيل المثال، قد تستخدم مدرسة لغات محلية أو مركز تعليمي سير عمل لتسجيل الطلاب الجدد وتأكيد تسجيلهم عبر رسائل SMS.

فكر في سير عمل متقدم: 利用 webhook 节点 接收来自手机应用/小程序上传的 .docx 文件，记得开启 “binary data” 选项 (باستخدام عقدة ويب هوك لاستقبال ملفات docx. المرفوعة من تطبيق جوال/برنامج صغير، مع تذكر تمكين خيار "البيانات الثنائية - binary data"). عندما يقوم الطالب برفع اتفاقية التسجيل الموقعة كملف docx.، تستقبل عقدة الويب هوك الملف. بعد ذلك، تستخدم عقدة استخراج المستندات (مثل Power Document Extractor) لاستخراج اسم الطالب ورقم هاتفه من المستند. أخيرًا، تقوم بتمرير هذه البيانات إلى عقدة MySMSGate لإرسال رسالة تأكيد مخصصة عبر SMS: "مرحباً [Name]، لقد استلمنا اتفاقيتك الموقعة! تبدأ فصولك الدراسية يوم الاثنين القادم."

مقارنة بين مزودي خدمات ويب هوك SMS: منصة MySMSGate مقابل البوابات التقليدية

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

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

يقارن الجدول أدناه بين MySMSGate وبوابات رسائل SMS السحابية التقليدية لشركة خدمات محلية نموذجية ترسل 500 رسالة تشغيلية شهرياً:

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

شرح خطوة بخطوة: إعداد ويب هوك SMS مع MySMSGate

يعد إعداد نظام SMS مؤتمت مع MySMSGate أمراً بسيطاً ولا يتطلب بنية تحتية معقدة. اتبع هذه الخطوات لتوصيل هاتف Android الخاص بك والبدء في إرسال الرسائل عبر الويب هوك.

الخطوة 1: إنشاء حسابك وتنزيل التطبيق

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

الخطوة 2: توصيل هاتفك عبر رمز QR

افتح لوحة تحكم MySMSGate على الويب حيث سترى رمز QR فريداً للإعداد. افتح تطبيق Android على هاتفك وامسح رمز QR هذا ضوئياً. تم الآن ربط هاتفك بحسابك بشكل آمن. يمكنك توصيل هواتف متعددة لإدارة فروع العمل المختلفة أو أرقام الهواتف من لوحة تحكم مركزية واحدة.

الخطوة 3: إرسال رسالة SMS وتهيئة ويب هوك التسليم

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

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

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

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

ما هو ويب هوك SMS (SMS webhook)؟

ويب هوك SMS هو استدعاء HTTP تلقائي يقوم بتشغيل إجراء عند وقوع حدث متعلق برسائل SMS. يُستخدم إما لإرسال رسالة نصية تلقائياً عند حدوث حدث في نظام إدارة علاقات العملاء (CRM)، أو لتلقي تحديثات حالة التسليم في الوقت الفعلي من بوابة SMS الخاصة بك عندما يتم تسليم رسالة أو تفشل.

هل أحتاج إلى موافقة المشغل أو تسجيل 10DLC لاستخدام MySMSGate؟

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

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

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

هل يمكنني استخدام الويب هوك مع أدوات غير المطورين مثل Zapier أو Make؟

نعم، بالتأكيد. تتكامل MySMSGate بسلاسة مع منصات الأتمتة الشهيرة بدون كود مثل Zapier وMake.com وn8n. يمكنك إعداد سير عمل حيث يقوم ويب هوك من نظام الحجز الخاص بك، أو نموذج الويب، أو نظام CRM بتشغيل إشعار SMS تلقائياً دون كتابة سطر كود واحد.