اتصال اینستاگرام (۹ قدم)

در پنل: تنظیمات ← کارت اینستاگرام. راهنمای داخل کارت همین قدم‌ها را دارد، با دکمه‌ی کپی، پیوند مستقیم به صفحه‌ی اپ خودتان و تیک خودکار برای قدم‌هایی که برنامه خودش بررسی می‌کند. بالای کارت نوار سه‌مرحله‌ای «کلیدها درست ← webhook تأیید شد ← اولین پیام رسید» می‌گوید کجای کار هستید و اگر چیزی گیر کرده باشد، دلیلش را با رنگ قرمز می‌نویسد.

1. اول کارت «آدرس عمومی» را روی یک آدرس ثابت بگذارید (تونل Cloudflare با دامنه‌ی خودتان، یا ngrok با دامنه‌ی ثابت رایگان).چه می‌بینید: کارت «آدرس عمومی» سبز با آدرسی که trycloudflare ندارد.⚠️ اشتباه رایج: ماندن روی آدرس «موقت»: متا آدرس‌های قدیمی را نگه می‌دارد و بعد از هر روشن شدن پیام‌ها قطع می‌شود.
2. Create app ← نام اپ ← use case «Manage messaging & content on Instagram» (برای واتساپ هم «Connect with customers through WhatsApp» را تیک بزنید) ← Business portfolio خودتان ← Create app. بعد آدرس مرورگر را در کادر «اپ متا» بچسبانید.چه می‌بینید: فهرست use caseها و بعد داشبورد اپ تازه.⚠️ اشتباه رایج: ساختن چند اپ، ورود با حساب فیسبوک تازه یا VPN روشن — ممکن است حساب مسدود شود.
3. App settings ← Basic: «App secret» (Show) را در کادر «اپ متا» بچسبانید؛ «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» را در همین کارت بچسبانید و «ذخیره و تست».چه می‌بینید: صفحه‌ای با ۵ مرحله؛ «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. این قدم را برنامه خودش انجام می‌دهد (با کادر «اپ متا»): Callback URL، Verify token و فیلدهای messages، messaging_postbacks و comments. فقط اگر خطا داد، ردیف‌های زیر را در «Configure webhooks» بچسبانید، «Verify and save» و Subscribe.چه می‌بینید: در «Configure webhooks» متا نوشته: «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 متا هیچ پیامی نمی‌فرستد. پیش از App Review فقط حساب‌هایی که در اپ نقش دارند کار می‌کنند.

کادر مشترک «اپ متا» (برای اینستاگرام و واتساپ)

یک اپ متا برای هر دو کانال کافی است. Meta App ID و App secret اصلی (App settings ← Basic) را یک بار در کارت اپ متا بنویسید. برنامه با آن امضای پیام‌های واتساپ را بررسی می‌کند، webhookهای اینستاگرام و واتساپ را خودش در متا ثبت می‌کند (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 کنار «App secret» دکمه‌ی Show را بزنید، آن را کپی و در کادر «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» ۱۰۲۴×۱۰۲۴ بگذارید، بعد «Save changes».چه می‌بینید: کادرهای Privacy policy URL، User data deletion، Category و App icon.⚠️ اشتباه رایج: بدون این‌ها دکمه‌ی Publish کار نمی‌کند؛ آیکن نباید لوگوی متا یا اینستاگرام داشته باشد.