محادثةمن نظام Online
محادثة / شرح الربط

ربط صفحتك بـ Meta خطوة بخطوة

هتعمل تطبيق Meta باسم شركتك، وتربطه بمحادثة. ده بياخد حوالي 15 دقيقة مرة واحدة بس، وبعدها صفحتك تشتغل من غير ما تحتاج موافقة أو App Review من Meta.

قبل ما تبدأ

  • حساب فيسبوك شخصي يكون أدمن على الصفحة (Full control).
  • لو هتربط إنستجرام: حساب Business أو Creator مربوط بالصفحة. وتفعّل من تطبيق إنستجرام: الإعدادات ← الرسائل والردود على القصص ← أدوات الرسائل المتصلة ← السماح بالوصول للرسائل.
  • حسابك على محادثة، وتكون فاتح صفحة الصفحات في تاب تاني عشان تنسخ منها.
ليه تطبيق خاص بيك؟ Meta بتقول إن التطبيق اللي بيبعت ويستقبل رسايل لصفحة صاحبه مش محتاج App Review. فلما التطبيق يبقى باسمك، صفحتك تشتغل على طول.

1 إنشاء التطبيق

  1. ادخل على developers.facebook.com/apps. لو أول مرة، هيطلب منك تسجّل كـ Developer (موافقة على الشروط وتأكيد الموبايل أو الإيميل).
  2. دوس Create App، واكتب اسم التطبيق (مثلًا: اسم شركتك - Chat) وإيميل للتواصل.
  3. في اختيار الـ Use case اختار Engage with customers on Messenger from Meta (التفاعل مع العملاء على ماسنجر).
  4. لو سألك عن Business portfolio، اختار حساب البيزنس اللي فيه الصفحة، أو كمّل من غيره.
  5. دوس Create app، وهيطلب منك كلمة سر فيسبوك للتأكيد.
Meta بتغيّر أسماء الأزرار والقوائم من وقت للتاني. لو مش لاقي اسم معين بالظبط، دوّر على أقرب اسم ليه في نفس المكان.

2 App ID و App Secret

  1. من القائمة الجانبية للتطبيق: App settings ← Basic.
  2. انسخ App ID، ودوس Show جنب App Secret وانسخه.
  3. في محادثة روح على الصفحات ← تطبيق Meta، والصقهم في الخانتين، ودوس حفظ.
الـ App Secret زي كلمة السر. متبعتهوش لحد، ومحادثة بتستخدمه عشان تتأكد إن الرسايل جاية فعلًا من Meta.

3 ربط الـ Webhook

الـ Webhook هو الطريقة اللي Meta بتبعت بيها أي رسالة جديدة لمحادثة.

  1. في التطبيق روح على Use cases ← Customize جنب Messenger ← Messenger API Settings.
  2. في جزء Configure webhooks حط:
Callback URLhttps://mo7adtha.nezam.online/webhook.php?w=XXXXXXXX
Verify tokenXXXXXXXX
دي قيم توضيحية. ادخل على حسابك وافتح الصفحة دي تاني، أو روح على "الصفحات"، وهتلاقي القيم الحقيقية الخاصة بيك.
  1. دوس Verify and save. لو ظهرت علامة صح، الربط تمام.
  2. في Webhook fields اشترك في: messages، messaging_postbacks، message_echoes.

4 توكن الصفحة والربط

قبل ما تطلّع التوكن: في التطبيق افتح Use cases ← Customize جنب Messenger ← Permissions، واتأكد إن الصلاحيات دي متضافة: pages_messaging، وpages_manage_metadata، وpages_show_list، وpages_read_engagement. لو ناقصة، دوس Add جنبها. الصلاحية الأخيرة هي اللي بتخلي محادثة تقرا اسم الصفحة وحساب الإنستجرام، وترد على الكومنتات.
  1. في نفس صفحة Messenger API Settings ← جزء Generate access tokens دوس Connect أو Add Page، واختار صفحتك، ووافق على كل الصلاحيات.
  2. جنب اسم الصفحة دوس Generate، وعلّم إنك فاهم، وانسخ التوكن (بيبدأ بـ EAA).
  3. في محادثة: الصفحات ← ربط صفحة ← الصق التوكن ← ربط.
  4. محادثة هتجيب اسم الصفحة وحساب الإنستجرام المربوط بيها، وهتشترك في الـ Webhooks للصفحة لوحدها. المفروض تشوف رسالة "الـ Webhooks اشتغلت ✅".
التوكن اللي بيطلع من الشاشة دي ملوش تاريخ انتهاء، طول ما إنت أدمن على الصفحة ومغيرتش كلمة سر فيسبوك.

5 الرد على الكومنتات (اختياري)

  1. في التطبيق افتح Webhooks من القائمة (أو من Messenger API Settings)، واختار Page.
  2. لو مطلوب، حط نفس الـ Callback URL والـ Verify token تاني، واشترك في حقل feed.
  3. اتأكد إن الصلاحيات pages_read_engagement و pages_manage_engagement متضافة للتطبيق. وبعد ما تضيفها، طلّع توكن الصفحة من جديد واربطه تاني في محادثة.
  4. في محادثة اعمل Flow نوعه "لما حد يعلق على بوست".

6 إنستجرام (اختياري)

  1. من Use cases ضيف Manage messaging & content on Instagram، واختار طريقة الربط عن طريق Facebook Login.
  2. ضيف الصلاحيات instagram_basic، وinstagram_manage_messages، وinstagram_manage_comments.
  3. في Webhooks اختار Instagram، وحط نفس الـ Callback URL والـ Verify token، واشترك في messages و comments.
  4. طلّع توكن الصفحة تاني بعد إضافة صلاحيات إنستجرام، واربطه في محادثة من جديد. هيظهر حساب الإنستجرام جنب الصفحة.

7 تشغيل التطبيق (Live)

التطبيق وهو في وضع Development بيستقبل رسايل الناس اللي ليهم دور فيه بس، زيك إنت وفريقك. عشان يرد على كل العملاء:

  1. App settings ← Basic: حط رابط Privacy Policy (تقدر تستخدم سياسة خصوصية نظام Online أو صفحة الخصوصية بتاعة موقعك)، وCategory، وأيقونة للتطبيق، ودوس Save.
  2. من فوق في التطبيق غيّر App Mode من Development لـ Live. ولو ظهر زرار Publish، دوس عليه.
مش محتاج App Review ولا Business Verification طول ما التطبيق بيشتغل على صفحاتك إنت. Meta بتطلبهم بس لو التطبيق هيخدم صفحات ناس تانية.

8 التجربة

  1. في محادثة اعمل Flow بكلمة مفتاحية مثلًا تجربة، أو استخدم الـ Flows الجاهزة.
  2. من حساب فيسبوك تاني (أو من حسابك)، ابعت تجربة للصفحة في الماسنجر.
  3. المفروض البوت يرد في ثواني، والمحادثة تظهر في المحادثات.

؟ مشاكل شائعة

المشكلةالحل
Verify and save بيطلع خطأاتأكد إنك ناسخ الـ Callback URL كامل بالجزء اللي بعد ?w=، وإن الـ Verify token مطابق، وإن الرابط شغال بـ HTTPS.
"التوكن مش شغال" ومعاه pages_read_engagementضيف الصلاحية pages_read_engagement من Use cases ← Customize ← Permissions، وبعدين طلّع التوكن من جديد واربطه. (من نسخة 1.3.3 الصفحة بتتربط حتى لو الصلاحية دي ناقصة، والرسايل بتشتغل عادي.)
"التوكن مش شغال" ومعاه appsecret_proofالـ App Secret المحفوظ مش بتاع نفس التطبيق اللي طلّعت منه التوكن. راجع الـ App Secret في صفحة الصفحات.
الرسايل بتوصلني أنا بس، والعملاء لأالتطبيق لسه في Development. شغّله Live من الخطوة 7.
البوت مش بيرد خالصمن صفحة الصفحات دوس Webhooks جنب الصفحة. ولو المشكلة لسه موجودة، اتأكد إن الـ Flow متفعّل وإن البوت مش واقف للعميل ده.
الإنستجرام مش ظاهرالحساب لازم يكون Business أو Creator ومربوط بالصفحة، ولازم تطلّع التوكن من جديد بعد إضافة صلاحيات إنستجرام.

لسه محتاج مساعدة؟ كلم فريق نظام Online، وهنساعدك تربط.