Как пользоваться

Instagram Graph API отдаёт данные только для business или creator аккаунтов. Personal-аккаунты не поддерживаются. Также аккаунт должен быть связан с Facebook Page — это обязательное требование Meta.

1. Откройте Instagram → Settings → Switch to professional account.
2. Тип: Creator (для блогеров) или Business.
3. Выберите категорию (блогер, автор контента и т.п.).
4. В настройках Instagram откройте Linked accounts → Facebook и привяжите Facebook Page. Без связанной Page Instagram Graph API не работает — это явно указано в Getting Started.

Meta App — «приложение-посредник» между AI Producer и Instagram. Создаётся бесплатно на Facebook Developers. Делается один раз. Интерфейс Meta периодически меняется — если ваш экран отличается, ищите пункты со словами Instagram и content.

1. Откройте developers.facebook.com/apps/creation, войдите Facebook-аккаунтом.
2. Поле App Display Name — любое имя (например, AI Producer). Поле App contact email — ваш email.
3. На экране Use cases выберите карту Manage Instagram content and messages. Если название отличается (Meta меняет wording) — выберите вариант со словами Instagram и content. Несовместимые опции погашены серым.
4. App type — выберите Business. Тип Consumer не поддерживает Instagram Graph API.
5. Business account — для теста выберите I don't want to connect a business portfolio yet.
6. Нажмите Create app. Продукт Instagram добавится автоматически вместе с use case.
7. В дашборде: левое меню → App Settings → Basic. Вверху страницы — два ключа:

   Скопируйте эти значения

   App ID

   → это INSTAGRAM_CLIENT_ID

   App Secret (кнопка Show)

   → это INSTAGRAM_CLIENT_SECRET

8. В разделе App Settings → Basic найдите поле Valid OAuth Redirect URIs (или Products → Instagram → Settings) и добавьте:http://localhost:3030/api/instagram/callbackНажмите Save changes.
9. Для dev-режима: Roles → Instagram Testers → добавьте свой Instagram-username. Пользователь получит приглашение в Instagram — примите его в Settings → Apps and websites.

Полученные App ID и App Secret нужно добавить в файл .env в корне проекта:

INSTAGRAM_CLIENT_ID=ваш_app_id
INSTAGRAM_CLIENT_SECRET=ваш_app_secret
INSTAGRAM_REDIRECT_URI=http://localhost:3030/api/instagram/callback

После изменения .env перезапустите dev-сервер (pnpm dev), чтобы переменные применились.

Когда креды добавлены — подключение занимает один клик:

1. Перейдите в раздел Подключения в верхнем меню.
2. Нажмите «Подключить Instagram».
3. Вы будете перенаправлены на страницу Instagram — разрешите доступ.
4. После согласия вернётесь обратно, аккаунт отобразится как активный.

Если при нажатии «Подключить Instagram» диалог Instagram не появляется — проблема не в коде, а в настройке Meta App или аккаунта. Ниже — пошаговый диагностический путь от самой частой причины к редким.

Диаграмма барьеров (проходите по порядку):

1. «HTTP ERROR 429» на api.instagram.com
      → IP временно заблокирован Instagram. Подождите 30 мин.

2. «Invalid platform app»
      → Instagram-продукт не активирован в App.
      → Шаг 2b: добавьте use case «Manage Instagram content and messages».

3. «Недостаточно прав для роли разработчика»
      → Ваш Facebook не Admin этого App.
      → Войдите тем FB, которым создавался App.

4. «You don't have access / feature isn't available» на developers.facebook.com
      → Facebook-аккаунт не может создавать Apps.
      → См. проверки ниже (регион / верификация / VPN).

5. Диалог Instagram пустой или редирект с access_denied
      → Вы не в Instagram Testers ИЛИ personal-аккаунт.
      → Шаг 2b → Roles → Instagram Testers → принять приглашение.

Проверка 1: вы залогинены в Facebook?

Meta Developers работает только с Facebook-аккаунтом, не с Instagram. Откройте facebook.com — вы должны видеть свою ленту/профиль, а не форму входа.

Проверка 2: доступ к Developers

Откройте developers.facebook.com/apps под тем Facebook, которым создавали App. Должен быть виден ваш App. Если «feature isn't available» — переходите к проверке 3.

Проверка 3: регион аккаунта

Meta ограничивает Developers для некоторых регионов (включая РФ, РБ). Проверьте: facebook.com → профиль → About → Contact and Basic Info → поле Country. Если указана ограниченная страна — Developers будет недоступен с этого аккаунта.

Проверка 4: верификация аккаунта

Facebook-аккаунт должен соответствовать требованиям Meta:

1. facebook.com/settings → General → email подтверждён (галочка)
2. Телефон подтверждён в Mobile
3. Security and Login → Two-Factor Authentication включена
4. Аккаунту более 30 дней (Meta блокирует свежие)

Если ничего не помогло — пересоздать App

1. Создайте новый App на developers.facebook.com/apps/creation строго по шагам:
2. Use case: Manage Instagram content and messages
3. App type: Business
4. Business portfolio: I don't want to connect a business portfolio yet (не привязывайте — иначе потеряете права)
5. Скопируйте новые App ID и App Secret → введите в Настройках