اشترك في أحداث Webhooks للحصول على إشعارات حول الرسائل التي يتلقاها نشاطك التجاري وتحديثات الملف الشخصي للعميل.
قبل أن تتمكن من تلقي الإشعارات، ستحتاج إلى إنشاء نقطة نهاية على الخادم لديك لتلقي الإشعارات.
يجب أن تكون نقطة النهاية قادرة على معالجة نوعين من طلبات HTTPS وهما: طلبات التحقق وإشعارات الأحداث. نظرًا إلى أن كلا الطلبين يستخدم بروتوكولات HTTP، يجب أن يتوفر لدى خادمك شهادة TLS أو SSL صالحة تم تكوينها وتثبيتها بشكل صحيح. علمًا بأن الشهادات الموقّعة ذاتيًا غير مدعومة.
التعرف على المزيد حول طلبات التحقق وإشعارات الأحداث
لن يؤثر إعداد أحداث Webhooks على رقم الهاتف المسجل في تطبيق واتساب للأعمال. ولن تتمكن من استخدام رقمك المسجل في تطبيق واتساب للأعمال فقط في حالة ترحيل رقمك إلى منصة واتساب للأعمال.
للاشتراك في أحداث Webhooks، ستحتاج إلى الحصول على معرف تطبيق Meta والأذونات. ولإجراء ذلك، انتقل إلى لوحة معلومات تطبيق Meta. وهناك ستقوم بما يلي:
يمكن لكل تطبيق Meta تكوين نقطة نهاية واحدة فقط في أي وقت. إذا كنت تحتاج إلى إرسال تحديثات webhook إلى عدة نقاط نهاية، فستحتاج إلى عدة تطبيقات Meta.
إذا كنت شريك حلول، فقد تحتاج إلى ما يلي:
whatsapp_business_messaging
في لوحة معلومات التطبيق
عند وقوع حدث تشغيل، تعرض منصة واتساب للأعمال الحدث وترسل على الفور إشعارًا إلى عنوان URL الذي حددته مسبقًا. يمكنك الحصول على نوعين من الإشعارات وهما:
تحتوي كل أحداث Webhooks على التنسيق العام التالي:
{ "object": "whatsapp_business_account", "entry": [{ "id": "WHATSAPP_BUSINESS_ACCOUNT_ID", "changes": [{ "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "PHONE_NUMBER", "phone_number_id": "PHONE_NUMBER_ID" }, # specific Webhooks payload }, "field": "messages" }] }] }
راجع المكونات للحصول على معلومات حول كل حقل.
إذا تلقيت رسالة غير مدعومة في API السحابة، فستحصل على حدث webhook لرسالة غير معروفة.
يمكن أن تصل حمولات بيانات أحداث Webhooks إلى 3 ميجابايت.
أنشئ عينة من نقطة نهاية التطبيق لاختبار أحداث webhooks.
إذا أرسلت طلب حدث webhook إلى نقطة النهاية واستجاب الخادم برمز حالة HTTP بخلاف 200، أو إذا تعذر علينا تسليم حدث webhook لأي سبب أخر، فسنستمر في محاولة تقليل معدل التكرار حتى ينجح الطلب، لما يصل إلى 7 أيام.
لاحظ أنه سيتم إرسال عمليات إعادة المحاولة إلى كل التطبيقات التي اشتركت في أحداث webhooks (والحقول الملائمة) في حساب واتساب للأعمال. قد يؤدي هذا إلى تكرار إشعارات webhook.
يمكنك الحصول على عناوين IP لخوادم webhook من خلال تشغيل الأمر التالي في الوحدة الطرفية:
whois -h whois.radb.net — '-i origin AS32934' | grep ^route | awk '{print $2}' | sort
بشكل دوري نعمل على تغيير عناوين IP هذه، لذلك إذا كنت تدرج خوادمنا في قائمة السماح، فقد ترغب في إعادة إنشاء هذه القائمة من حين لآخر وتحديث قائمة السماح وفقًا لذلك.
تعرف على المزيد حول المعلومات التي يمكنك تلقيها في إشعار Webhooks.