إعداد Webhooks

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

إنشاء نقطة نهاية

قبل أن تتمكن من تلقي الإشعارات، ستحتاج إلى إنشاء نقطة نهاية على الخادم لديك لتلقي الإشعارات.

يجب أن تكون نقطة النهاية قادرة على معالجة نوعين من طلبات HTTPS وهما: طلبات التحقق وإشعارات الأحداث. نظرًا إلى أن كلا الطلبين يستخدم بروتوكولات HTTP، يجب أن يتوفر لدى خادمك شهادة TLS أو SSL صالحة تم تكوينها وتثبيتها بشكل صحيح. علمًا بأن الشهادات الموقّعة ذاتيًا غير مدعومة.

التعرف على المزيد حول طلبات التحقق وإشعارات الأحداث

الاشتراك في Webhooks

للاشتراك في أحداث Webhooks، ستحتاج إلى الحصول على معرف تطبيق Meta والأذونات. ولإجراء ذلك، انتقل إلى لوحة معلومات تطبيق Meta. هناك ستقوم بما يلي:

1. إنشاء تطبيق Meta في لوحة معلومات تطبيق Meta
2. إضافة منتج Webhooks إلى تطبيق Meta في لوحة معلومات التطبيق

   يمكن لكل تطبيق Meta تكوين نقطة نهاية واحدة فقط في أي وقت. إذا كنت تحتاج إلى إرسال تحديثات webhook إلى عدة نقاط نهاية، فستحتاج إلى عدة تطبيقات Meta.

عندما تكون مستعدًا لتوسيع نطاق مراسلات نشاطك التجاري، قد تحتاج إلى:

1. إضافة إذن whatsapp_business_management في لوحة معلومات التطبيقات
2. إكمال مراجعة التطبيقات من Meta بنجاح – ستستغرق هذه الخطوة بعض الوقت، ولكن يمكنك الاستمرار في الاختبار أثناء عملية المراجعة بأكملها.

حقول الاشتراكات المتوفرة

حمولة بيانات الإشعارات

تحتوي جميع الإشعارات على التنسيق العام التالي:

[{
    "object": "whatsapp_business_account",
    "entry": [{
       "id": "{whatsapp-business-account-id}",
        "time": {unix-timestamp},
        "changes": [{
            "field": "{subscribed-field}",
            "value": {
                # Information that was update
            }
          }]
      }]
  }]

تحتوي مصفوفة المستوى الأعلى على كائنين رئيسيين:

لمعرفة كل كائنات webhooks المتوفرة، يمكنك الرجوع إلى المكونات.

عينة من نقاط نهاية التطبيق

• عينة من نقاط نهاية التطبيق باستخدام Glitch
• عينة من نقاط نهاية التطبيق باستخدام Heroku