ربط رسائل إنستغرام

تحقّق من نوع الحساب والربط وصلاحيات الإدارة

يعتمد تكامل Instagram في Evnao على Facebook Login. جهّز حساب Instagram احترافيًا مرتبطًا بصفحة Facebook نشطة تملك صلاحية إدارتها.

• الحساب احترافي من نوع Business أو Creator وليس Personal.
• صفحة Facebook موجودة ومنشورة.
• حساب Instagram مرتبط بالصفحة عبر Settings → Linked Accounts.
• لديك Full Control أو صلاحية Admin على الصفحة وحساب Instagram.
• المصادقة الثنائية مفعّلة إذا كان ملف الأعمال يشترطها.

إذا تشابهت أسماء الصفحات، تحقّق من المعرّف الرقمي بدل الاعتماد على الاسم.

يتطلب هذا المسار حساب Instagram احترافيًا؛ الحساب الشخصي غير مناسب لهذا الإعداد.

استخدم التطبيق نفسه في جميع مراحل الإعداد

افتح بوابة مطوّري Meta واختر التطبيق الذي ستستخدمه مع Evnao أو أنشئه. يجب أن تنتمي الصلاحيات وإعدادات تسجيل الدخول وروابط استقبال الإشعارات وسر التطبيق إلى التطبيق نفسه.

developers.facebook.com → My Apps → Create App (or open existing)

لا تخلط صلاحيات تطبيق مع أسرار أو رموز تطبيق آخر. استخدم التطبيق نفسه.

عندما تطلب بوابة Meta نوع التطبيق، اتبع خيارات Business أو Other المناسبة لمسار الإعداد.

تفعيل المراسلة باستخدام Facebook Login

أضف إمكانية مراسلة Instagram إلى تطبيق Meta. عند اختيار نوع إعداد API، اختر API setup with Facebook login.

Meta Developer App → Use Cases → Add Use Case → Business messaging → Manage messaging & content on Instagram → Customize → API setup with Facebook login

اختر API setup with Facebook login. مسار API setup with Instagram login مختلف عن مسار ربط الصفحة الذي يستخدمه هذا التكامل.

إضافة الصلاحيات المطلوبة لهذا المسار

جهّز تطبيق Meta ورمز التفويض بالصلاحيات السبع أدناه لقراءة الرسائل والعثور على الصفحات والاشتراك في الإشعارات.

• instagram_basic
• instagram_manage_messages
• pages_show_list
• pages_read_engagement
• pages_manage_metadata
• pages_messaging
• business_management

إذا غابت pages_manage_metadata، افتح Use Cases → Add Use Case وأضف Manage everything on your Page ثم فعّل صلاحيات إدارة الصفحة.

عند ظهور الخطأ ‎#200 المتعلق بـ pages_messaging، أضف Engage with customers on Messenger from Meta وفعّل هذه الصلاحية.

تحديد الصفحات وحسابات Instagram المطلوب تفويضها

من لوحة تطبيق Meta، افتح Facebook Login for Business وأنشئ إعدادًا جديدًا لتحديد الأصول والصلاحيات المطلوبة أثناء التفويض.

Meta Developer App → Facebook Login for Business → Configurations → Create Configuration

معرّف Configuration ID مخصّص لإعداد Meta. لا تُدخله في حقول معرّف الصفحة أو Instagram في Evnao.

سمِّ الإعداد بوضوح، مثل Evnao Instagram AI.

في Required Assets، اختر Pages وInstagram accounts وحدّدهما كـ Asset Required.

اترك الأصول غير المطلوبة مثل Ad accounts وCatalogs وPixels دون تحديد.

أضف الصلاحيات السبع المذكورة في الخطوة 4.

اختيار ملف الأعمال والصفحة والحساب الصحيح

افتح Graph API Explorer واختر تطبيق Meta ثم ابدأ التفويض. حدّد ملف الأعمال وصفحة Facebook وحساب Instagram المطلوب ربطها.

اختر ملف الأعمال الذي يملك الصفحة المستهدفة. اختيار ملف مختلف قد يعيد نتائج فارغة.

استخدم ‎/me/accounts للحصول على القيم الرقمية

نفّذ الطلب أدناه في Graph API Explorer لاسترجاع صفحات Facebook وحسابات Instagram الاحترافية المرتبطة بها.

معرّف صفحة Facebook المرتبطة

القيمة الرقمية في data[].id. أدخلها في Evnao.

معرّف حساب Instagram الاحترافي

القيمة الرقمية في data[].instagram_business_account.id. أدخلها في Evnao.

اسم مستخدم Instagram

القيمة في instagram_business_account.username للتعرّف على الحساب فقط. لا تُدخلها في حقل المعرّف.

عند تشابه أسماء الصفحات، استخدم instagram_business_account.username لتحديد الصفحة المرتبطة بحسابك.

إذا كانت instagram_business_account فارغة، تحقّق من أن الحساب احترافي ومرتبط بالصفحة المحددة.

GET /me/accounts?fields=id,name,access_token,instagram_business_account{id,username,name}

{
  "data": [
    {
      "id": "123456789012345",
      "name": "Example Business",
      "access_token": "EAABw...",
      "instagram_business_account": {
        "id": "17841412345678901",
        "username": "examplebusiness",
        "name": "Example Business"
      }
    }
  ]
}

استخراج رمز الصفحة وفحص صلاحيته

اتبع مسار تمديد رمز المستخدم ثم استخراج رمز الصفحة. افحص الصلاحية وتاريخ الانتهاء في أداة Meta؛ لا تعتمد على افتراض أن الرمز سيبقى صالحًا دائمًا.

• في Graph API Explorer، اختر Get User Access Token وامنح الصلاحيات المطلوبة.
• افتح Access Token Debugger وافحص رمز المستخدم ثم استخدم Extend Access Token عندما يتاح.
• استخدم رمز المستخدم الممدّد في Graph API Explorer ونفّذ GET /me/accounts، ثم انسخ access_token الخاص بصفحتك.

لا تشارك رمز الوصول أو سر التطبيق أو كلمات المرور في محادثات الدعم أو القنوات العامة.

لا تحفظ رمز مستخدم قصير الأجل في حقل رمز الصفحة في Evnao. استخرج الرمز من كائن الصفحة وتحقّق منه.

تأكيد النوع والصلاحية وبيانات الحساب

افتح رمز الصفحة المستخرج في Access Token Debugger، ثم نفّذ طلبات التحقق أدناه في Graph API Explorer.

• تعرض أداة الفحص Type: Page.
• تعرض أداة الفحص Valid: True.
• راجعت معلومات انتهاء الصلاحية والوصول إلى البيانات في أداة الفحص.
• يتطابق معرّف الصفحة في أداة الفحص مع صفحتك.
• تتضمن الصلاحيات pages_messaging وinstagram_manage_messages.

GET /me?fields=id,name

{
  "id": "123456789012345",
  "name": "Example Business"
}

GET /{PAGE_ID}?fields=id,name,instagram_business_account{id,username,name}

{
  "id": "123456789012345",
  "name": "Example Business",
  "instagram_business_account": {
    "id": "17841412345678901",
    "username": "examplebusiness"
  }
}

الاشتراك في messages وmessaging_postbacks

باستخدام رمز الصفحة الذي تحققت منه، أرسل طلب POST في Graph API Explorer لتفعيل اشتراك الصفحة في أحداث الرسائل.

لا تتابع حتى يعيد الطلب { "success": true }.

الخطأ ‎#210 يعني أن العملية تحتاج رمز صفحة؛ تحقّق من أنك لم تختر رمز مستخدم.

عند الخطأ ‎#200 المتعلق بالإدارة، راجع Full Control في Business Settings والمصادقة الثنائية لحسابك.

POST /{PAGE_ID}/subscribed_apps?subscribed_fields=messages,messaging_postbacks

{
  "success": true
}

إدخال رابط Evnao ورمز التحقق المطابق في Meta

اضبط إشعارات Instagram في تطبيق Meta ليعرف أين يرسل الرسائل الواردة. استخدم رابط مساحة عملك ورمز التحقق المحفوظ في Evnao.

Meta Developer App → Webhooks → Select 'Instagram' → Edit Subscription / Callback URL

• Callback URL يطابق الرابط المعروض في مساحة عمل Evnao.
• Verify Token يطابق الرمز السري المحفوظ في Evnao حرفيًا.
• اشتركت في الحقلين messages وmessaging_postbacks.
• اكتمل الاشتراك على مستوى التطبيق وعلى مستوى الصفحة.

رمز Verify Token تنشئه أنت أو Evnao؛ لا تحصل عليه من Meta.

إذا فشل التحقق، طابق رمز Meta مع رمز Evnao حرفيًا دون مسافات إضافية. احفظ الاتصال في Evnao قبل التحقق في Meta.

حفظ المعرّفات والبيانات السرية بأمان

أدخل القيم الخمس في نموذج اتصال Instagram. تُشفّر البيانات السرية عند تخزينها في مساحة عملك.

معرّف حساب Instagram الاحترافي

القيمة الرقمية في instagram_business_account.id، مثل 17841412345678901.

معرّف صفحة Facebook المرتبطة

المعرّف الرقمي للصفحة المرتبطة بالحساب، مثل 123456789012345.

رمز الوصول إلى الصفحة

رمز صفحة تحققت من نوعه وصلاحيته وتفاصيل انتهائه في أداة Meta.

سر تطبيق Meta

من Meta Developer Dashboard → App Settings → Basic → App Secret.

رمز التحقق لرابط الإشعارات

القيمة السرية المطابقة لما أدخلته في إعدادات webhook لدى Meta.

ضبط الردود وساعات العمل والتدخل البشري

من إعدادات القنوات في Evnao، فعّل السماح بردود الذكاء الاصطناعي على هذه القناة، واضبط ساعات العمل والمنطقة الزمنية عند الحاجة.

• فعّلت السماح بردود الذكاء الاصطناعي على القناة.
• ضبطت ساعات العمل إذا أردت تقييد وقت الرد الآلي.
• اخترت منطقة زمنية مثل Asia/Amman أو America/New_York.
• راجعت سلوك التدخل البشري وإيقاف الردود الآلية عند ردّ الفريق.

إرسال رسالة من حساب اختبار مخوّل

تحقّق من أدوار الاختبار والوصول المتاحة لتطبيق Meta قبل اختبار الرسائل. ابدأ بحساب اختبار مخوّل وقَبِل دعوته.

Meta Developer App → App Roles → Roles → Instagram Testers → Add Instagram Tester

• أضفت حساب الاختبار بدور Instagram Tester في تطبيق Meta.
• دخلت إلى حساب الاختبار وقبلت الدعوة من إعدادات Apps & Websites → Tester Invites.
• تحققت من أن الدعوة لم تعد Pending.
• أرسلت رسالة نصية بسيطة إلى حساب نشاطك التجاري.
• تحققت من وصول الرسالة إلى صندوق وارد Evnao ووصول الرد إلى المرسل.

إذا كانت الدعوة Pending، اقبلها وتحقّق من حالة الحساب قبل إعادة الاختبار.

ابدأ برسالة نصية بسيطة. لا تستخدم الصور أو المقاطع أو الرسائل الصوتية للاختبار الأول.

مراجعة وصول التطبيق قبل الاستخدام العام

راجع حالة تطبيق Meta والصلاحيات ومراجعة التطبيق المطلوبة قبل استقبال رسائل الجمهور. حفظ الاتصال في Evnao لا يؤكد الحصول على موافقة Meta.

• راجعت من يمكنه المراسلة في وضع التطوير وفق أدوار التطبيق.
• تحققت من حالة Live والصلاحيات اللازمة لخدمة الجمهور.
• تحققت من مراجعة التطبيق والوصول المطلوبين في Meta ولم أفترض أن Evnao يمنحهما تلقائيًا.

راجع متطلبات Meta الخاصة بالتطبيق المستخدم. اكتمال خطوات هذا الدليل لا يُعد موافقة من Meta.