إعداد بوابة الرسائل ثنائية الاتجاه

يوفر هذا الدليل تعليمات خطوة بخطوة لتهيئة عناوين URL الخاصة بـ webhook في بوابات الرسائل القصيرة المختلفة لتمكين المراسلة ثنائية الاتجاه مع إضافة WSMS Two-Way.

قبل البدء

1. ثبّت وفعّل إضافة Two-Way SMS
2. انتقل إلى SMS Two Way → Settings (أو SMS → Settings → Two Way) للعثور على عنوان URL الخاص بـ webhook:

https://yourdomain.com/wp-json/wp-sms-two-way/v1/webhook?wpsms_token=YOUR_TOKEN

3. انسخ هذا العنوان — ستحتاجه لتهيئة البوابة

تهيئة البوابات

Twilio

1. سجّل الدخول إلى Twilio Console
2. انتقل إلى Phone Numbers → Manage → Active Numbers
3. انقر على رقم هاتفك
4. مرر لأسفل إلى Messaging Configuration
5. تحت A MESSAGE COMES IN، اختر Webhook
6. الصق عنوان URL الخاص بـ webhook
7. اضبط طريقة HTTP على POST
8. انقر على Save

Plivo

1. سجّل الدخول إلى Plivo Console
2. انتقل إلى Messaging → Applications
3. انقر على Add New Application
4. أدخل اسم التطبيق (مثال: “WSMS Two-Way”)
5. في Message URL، الصق عنوان URL الخاص بـ webhook
6. اضبط الطريقة على POST
7. انقر على Create Application
8. انتقل إلى Phone Numbers → Your Numbers
9. انقر على رقمك
10. تحت Application، اختر التطبيق الذي أنشأته
11. انقر على Update Number

BulkSMS

1. سجّل الدخول إلى BulkSMS
2. انتقل إلى Settings → Advanced → Webhooks
3. انقر على Create New Webhook
4. أدخل اسم الـ webhook (مثال: “WSMS Incoming”)
5. الصق عنوان URL الخاص بـ webhook
6. اختر Inbound Message كمشغّل
7. انقر على Save

ASPSMS

1. سجّل الدخول إلى ASPSMS Console
2. انتقل إلى Numbers → Your Numbers
3. انقر على Edit على رقمك
4. ابحث عن Forward SMS by HTTP GET Request
5. الصق عنوان URL الخاص بـ webhook في الحقل المخصص
6. انقر على Save

Telnyx

1. سجّل الدخول إلى Telnyx Mission Control
2. انتقل إلى Messaging → Programmable Messaging
3. انقر على Messaging Profiles
4. أنشئ ملفًا جديدًا أو حرّر ملفًا موجودًا
5. في Inbound Settings، ابحث عن Inbound Message Webhook URL
6. الصق عنوان URL الخاص بـ webhook
7. اضبط الطريقة على POST
8. انقر على Save
9. خصص هذا الملف لرقم هاتفك

AfricasTalking

1. سجّل الدخول إلى AfricasTalking Dashboard
2. انتقل إلى SMS → SMS Callback URLs
3. انقر على Incoming Messages
4. الصق عنوان URL الخاص بـ webhook
5. انقر على Save

Octopush

1. سجّل الدخول إلى Octopush
2. انتقل إلى API & Integrations
3. انتقل إلى HTTP Callback Options → Webhooks
4. ابحث عن Inbound Messages Callback URL
5. الصق عنوان URL الخاص بـ webhook
6. انقر على Save

Mobile Message (أستراليا)

1. سجّل الدخول إلى Mobile Message
2. انتقل إلى Settings → API
3. ابحث عن Webhook URLs
4. الصق عنوان URL الخاص بـ webhook في Webhook URL for Inbound Messages
5. انقر على Save

بوابات تتطلب التواصل مع الدعم

تتطلب بعض البوابات التواصل مع فريق الدعم الخاص بها لتهيئة عناوين URL الخاصة بـ webhook:

البوابة	كيفية التهيئة
SMS.es	تواصل مع الدعم لإعداد webhook
Infobip	تواصل مع الدعم أو استخدم إعداد API
SMSAPI	تواصل مع الدعم لتهيئة webhook
Cellsynt	تواصل مع الدعم لتفعيل webhooks الواردة
WebSMS	تواصل مع الدعم لإعداد الاتجاهين

عند التواصل مع الدعم، قدّم:

• معرّف حسابك/اسم المستخدم
• عنوان URL الخاص بـ webhook: https://yourdomain.com/wp-json/wpsms/v1/webhook/incoming
• الطلب: “يرجى تهيئة هذا العنوان لاستقبال الرسائل القصيرة الواردة”

اختبار التهيئة

بعد تهيئة webhook:

1. أرسل رسالة قصيرة اختبارية إلى رقم البوابة
2. تحقق من SMS → Inbox بحثًا عن الرسالة
3. إذا لم تُستلم، تحقق من سجل التشخيص:

/wp-content/uploads/wp-sms-two-way-logs/incoming_requests

استكشاف الأخطاء وإصلاحها

الرسائل لا تظهر

1. تحقق من عنوان URL الخاص بـ webhook: تأكد من صحة العنوان وإمكانية الوصول إليه
2. تحقق من SSL: تتطلب معظم البوابات HTTPS
3. جدار الحماية: تأكد من أن خادمك يسمح بطلبات POST الواردة
4. سجل التشخيص: تحقق من ملف السجل بحثًا عن الطلبات الواردة

فشل التحقق من Webhook

تتحقق بعض البوابات من عناوين URL الخاصة بـ webhook عن طريق إرسال طلب اختباري:

1. تأكد من أن موقعك متاح للوصول العام
2. تحقق من تفعيل REST API
3. تأكد من عدم حظر أي إضافة أمان للنقطة النهائية

مشاكل شهادة SSL

تتطلب البوابات شهادات SSL صالحة:

1. تأكد من أن شهادة SSL صالحة وغير منتهية الصلاحية
2. استخدم شهادة من جهة إصدار موثوقة (CA)
3. تجنب الشهادات الموقّعة ذاتيًا

أمان Webhook

لتأمين نقطة نهاية webhook:

1. استخدم HTTPS (مطلوب من معظم البوابات)
2. فكّر في إضافة عناوين IP إلى القائمة البيضاء إذا وفّرت البوابة نطاقات IP
3. راقب سجل التشخيص بحثًا عن نشاط مشبوه

مواضيع ذات صلة

• رسائل SMS ثنائية الاتجاه - وثائق الإضافة الرئيسية
• Webhooks - تهيئة webhook العامة
• إعدادات البوابة - تهيئة بوابات الرسائل القصيرة