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.
1) App identity & purpose
| App name | AiCentra-IG |
|---|---|
| App ID | — |
| Login product | Instagram API with Instagram Login |
| Graph API version | v25.0 |
| Public base URL | (PUBLIC_APP_URL not configured) |
| App mode | development |
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.
-
ورود با نام کاربری آزمایشی
با اطلاعات ورود آزمایشی که در همین صفحه آمده وارد شوید. زبان صفحه را میتوانید از سوئیچ زبان روی English بگذارید.Path:
/accounts/login/ -
اتصال حساب حرفهای اینستاگرام
instagram_business_basic
روی «اتصال حساب اینستاگرام» بزنید. پنجره رسمی Instagram Login باز میشود و دسترسیها را نمایش میدهد. پس از تأیید، حساب در فهرست ظاهر میشود. حسابهای آزمایشی از قبل متصل هستند.Path:
/instagram/accounts/ -
ساخت سناریو با ویزارد یکپارچه
به «ساخت سناریو» بروید. در گام ۰ نوع سناریو را انتخاب کنید، سپس حساب، تریگر (کلیدواژه و دامنه اجرا) و اکشن را تنظیم کنید و در گام ۴ خلاصه را ببینید.Path:
/automation/scenarios/create/ -
آزمون «پاسخ خودکار به کامنت»
instagram_business_manage_comments
روی یکی از پستهای حساب آزمایشی کامنتی بگذارید که کلیدواژه سناریو را داشته باشد. سامانه پاسخ عمومی زیر کامنت و در صورت تنظیم، پاسخ خصوصی برای نویسنده ارسال میکند. نتیجه در «لاگ رویدادها» ثبت میشود.Path:
/automation/events/ -
آزمون «پاسخ خودکار به دایرکت»
instagram_business_manage_messages
از یک حساب دیگر به حساب آزمایشی دایرکت بفرستید. پیام خوشآمد تنظیمشده ارسال میشود و رویداد با وضعیت executed در لاگ دیده میشود.Path:
/automation/events/ -
بازبینی لاگ و تشخیص وبهوک
در «تشخیص وبهوک» میتوانید صحت امضای X-Hub-Signature-256، آخرین رویداد دریافتی هر حساب و وضعیت اشتراک فیلدها را ببینید.Path:
/admin/webhooks/diagnostics/ -
حذف داده
در صفحه «حذف داده» میتوانید درخواست حذف ثبت کنید و فهرست دقیق دادههایی که حذف میشوند را ببینید.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:
- Sign in with the test credentials above.
- Start the Instagram connection and show the official Instagram Login consent screen with the requested permissions visible.
- Create a “reply to comments” scenario through the unified wizard, including keyword and execution scope.
- Post a comment from a second account and show the public reply and private reply arriving in Instagram itself.
- Send a direct message from a second account and show the welcome reply arriving.
- Open the event log and the webhook diagnostics page to show the processed events.
- 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 | اتصال حساب حرفهای اینستاگرام و نمایش آن در داشبورد |
بدون این دسترسی امکان شناسایی حساب متصلشده (شناسه، نام کاربری، نوع حساب) وجود ندارد و هیچ سناریوی اتوماسیونی نمیتواند به یک حساب مشخص نسبت داده شود.
|
کاربر میبیند کدام حساب متصل است، وضعیت سلامت اتصال را میبیند و میتواند اتصال را قطع کند. |
instagram_business_manage_messages
legacy:
instagram_messaging |
Requested | پاسخ هوشمند به دایرکت (DM) و پیام خوشآمد |
قابلیت اصلی محصول، پاسخ خودکار به دایرکتهای ورودی است. ارسال پاسخ از طریق POST /{ig-user-id}/messages تنها با این دسترسی ممکن است و دریافت رویداد messages نیز به آن وابسته است.
|
کاربر بدون حضور ۲۴ ساعته، به پیام مشتریان در پنجره ۲۴ ساعته پاسخ میدهد و نرخ پاسخگویی حسابش حفظ میشود. |
instagram_business_manage_comments
legacy:
instagram_manage_comments |
Requested | پاسخ خودکار به کامنت و منشن + مدیریت اسپم (پنهانسازی/حذف) |
برای خواندن کامنتهای ورودی، ارسال پاسخ عمومی زیر کامنت، ارسال پاسخ خصوصی به نویسنده کامنت، و پنهانسازی یا حذف کامنت اسپم — همه از همین دسترسی استفاده میکنند.
|
کامنتهای پرتکرار خودکار پاسخ میگیرند و اسپم بدون رسیدگی دستی پنهان میشود. |
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 |