ربط إنستغرام (9 خطوات)

قبل العمل على لوحة Meta، حتى لا يُحظر الحساب:
  • ادخل بحساب فيسبوك الذي تستخدمه دائماً؛ لا تنشئ حساباً جديداً.
  • أطفئ VPN واستخدم إنترنت ثابتاً.
  • أنشئ تطبيقاً واحداً فقط؛ لا تنشئ تطبيقات إضافية ولا تحذفها مرة بعد مرة.
  • فعّل رقم الهاتف والتحقق بخطوتين في حساب فيسبوك.
  • إذا طلبت Meta التحقق من الهوية، أكمله فوراً.
روابط مباشرة (انقر)دليل الحساب الاحترافي في إنستغرام ↗إنشاء تطبيق في Meta for Developers ↗تطبيقاتي في Meta for Developers ↗الدليل الرسمي لإنشاء تطبيق إنستغرام ↗دعوات Tester في إنستغرام ↗الدليل الرسمي لـ Business login ↗الدليل الرسمي لـ Webhooks إنستغرام ↗دليل «Allow access to messages» ↗الدليل الرسمي لوضعي Development و Live ↗

في اللوحة: الإعدادات ← بطاقة إنستغرام. يحتوي الدليل داخل البطاقة على هذه الخطوات نفسها، مع زر النسخ ورابط مباشر لصفحة تطبيقك وعلامة تلقائية للخطوات التي يتحقق منها البرنامج بنفسه. وفي أعلى البطاقة شريط من ثلاث مراحل «المفاتيح صحيحة ← تم تأكيد webhook ← وصلت أول رسالة» يبيّن أين أنت، ويكتب السبب بالأحمر إذا تعطّل شيء.

  1. اضبط أولاً بطاقة «العنوان العام» على عنوان ثابت (نفق Cloudflare بنطاقك، أو ngrok بنطاق ثابت مجاني).ما الذي تراه: بطاقة «العنوان العام» خضراء بعنوان لا يحتوي trycloudflare.⚠️ خطأ شائع: البقاء على العنوان «المؤقت»: تحتفظ Meta بالعناوين القديمة وتنقطع الرسائل بعد كل تشغيل.
  2. Create app ← اسم التطبيق ← حالة الاستخدام «Manage messaging & content on Instagram» (ولواتساب اختر أيضاً «Connect with customers through WhatsApp») ← Business portfolio الخاص بك ← Create app. ثم الصق عنوان المتصفح في مربع «تطبيق Meta».ما الذي تراه: قائمة حالات الاستخدام ثم لوحة التطبيق الجديد.⚠️ خطأ شائع: إنشاء عدة تطبيقات، أو الدخول بحساب فيسبوك جديد أو مع VPN — قد يُحظر الحساب.
  3. App settings ← Basic: الصق «App secret» (Show) في مربع «تطبيق Meta»؛ والصق «Privacy policy URL» و«User data deletion» أدناه هناك أيضاً ثم «Save changes».ما الذي تراه: «App ID» و«App secret» أعلى الصفحة، وخانتا Privacy policy URL وUser data deletion.⚠️ خطأ شائع: هذا هو App secret الرئيسي، وليس Instagram app secret (ذاك في الخطوة التالية).
  4. Use cases ← «Manage messaging & content on Instagram» ← Customize ← «API setup with Instagram login»: في «Add required messaging permissions» اضغط «Add all required permissions»؛ ثم الصق «Instagram app ID» و«Instagram app secret» في هذه البطاقة و«حفظ واختبار».ما الذي تراه: صفحة من 5 مراحل؛ وفي أعلاها «Instagram app ID» و«Instagram app secret» (Show).⚠️ خطأ شائع: لصق Meta App ID / App secret هنا — ينبّه البرنامج إذا كانا متطابقين.
  5. في الصفحة نفسها «Set up Instagram business login» ← «Business login settings»: الصق العناوين الثلاثة أدناه في «OAuth redirect URIs» و«Deauthorize callback URL» و«Data deletion request URL» ثم Save.ما الذي تراه: نافذة Business login settings بثلاث خانات للعناوين.⚠️ خطأ شائع: علامة «/» زائدة في آخر العنوان، أو العنوان المؤقت القديم.
  6. هذه الخطوة يقوم بها البرنامج بنفسه (بمربع «تطبيق Meta»): Callback URL وVerify token والحقول messages وmessaging_postbacks وcomments. فقط إذا ظهر خطأ الصق الصفوف أدناه في «Configure webhooks» ثم «Verify and save» وSubscribe.ما الذي تراه: في «Configure webhooks» تكتب Meta: «To receive webhooks, your app must be in published state».⚠️ خطأ شائع: يُرفض «Verify and save» مع عنوان مؤقت أو عندما يكون البرنامج مطفأً.
  7. App roles ← Roles ← Add People ← Instagram Tester ← اسم مستخدم الصفحة؛ ثم في instagram.com: Settings ← Website permissions ← Apps and websites ← Tester invites ← Accept.ما الذي تراه: دعوة معلّقة (Pending) حتى تقبلها في إنستغرام.⚠️ خطأ شائع: دعوة حساب شخصي، أو نسيان Accept في instagram.com (بدونه يفشل «تسجيل الدخول عبر إنستغرام»).
  8. اضغط «تسجيل الدخول عبر إنستغرام» في هذه البطاقة وادخل بالحساب الاحترافي للصفحة؛ ثم في الهاتف: Settings ← Messages and story replies ← Message requests ← Connected tools ← فعّل Allow access to messages.ما الذي تراه: صفحة دخول إنستغرام (على ngrok المجاني أولاً «Visit Site»)، ثم «تم ربط إنستغرام».⚠️ خطأ شائع: حساب شخصي (حوّله أولاً إلى Business أو Creator)، أو حساب إنستغرام آخر مفتوح في المتصفح نفسه.
  9. صفحة Publish للتطبيق ← Publish. ثم أرسل رسالة مباشرة للصفحة من هاتف آخر واضغط «أرسلت رسالة تجريبية».ما الذي تراه: زر Publish ثم الحالة «Published».⚠️ خطأ شائع: بدون Publish لا ترسل Meta أي رسالة. قبل App Review تعمل فقط الحسابات التي لها دور في التطبيق.

المربع المشترك «تطبيق Meta» (لإنستغرام وواتساب)

يكفي تطبيق Meta واحد للقناتين. اكتب Meta App ID وApp secret الرئيسي (App settings ← Basic) مرة واحدة في بطاقة تطبيق Meta. به يتحقق البرنامج من توقيع رسائل واتساب، ويسجّل webhooks إنستغرام وواتساب في Meta بنفسه (POST /subscriptions) ويحدّثها كلما تغيّر العنوان العام. ليس Instagram app secret — ذاك في صفحة «API setup with Instagram login» ومكانه بطاقة إنستغرام.

  1. افتح التطبيق (أو أنشئه) والصق عنوان المتصفح في خانة «Meta App ID»؛ يُستخرج المعرّف منه تلقائياً.ما الذي تراه: عنوان مثل developers.facebook.com/apps/1234…/ و«App ID» أعلى الصفحة.⚠️ خطأ شائع: إنشاء تطبيق ثانٍ أو الدخول بحساب فيسبوك جديد؛ احتفظ بالتطبيق نفسه للقناتين.
  2. في App settings ← Basic اضغط Show بجانب «App secret»، وانسخه والصقه في خانة «App secret الرئيسي» واضغط «حفظ واختبار».ما الذي تراه: «App ID» و«App secret» (مع زر Show) أعلى صفحة Basic.⚠️ خطأ شائع: هذا ليس Instagram app secret — ذاك في صفحة «API setup with Instagram login» ومكانه بطاقة إنستغرام.
  3. في الصفحة نفسها الصق «Privacy policy URL» و«User data deletion» من الصفوف أدناه، واختر «Category» وضع «App icon» بحجم 1024×1024، ثم «Save changes».ما الذي تراه: خانات Privacy policy URL وUser data deletion وCategory وApp icon.⚠️ خطأ شائع: بدونها لا يعمل زر Publish؛ ويجب ألا تحمل الأيقونة شعار Meta أو إنستغرام.
لكل العملاء (لاحقاً): قبل App Review تعمل فقط الحسابات التي لها دور في التطبيق. للرد على أي شخص: Business verification للنشاط + App Review لـ instagram_business_manage_messages (والتعليقات). رمز إنستغرام صالح 60 يوماً ويجدّده البرنامج بنفسه؛ وإن فشل التجديد ينبّهك قبل 7 أيام من الانتهاء.