انتقل إلى المحتوى

دليل إعداد Meta (إنستغرام وماسنجر)

يتطلب ربط البوت الخاص بك بـ Facebook Messenger و Instagram Direct Messages تهيئة تطبيق في بوابة مطوري Meta (Meta Developer Portal).

تتضمن هذه العملية عدة خطوات لأن Meta تطلب أذونات صريحة وخطافات ويب (webhooks) لتوجيه الرسائل من منصاتها إلى مثيل FRENZY.BOT الخاص بك.

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي: 1. صفحة فيسبوك (Facebook Page) لعملك. 2. حساب إنستغرام احترافي (Business أو Creator) مرتبط بصفحة فيسبوك تلك. 3. الوصول إلى لوحة تحكم FRENZY.BOT للحصول على رابط Webhook URL الخاص بك.

الخطوة 1: إنشاء تطبيق Meta

  1. انتقل إلى بوابة مطوري Meta وقم بتسجيل الدخول.
  2. انقر على My Apps في الزاوية العلوية اليمنى، ثم انقر على Create App.
  3. حدد Other كنوع التطبيق وانقر على Next.
  4. حدد Business وانقر على Next.
  5. أدخل App Display Name (مثل "My Business Bot") وبريدك الإلكتروني للتواصل.
  6. حدد حساب الأعمال الخاص بك (اختياري ولكنه موصى به) وانقر على Create App.

الخطوة 2: إضافة المنتجات إلى تطبيقك

من لوحة تحكم التطبيق الخاص بك: 1. قم بالتمرير لأسفل إلى Add products to your app. 2. ابحث عن Messenger وانقر على Set Up. 3. في الشريط الجانبي الأيسر، انقر على Messenger ← Instagram settings (إذا كنت تريد إنستغرام) أو ابقَ في Messenger ← settings (لماسنجر فيسبوك).

الخطوة 3: إنشاء رموز الوصول (Access Tokens)

أنت بحاجة إلى رمز وصول للصفحة (Page Access Token) للسماح لـ FRENZY.BOT بإرسال الرسائل نيابة عنك.

  1. ضمن Messenger ← Settings، ابحث عن قسم Access Tokens.
  2. انقر على Add or Remove Pages وقم بالمصادقة باستخدام حساب فيسبوك الخاص بك.
  3. حدد صفحات فيسبوك التي تريد ربطها وامنح الأذونات المطلوبة.
  4. بمجرد ربط الصفحة، انقر على Generate Token بجانبها.
  5. انسخ هذا الرمز فوراً واحفظه. ستقوم بلصقه في لوحة تحكم FRENZY.BOT.

الخطوة 4: تكوين الـ Webhook

هذا يخبر Meta بمكان إرسال الرسائل الواردة.

  1. في لوحة تحكم FRENZY.BOT، انتقل إلى Channels ← Messenger (أو Instagram).
  2. ابحث عن رابط Webhook URL و Verify Token الفريد الخاص بك في تلك الصفحة.
  3. بالعودة إلى بوابة مطوري Meta، قم بالتمرير لأسفل إلى قسم Webhooks (ضمن إعدادات Messenger).
  4. انقر على Add Callback URL.
  5. الصق Webhook URL و Verify Token من لوحة تحكم FRENZY.BOT.
  6. انقر على Verify and Save.

الخطوة 5: الاشتراك في الأحداث

يجب عليك إخبار Meta بأي أحداث تريد إرسالها إلى الـ webhook الخاص بك.

  1. في قسم Webhooks، انقر على Manage بجانب اسم صفحتك.
  2. اشترك في الحقول التالية:
  3. messages (مطلوب للرسائل النصية)
  4. messaging_postbacks (مطلوب لنقرات الأزرار/الردود السريعة)
  5. messaging_optins (اختياري، لأزرار "ابدأ الآن")
  6. انقر على Save.

الخطوة 6: العثور على المعرفات الخاصة بك (IDs)

إذا كنت تقوم بإعداد Instagram، فأنت بحاجة إلى معرفات محددة:

  1. Instagram Account ID:
  2. انتقل إلى إعدادات صفحة فيسبوك ← الحسابات المرتبطة ← إنستغرام.
  3. أو استخدم مستكشف واجهة برمجة تطبيقات Graph: GET /v18.0/me?fields=instagram_business_account
  4. Recipient IGID:
  5. هذا هو المعرف الخاص بإنستغرام للشخص الذي تريد أن يتلقى التنبيهات (في حال استخدام إنستغرام كـ Integration). لإعداد القناة (Channel)، عادةً ما لا يكون هذا مطلوباً ما لم يتم تحديده في لوحة التحكم.

الخطوة 7: الإنهاء في FRENZY.BOT

  1. ارجع إلى لوحة تحكم FRENZY.BOT الخاصة بك (Channels ← Messenger أو Instagram).
  2. الصق Page Access Token الذي أنشأته في الخطوة 3.
  3. الصق أي معرفات مطلوبة (مثل Instagram Account ID).
  4. قم بتفعيل الخيار Enable لتشغيل القناة.
  5. انقر على Save Settings.

⚠️ هام جداً: مراجعة التطبيق (الوضع المباشر)

عند إنشاء تطبيق Meta لأول مرة، يكون في وضع التطوير (Development Mode).

في وضع التطوير، سيستجيب البوت الخاص بك فقط لك وللمطورين/المختبرين الآخرين المضافين إلى التطبيق في بوابة Meta (ضمن App Roles).

لجعل البوت الخاص بك يستجيب للجمهور العام، يجب عليك: 1. إكمال تحقق الشركة (Business Verification) في بوابة مطوري Meta. 2. طلب الوصول المتقدم (Advanced Access) لأذونات محددة (عادةً pages_messaging و instagram_manage_messages). 3. إرسال تسجيل فيديو (screencast) يوضح كيفية عمل البوت الخاص بك. 4. بمجرد الموافقة، قم بتبديل مفتاح التطبيق في أعلى الشاشة من Development إلى Live.

ملاحظة: يمكن أن تستغرق عملية مراجعة Meta عدة أيام.