Meta App Review

Instagram Messaging & Webhooks — Reviewer Guide

Everything a Meta reviewer needs to validate AiCentra-IG: what the app does, which permissions it requests and why, how to reproduce each permission’s use, and which public callbacks are exposed.

App mode: Development. Only test webhooks are delivered in this mode. Production webhook delivery begins after App Review is approved and the app is switched to Live. Test accounts listed below are already connected.

1) App identity & purpose

App nameAiCentra-IG
App ID—
Login productInstagram API with Instagram Login
Graph API versionv25.0
Public base URL(PUBLIC_APP_URL not configured)
App modedevelopment

Purpose. AiCentra-IG lets the owner of an Instagram professional account automate their own inbound conversations. The owner defines scenarios — for example “when a comment on my post contains a keyword, post a public reply and send the commenter a private reply”, or “when someone sends a first direct message, send a welcome message”. The app only ever reacts to events on accounts the user has connected and consented to, and it never posts content the user did not configure.

2) Test credentials for reviewers

Test credentials are not configured in this environment.

They are supplied through the environment variables META_REVIEW_TEST_USERNAME, META_REVIEW_TEST_PASSWORD and META_REVIEW_TEST_IG_ACCOUNTS, and are intentionally not hardcoded in the source tree. Set them before submitting for review; this section then renders the credentials automatically.

3) Step-by-step usage walkthrough

Follow these steps in order to exercise every requested permission.

  1. ورود با نام کاربری آزمایشی
    با اطلاعات ورود آزمایشی که در همین صفحه آمده وارد شوید. زبان صفحه را می‌توانید از سوئیچ زبان روی English بگذارید.
    Path: /accounts/login/
  2. اتصال حساب حرفه‌ای اینستاگرام instagram_business_basic
    روی «اتصال حساب اینستاگرام» بزنید. پنجره رسمی Instagram Login باز می‌شود و دسترسی‌ها را نمایش می‌دهد. پس از تأیید، حساب در فهرست ظاهر می‌شود. حساب‌های آزمایشی از قبل متصل هستند.
    Path: /instagram/accounts/
  3. ساخت سناریو با ویزارد یکپارچه
    به «ساخت سناریو» بروید. در گام ۰ نوع سناریو را انتخاب کنید، سپس حساب، تریگر (کلیدواژه و دامنه اجرا) و اکشن را تنظیم کنید و در گام ۴ خلاصه را ببینید.
    Path: /automation/scenarios/create/
  4. آزمون «پاسخ خودکار به کامنت» instagram_business_manage_comments
    روی یکی از پست‌های حساب آزمایشی کامنتی بگذارید که کلیدواژه سناریو را داشته باشد. سامانه پاسخ عمومی زیر کامنت و در صورت تنظیم، پاسخ خصوصی برای نویسنده ارسال می‌کند. نتیجه در «لاگ رویدادها» ثبت می‌شود.
    Path: /automation/events/
  5. آزمون «پاسخ خودکار به دایرکت» instagram_business_manage_messages
    از یک حساب دیگر به حساب آزمایشی دایرکت بفرستید. پیام خوش‌آمد تنظیم‌شده ارسال می‌شود و رویداد با وضعیت executed در لاگ دیده می‌شود.
    Path: /automation/events/
  6. بازبینی لاگ و تشخیص وبهوک
    در «تشخیص وبهوک» می‌توانید صحت امضای X-Hub-Signature-256، آخرین رویداد دریافتی هر حساب و وضعیت اشتراک فیلدها را ببینید.
    Path: /admin/webhooks/diagnostics/
  7. حذف داده
    در صفحه «حذف داده» می‌توانید درخواست حذف ثبت کنید و فهرست دقیق داده‌هایی که حذف می‌شوند را ببینید.
    Path: /data-deletion/

4) Screencast

Screencast placeholder.

The screen recording URL is supplied through the META_REVIEW_SCREENCAST_URL environment variable and will render here once set.

Planned recording contents, in one uninterrupted take, matching Meta’s screen-recording guidance:

  1. Sign in with the test credentials above.
  2. Start the Instagram connection and show the official Instagram Login consent screen with the requested permissions visible.
  3. Create a “reply to comments” scenario through the unified wizard, including keyword and execution scope.
  4. Post a comment from a second account and show the public reply and private reply arriving in Instagram itself.
  5. Send a direct message from a second account and show the welcome reply arriving.
  6. Open the event log and the webhook diagnostics page to show the processed events.
  7. Open the data-deletion page and disconnect the account.

5) Feature ↔ permission mapping

This app uses Instagram API with Instagram Login, whose permission strings are the instagram_business_* family. The legacy names from the older Instagram-Graph-API-via-Facebook-Login product are shown alongside for cross-reference.

Permission Status Feature Why it is required End-user benefit
instagram_business_basic
legacy: instagram_basic
Requested اتصال حساب حرفه‌ای اینستاگرام و نمایش آن در داشبورد بدون این دسترسی امکان شناسایی حساب متصل‌شده (شناسه، نام کاربری، نوع حساب) وجود ندارد و هیچ سناریوی اتوماسیونی نمی‌تواند به یک حساب مشخص نسبت داده شود.
  • GET /me
  • GET /{ig-user-id}?fields=id,username,account_type
کاربر می‌بیند کدام حساب متصل است، وضعیت سلامت اتصال را می‌بیند و می‌تواند اتصال را قطع کند.
instagram_business_manage_messages
legacy: instagram_messaging
Requested پاسخ هوشمند به دایرکت (DM) و پیام خوش‌آمد قابلیت اصلی محصول، پاسخ خودکار به دایرکت‌های ورودی است. ارسال پاسخ از طریق POST /{ig-user-id}/messages تنها با این دسترسی ممکن است و دریافت رویداد messages نیز به آن وابسته است.
  • POST /{ig-user-id}/messages
  • POST /{ig-user-id}/messages (sender_action=mark_seen)
کاربر بدون حضور ۲۴ ساعته، به پیام مشتریان در پنجره ۲۴ ساعته پاسخ می‌دهد و نرخ پاسخ‌گویی حسابش حفظ می‌شود.
instagram_business_manage_comments
legacy: instagram_manage_comments
Requested پاسخ خودکار به کامنت و منشن + مدیریت اسپم (پنهان‌سازی/حذف) برای خواندن کامنت‌های ورودی، ارسال پاسخ عمومی زیر کامنت، ارسال پاسخ خصوصی به نویسنده کامنت، و پنهان‌سازی یا حذف کامنت اسپم — همه از همین دسترسی استفاده می‌کنند.
  • POST /{ig-media-id}/comments
  • POST /{ig-comment-id}/replies
  • POST /{ig-comment-id}?hide=true
  • DELETE /{ig-comment-id}
  • GET /{ig-media-id}/comments
کامنت‌های پرتکرار خودکار پاسخ می‌گیرند و اسپم بدون رسیدگی دستی پنهان می‌شود.
instagram_business_manage_insights
legacy: instagram_manage_insights
Not requested گزارش عملکرد سناریوها بر پایه آمار حساب (نقشه راه) در نسخه فعلی هیچ فراخوانی insights انجام نمی‌شود؛ آمار داشبورد تنها از لاگ اجرای داخلی خودِ سامانه محاسبه می‌شود. این ردیف برای شفافیت اعلام شده و در این ارسال درخواست نمی‌شود. —
instagram_business_content_publish
legacy: instagram_content_publish
Not requested انتشار محتوا از داخل سامانه (نقشه راه) سامانه در وضعیت فعلی هیچ محتوایی منتشر نمی‌کند و فقط به رویدادهای ورودی پاسخ می‌دهد. درخواست نشده است. —
pages_messaging
legacy: pages_messaging
Not requested پیام‌رسانی از طریق صفحه فیس‌بوک متصل این محصول از Instagram Login استفاده می‌کند و نه Facebook Login؛ هیچ صفحه فیس‌بوکی واسطه نیست، بنابراین این دسترسی موضوعیت ندارد و درخواست نمی‌شود. —

Permissions marked Not requested are listed for transparency only: the corresponding code paths make no API calls in the current release, so the app does not ask for them.

6) Webhook subscriptions

Verification endpoint (GET with hub.mode=subscribe, hub.challenge, hub.verify_token) and event delivery (POST signed with X-Hub-Signature-256) share one public HTTPS URL: /webhooks/instagram/

Field Purpose Handled by
comments کامنت جدید روی پست‌های حساب متصل apps.instagram.webhook_bridge → automation engine
live_comments کامنت در پخش زنده apps.instagram.webhook_bridge → live console
mentions منشن حساب در کامنت یا کپشن دیگران apps.instagram.webhook_bridge → automation engine
messages دایرکت ورودی (شامل پاسخ به استوری) apps.instagram.webhook_bridge → automation engine
messaging_postbacks کلیک روی دکمه/پاسخ سریع در دایرکت apps.instagram.webhook_bridge → automation engine
messaging_optins اعلام رضایت کاربر برای دریافت پیام apps.instagram.webhook_bridge → consent log
feed_update انتشار/به‌روزرسانی پست، برای همگام‌سازی آینه رسانه‌ها apps.instagram.webhook_bridge → InstagramMedia mirror
  • Payloads whose signature does not verify are rejected with HTTP 401 and never processed.
  • Signature-valid payloads always receive HTTP 200 immediately; processing is asynchronous, so Meta is never made to wait on our work queue.
  • Every delivery is persisted before processing and retried with bounded backoff on transient failure.

7) Public URLs & callbacks

Purpose URL Method
کال‌بک وبهوک اینستاگرام (verify + رویدادها) (PUBLIC_APP_URL not configured) GET (verify) / POST (events)
کال‌بک لغو دسترسی (Deauthorize) (PUBLIC_APP_URL not configured) POST
کال‌بک درخواست حذف داده (Data Deletion Request) (PUBLIC_APP_URL not configured) POST
صفحه دستورالعمل حذف داده (Data Deletion Instructions) (PUBLIC_APP_URL not configured) GET
سیاست حریم خصوصی (Privacy Policy URL) (PUBLIC_APP_URL not configured) GET
شرایط استفاده (Terms of Service URL) (PUBLIC_APP_URL not configured) GET

8) Data handling summary

  • No Instagram password is ever requested or stored; authentication is exclusively the official Instagram Login OAuth flow.
  • Access tokens are stored only to operate the connection the user authorised, and are invalidated on disconnect or deauthorization.
  • Instagram content is used solely to evaluate the user’s own automation rules. It is not sold, not used for advertising, and not used to train AI models.
  • Deletion routes, and the exact list of what is deleted, are published at /data-deletion/.

Full documents: Privacy Policy · Terms of Service · Data Deletion

9) Legacy permission-name cross-reference

Name in older documentation Permission actually used here
instagram_basic instagram_business_basic
instagram_content_publish instagram_business_content_publish
instagram_manage_comments instagram_business_manage_comments
instagram_manage_insights instagram_business_manage_insights
instagram_manage_messages instagram_business_manage_messages
instagram_messaging instagram_business_manage_messages