Messenger
اربط صفحة Facebook باستخدام بيانات اعتماد Meta Messenger Platform وwebhooks الموقّعة.
اربط صفحة Facebook باستخدام بيانات اعتماد Meta Messenger Platform وwebhooks الموقّعة.
تجهيز تطبيق Meta والصفحة#
اتبع دليل البدء الرسمي لـ Messenger Platform من Meta. أضف Messenger إلى تطبيق Meta، واربط صفحة Facebook التي ستستقبل الرسائل، وتأكد من أن حسابك يملك صلاحية إدارة الأصلين معًا.
اجمع القيم من التطبيق نفسه والصفحة نفسها:
| حقل Make Agent Fast | القيمة لدى المزوّد | الغرض |
|---|---|---|
| رمز وصول الصفحة | الرمز الصادر للصفحة المحددة | قراءة هوية الصفحة وإرسال الردود |
| سر التطبيق | سر تطبيق Meta المكوّن من 32 خانة بالنظام السداسي عشري | التحقق من طلبات webhook الواردة الموقّعة |
لا تستخدم رمز وصول مستخدم ولا رمزًا يخص صفحة أخرى. تحدد حالة تطوير التطبيق ومراجعته لدى Meta الأشخاص الذين يمكنهم استخدام التكامل.
حفظ بيانات الاعتماد والتحقق منها#
افتح صفحة القنوات الخاصة بالـ agent، واختر Messenger، وأدخل رمز وصول الصفحة وسر التطبيق، ثم اختر اتصال.
يستدعي Make Agent Fast واجهة Graph API باستخدام appsecret_proof، ويحدد معرّف الصفحة واسمها، ويربط الأحداث الواردة بهذه الصفحة تحديدًا. بعد ذلك تعرض بطاقة الموصّل عنوان Webhook URL ورمز التحقق.
إعداد webhook الخاص بالصفحة#
في تطبيق Meta نفسه:
- افتح إعدادات webhook الخاصة بـ Messenger.
- الصق Webhook URL ورمز التحقق الخاصين بالموصّل.
- أكمل خطوة التحقق (verification challenge).
- اختر الاشتراك في أحداث الرسائل المطلوب لسير عمل Messenger لديك.
- اشترك بصفحة Facebook المقصودة في التطبيق.
- تأكد من أن اشتراك الصفحة ووضع التطبيق يسمحان لمستخدم الاختبار لديك.
يُستخدم رمز التحقق فقط في خطوة التحقق الأولية. أما أحداث التشغيل فيجب أن تحمل توقيعًا يطابق سر التطبيق. كما يرفض Make Agent Fast الأحداث الموجّهة إلى صفحة مختلفة حتى لو جاءت من تطبيق Meta نفسه.
اختبار الإمكانات#
أرسل رسالة عادية إلى الصفحة من حساب اختبار مسموح له وليس مسؤولًا، وتأكد من وصول الرد ومن ظهور المحادثة في المحادثات. ثم اختبر مرفق صوت إذا كانت الرسائل الصوتية الواردة مهمة لسير عملك.
تتم معالجة النصوص والصوت الوارد المدعوم. الردود نصية فقط في موصّل Messenger الحالي، حتى لو كانت الرسالة الأصلية صوتية. يتم تجاهل إيصالات التسليم والقراءة، وأصداء رسائل الصفحة نفسها، والصور، وغيرها من المرفقات غير المدعومة.
الجاهزية للإنتاج#
أكمل الأذونات ومراجعة التطبيق والتحقق من النشاط التجاري ورابط الخصوصية وخطوات نشر الصفحة التي تطلبها Meta لجمهورك. نجاح الاختبار في وضع التطوير بحساب له دور في التطبيق لا يعني أن الجمهور العام قادر على مراسلة تكامل الصفحة.
وثّق تطبيق Meta المالك ومعرّف الصفحة (Page ID) للمشغّلين. قد يتوقف رمز الصفحة عن العمل عند تغيّر مالكه أو أذوناته أو ارتباطه بالنشاط التجاري أو سياسة المزوّد.
التدوير أو قطع الاتصال#
أنشئ رمز الصفحة البديل، ثم حدّث الموصّل، واختبر من مستخدم مسموح له، وبعدها أبطل الرمز القديم. حدّث Make Agent Fast فور تدوير سر التطبيق.
لا يؤدي تعطيل الموصّل أو إزالته إلى إلغاء اشتراك الصفحة في Meta. أزل اشتراك الصفحة وبيانات اعتماد المزوّد غير المستخدمة عند إيقاف التكامل نهائيًا.
استكشاف الأخطاء وإصلاحها#
| العَرَض | الحل |
|---|---|
| رفض الرمز | تأكد من أنه رمز وصول للصفحة المقصودة وأن سر التطبيق يعود للتطبيق نفسه |
| فشل التحقق من webhook | انسخ العنوان الحالي ورمز التحقق كما هما تمامًا، واستخدم HTTPS عامًا |
| ينجح التحقق لكن الرسائل لا تصل | اشترك بالصفحة وبحدث الرسائل، ثم افحص وضع التطبيق ودور المستخدم وسجلات التسليم في Meta |
| الطلبات غير مصرّح بها | صحّح سر التطبيق؛ فطلبات POST الموقّعة لا تستخدم رمز التحقق |
| تظهر الرسالة الواردة دون رد | افحص صلاحية رمز الصفحة وأذونات المراسلة وخطأ الإرسال لدى المزوّد وحالة الموصّل |
| الرسالة الصوتية تحصل على رد نصي | هذا متوقع؛ الرد الصوتي الصادر في Messenger غير مدعوم حاليًا |
يجب ألا تُدخَل بيانات اعتماد المزوّد إلا في نموذج الموصّل بعد تسجيل الدخول أو في استدعاء API موثوق من جهة الخادم.