WEBHOOK V2 · كل حدث من الأجهزة المحمولة يصل إلى برنامجك

حوّل كل حدث من جهازك المحمول المتصل إلى إجراء فوري.

SMSMobileAPI Webhook V2 يرسل أحداث HTTPS مُهيكلة إلى تطبيقاتك عندما يتم تقديم أو إرسال أو فشل أو استلام SMS، وعند تفويت مكالمة هاتفية أو ورودها أو خروجها، وعند حدوث نشاط مدعوم من WhatsApp أو البريد الإلكتروني. قم بتكوين كل شيء بصريًا من لوحة التحكم—لا حاجة إلى حلقة استعلام.

قم بتكوين Webhook V2 إنشاء حساب

اقرأ وثائق API

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

SMSمكالمةواتسابالبريد الإلكتروني

موقّع JSON

SMSMobileAPIويب هوكV2طابور أحداث دائم

مباشر

HTTPS POST

نظام إدارة علاقات العملاء (CRM)الدعمالأتمتةالتحليلات

حدث جوال → طابور دائم → تسليم HTTPS موقّع → سير عملك

15 نوعًا من الأحداث

يغطي SMS والمكالمات وWhatsApp والبريد الإلكتروني بأسماء أحداث دقيقة.

توجيه انتقائي

أرسل مجموعات أحداث مختلفة إلى وجهات HTTPS مختلفة.

تسليم موقّع

تحقّق من كل طلب باستخدام توقيع HMAC-SHA256 والطابع الزمني.

إعادة المحاولة الدائمة

يتم إعادة محاولة الفشل المؤقت للوجهة دون حجب الحسابات الأخرى.

كيف يعمل WEBHOOK V2

من حدث جوال حقيقي إلى تطبيقك في ثلاث خطوات واضحة.

جهازك المحمول المتصل وخدمات SMSMobileAPI تولّد أحداثًا تشغيلية. تقوم Webhook V2 بوضع كل حدث مؤهل في طابور توصيل دائم وترسل حمولة JSON موقعة إلى HTTPS URL التي اخترتها.

1
حدوث حدث
يُقدّم رسالة، أو يرسل أو يستقبل الجهاز المحمول SMS، أو تتغير حالة مكالمة، أو يُسجَّل نشاط مدعوم من WhatsApp أو البريد الإلكتروني.
2
Webhook V2 يقوم بالتوجيه
SMSMobileAPI ينشئ معرف حدث ثابتًا واحدًا ويضع في الطابور عملية توصيل فقط للوجهات المشتركة في ذلك النوع من الأحداث.
3
يتفاعل برنامجك
نقطة النهاية العامة لِـHTTPS تتحقق من التوقيع، تخزن معرف الحدث وتبدأ سير عمل إدارة علاقات العملاء، الدعم، التنبيهات أو الأتمتة لديك.

15 نوعًا دقيقًا من الأحداث

اشترك فقط في أحداث الأجهزة المحمولة التي يحتاجها سير عملك.

يمكن لوجهة واحدة استقبال كل شيء، أو يمكنك فصل أنظمة الإنتاج والتحليلات والتنبيهات التشغيلية. كل حدث له اسم دقيق حتى يتعامل تطبيقك معه بشكل متوقّع.

SMS

sms.api.submitted

تم تقديم SMS عبر API

أنشأ طلب API مهمة إرسال SMS. مفيد للاعتراف بأن الطلب دخل إلى المنصة.

sms.sent

تم إرسال SMS

أكد الجهاز المحمول المتصل عملية إرسال SMS.

sms.failed

فشل SMS

الهاتف المتصل أعاد خطأً أثناء إرسال SMS.

sms.received

SMS تم استلامه.

قام الهاتف المتصل بمزامنة SMS وارد.

sms.mobile.sent

SMS أُرسل من الهاتف.

تم إرسال SMS يدويًا من الهاتف المتصل.

المكالمات

call.missed

مكالمة فائتة

تمت مزامنة مكالمة فائتة من الهاتف المتصل.

call.incoming

مكالمة واردة

تمت مزامنة مكالمة واردة من الهاتف المتصل.

call.outgoing

مكالمة صادرة

تمت مزامنة مكالمة صادرة من الهاتف المتصل.

whatsapp.submitted

تم تقديم WhatsApp.

تم إنشاء مهمة لإرسال WhatsApp.

whatsapp.sent

WhatsApp تم إرساله.

بيئة WhatsApp المتصلة أكدت أن الرسالة أُرسلت.

whatsapp.failed

WhatsApp فشل.

عملية إرسال WhatsApp فشلت.

whatsapp.received

WhatsApp تم استلامه.

تم استرجاع رسالة WhatsApp بعد أن طلب الحساب المزامنة.

whatsapp.voice.transcribed

تم تحويل الرسالة الصوتية إلى نص.

تم تحويل رسالة WhatsApp الصوتية المؤهلة التي تم استرجاعها إلى نص قابل للاستخدام.

البريد الإلكتروني

email.sent

تم إرسال بريد إلكتروني.

تم إنشاء طلب إرسال بريد إلكتروني بواسطة SMSMobileAPI.

email.received

تم استلام بريد إلكتروني.

استلم صندوق بريد متصل رسالة إلكترونية.

قم بتكوين كل شيء بصريًا

إدارة ويب هوك احترافية دون تحرير ملفات التكوين.

افتح Webhook V2 في لوحة تحكم SMSMobileAPI، أضف اسم وجهة وHTTPS URL عامة، اختر الأحداث ثم احفظ. تمنحك لوحة التحكم عناصر التحكم اللازمة للتشغيل اليومي واستكشاف الأخطاء وإصلاحها.

✓

وجهات متعددة

أنشئ وجهات مخصصة لنظام CRM أو للمراقبة أو التحليلات أو تطبيقات العملاء.

✓

مرشحات الأحداث

اختر بدقة أي أحداث SMS والمكالمات وWhatsApp والبريد الإلكتروني التي يتلقاها كل URL.

✓

اختبار التسليم

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

✓

إيقاف مؤقت وإعادة التنشيط

أوقف وجهة فورًا دون حذف إعداداتها.

✓

تدوير المفاتيح السرية

أنشئ سر توقيع جديدًا عندما يتطلبه إجراء الأمان لديك.

✓

نشاط التسليم

راجع عمليات التسليم الموجودة في الطابور والمُسلَّمة وتلك قيد إعادة المحاولة والفاشلة مع معلومات المحاولة وحالة HTTP.

قم بتكوين Webhook V2

Webhook V23 نشطة

الوجهات3مُسلَّمة · 24 ساعة1,284قيد إعادة المحاولة2

بيئة الإنتاج لـ CRMhttps://crm.example.com/hooks/mobileنشط

sms.receivedcall.missedwhatsapp.received

تنبيهات العملياتhttps://ops.example.com/eventsنشط

sms.failedwhatsapp.failed

عناصر تحكم نموذجية في لوحة Webhook V2.

الموثوقية في صميم التصميم

مصمّم للتسليم الموثوق والمستقل.

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

قائمة انتظار دائمة

يتم تخزين الأحداث المؤهلة قبل التسليم بحيث لا تؤدي فترات التوقف المؤقت لدى المستلم إلى فقدان الحدث.

التسليم مرة واحدة على الأقل

قد تتم إعادة محاولة التسليم. خزّن معرّف الحدث وقم بمعالجته مرة واحدة فقط في تطبيقك.

إعادة المحاولة التدريجية

يُعاد محاولة حالات الفشل المؤقتة بفترات انتظار متزايدة، حتى حدّ إعادة المحاولة في المنصة.

عزل الفشل

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

حماية تلقائية

يمكن إيقاف وجهة تتعرض لفشل مستمر بشكل مؤقت لحماية قائمة الانتظار وبنيتك التحتية.

رؤية تشغيلية

تعرض لوحة التحكم ومراقبة مشرف الموقع حالة قائمة الانتظار والنتائج وأخطاء التسليم الأخيرة.

موقّع وقابل للتحقّق

تحقّق من الطلب قبل الوثوق بالحدث.

تشتمل كل عملية تسليم على طابع زمني، ومعرّف التسليم، ونوع الحدث، ومفتاح عدم التكرار الثابت وتوقيع HMAC-SHA256. احتفظ بسر التوقيع على خادمك، احسب التوقيع من جسم الطلب الخام، وارفض الطلبات غير الصالحة أو القديمة.

X-SMSMobileAPI-Eventنوع الحدث، مثل sms.received.X-SMSMobileAPI-Deliveryالمعرّف الفريد للتسليم لهذه الوجهة.X-SMSMobileAPI-Timestampالطابع الزمني بتنسيق Unix المستخدم أثناء التحقق من التوقيع.X-SMSMobileAPI-Signatureتوقيع HMAC-SHA256 للمقارنة بأمان.Idempotency-Keyمعرّف UUID ثابت للحدث يُستخدم لمنع المعالجة المكررة.

signature = HMAC-SHA256(

timestamp + "." + raw_body

)

اقرأ جسم الطلب الخام
تحقق من عمر الطابع الزمني
احسب التوقيع المتوقع
قارن التواقيع بأمان
تجنّب تكرار معرّف الحدث

غلاف حدث متسق

غلاف JSON متسق واحد لكل قناة.

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

id— معرّف حدث ثابت
type— نوع الحدث الدقيق
occurred_at— وقت حدوث النشاط
data— معلومات خاصة بالقناة

{
  "id": "whv2_01J...",
  "type": "sms.received",
  "api_version": "2026-09-22",
  "created_at": "2026-09-22T12:00:00Z",
  "occurred_at": "2026-09-22T11:59:58Z",
  "data": {
    "guid": "...",
    "from": "+32...",
    "message": "Can you call me back?"
  }
}

من الحدث إلى نتيجة تجارية

اجعل التواصل المحمول يؤدي إلى الإجراء التجاري التالي.

محادثات إدارة علاقات العملاء

أضف رسالة SMS أو WhatsApp المستلمة إلى جهة الاتصال الصحيحة ونبه المالك المعيّن.

التعامل مع المكالمات الفائتة

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

دعم العملاء

افتح أو حدّث تذكرة دعم عندما يرد العميل من جهازه المحمول.

عمليات التجارة الإلكترونية

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

المراقبة والتنبيهات

أرسل حالات فشل التسليم أو نشاط المكالمات غير المعتاد إلى أدوات المراقبة وإدارة الحوادث لديك.

تدفقات العمل الخاصة بالذكاء الاصطناعي والبيانات

زوّد تدفقات التصنيف أو التقارير أو المساعدة بالأحداث المصرح بها دون استدعاء API بشكل متكرر.

توقف عن الاستعلام المتكرر عن التغييرات

الاستطلاع يطلب بيانات بشكل متكرر، بينما الويبهوكس تُخطر برنامجك عند حدوث تغيير.

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

الاستطلاع

هل هناك حدث جديد؟طلبات متكررة · تأخير إضافي

WEBHOOK V2

الحدث

أعلمني عند حدوثه.حدث ذي صلة · تدفق عمل فوري

الأسئلة الشائعة حول Webhook V2

أسئلة قبل توصيل نقطة النهاية.

هل أحتاج لبناء حلقة استطلاع؟＋

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

هل يمكنني تكوين عدة عناوين URL للويبهوك؟＋

نعم. يمكنك إنشاء وجهات متعددة واختيار مجموعة أحداث مختلفة لكل منها، ضمن حدود الحساب المعروضة في لوحة التحكم.

كيف أعرف أنه تم إرسال SMS فعليًا؟＋

استخدم sms.api.submitted لمعرفة أنه تم إنشاء المهمة وsms.sent للحصول على التأكيد المبلغ عنه من الهاتف المتصل. اعتبرهما مرحلتين تشغيليتين مختلفتين.

هل يمكن تسليم الويبهوك أكثر من مرة؟＋

نعم. يستخدم Webhook V2 آلية تسليم "مرة على الأقل". احفظ معرف الحدث المستقر أو Idempotency-Key وتجاهل أي تسليم قد عالجته بالفعل.

ماذا يجب أن تُرجع نقطة النهاية الخاصة بي؟＋

أعد ردًا برمز 2xx الخاص بـ HTTP بعد قبول الحدث بأمان. يمكن أن تستمر المعالجة بشكل غير متزامن داخل تطبيقك.

هل تُجمَع أحداث WhatsApp المستلمة بشكل مستمر؟＋

لا. تتبع عملية استرداد الرسائل المستلمة عبر WhatsApp عملية تزامن قائمة على الموافقة الخاصة بها. يصبح حدث whatsapp.received متاحًا بعد استرداد رسالة مؤهلة.

أحداث هاتفك المحمول. برنامجك. إجراءاتك.

وصل برنامجك بنشاط هاتفك المحمول الفعلي الآن.

أنشئ حسابك أو سجّل الدخول، افتح Webhook V2، أضف وجهة HTTPS عامة واختر الأحداث المهمة لتدفق عملك. أرسل حدث اختبار، تحقق من توقيعه وفعل تكاملَك.

قم بتكوين Webhook V2 إنشاء حساب اقرأ وثائق API