التكامل
إعداد Webhooks
Webhooks هي آلية تُمكّن Meta من إرسال أحداث الرسائل (الرسائل الواردة، الإيصالات، التحديثات) إلى خادم نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي في الوقت الفعلي. بدون ضبط Webhook، لن تتلقى لوحة تحكمك أي رسائل واردة.
كيف تعمل Webhooks؟
1عميلك يرسل رسالة WhatsApp إلى رقمك.
2Meta تستقبل الرسالة وترسل HTTP POST إلى Webhook URL الخاص بـ نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي.
3نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي يعالج الحدث ويعرض الرسالة في لوحة التحكم.
4ردّك يُرسَل من نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي عبر Meta API إلى عميلك.
أولاً: الحصول على بيانات Webhook من نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي
1سجّل الدخول إلى لوحة تحكم نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي وانتقل إلى الإعدادات → تكامل WhatsApp.
2ابحث عن قسم "Webhook". انسخ Webhook URL الخاص بك — يبدو هكذا: https://api.neuron-sa.com/api/meta/webhook/YOUR_BUSINESS_ID
3انسخ Verify Token الظاهر بجانب Webhook URL. ستحتاج إلى كلا القيمتين في الخطوة التالية.
ثانياً: ضبط Webhook في Meta Developer Console
1انتقل إلى developers.facebook.com → تطبيقك → WhatsApp → Configuration.
2في قسم "Webhook"، انقر "Edit".
3الصق نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي Webhook URL في حقل "Callback URL".
4الصق Verify Token من نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي في حقل "Verify Token".
5انقر "Verify and Save". ستُرسل Meta طلب GET إلى Webhook URL للتأكد من إمكانية الوصول إليه.
6إذا نجح التحقق، ستظهر حالة Webhook "Subscribed".
ثالثاً: الاشتراك في أحداث Webhook
بعد التحقق، اشترك في الأحداث التي تريد تلقيها.
في قسم Webhook fields، فعّل الأحداث التالية:
messagesالرسائل الواردة من العملاءmessage_deliveriesإيصالات التسليمmessage_readsإيصالات القراءةmessaging_postbacksردود أزرار القوالبaccount_alertsتنبيهات الحساب والأخطاءℹ️تأكد من تفعيل حقل "messages" على الأقل — هذا هو الحدث الأساسي الذي يُسلّم الرسائل الواردة إلى نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي.
رابعاً: اختبار Webhook
1من هاتفك الشخصي (وليس رقم الأعمال المسجّل)، أرسل رسالة WhatsApp إلى رقمك التجاري.
2افتح لوحة تحكم نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي → المحادثات. يجب أن تظهر الرسالة خلال 1-2 ثانية.
3ردّ من لوحة تحكم نيرون - دعم العملاء المدعوم بالذكاء الاصطناعي وتحقق من وصول الرد على هاتف المرسل.
⚠️إذا لم تظهر الرسائل، تحقق من: (1) أن التطبيق في وضع Live. (2) أن System User لديه صلاحيات كافية. (3) أن Webhook URL صحيح في إعدادات Meta.