Приложение Meta и системный токен.

Если у вас ещё нет бизнес-аккаунта (портфолио) — создайте его. Это «контейнер» для всех активов: страниц Facebook, аккаунтов Instagram, приложений и системных пользователей.

Создать бизнес-портфолио

1. Перейдите на business.facebook.com/overview.
2. Нажмите Создать аккаунт.
3. Введите: название бизнеса, имя и фамилию владельца, рабочий email.
4. Нажмите Отправить и подтвердите.

После этого появится ваш бизнес-портфель с уникальным ID.

Создать приложение

1. Перейдите на developers.facebook.com/apps.
2. Войдите под той же учётной записью Meta.
3. В правом верхнем углу: Мои приложения → Создать приложение.
4. Выберите тип приложения: Бизнес.
5. Заполните: название, email разработчика, выберите свой бизнес-аккаунт.
6. Нажмите Создать приложение.

1. В меню слева выберите Настройки → Основные.
2. Проверьте, что у вас есть:
   • Идентификатор приложения (App ID);
   • Секрет приложения (App Secret);
   • URL сайта (Website URL).

Когда можно не указывать

• Приложение используется только для генерации системного токена вручную.
• Работаете через Business Manager и публикуете напрямую через токен, без сервера.

💡 Даже для внутренних задач — указание рабочего URL повышает доверие со стороны Meta и может предотвратить технические ограничения в будущем.

Краткая инструкция, как развернуть тестовый или рабочий сайт на Vercel и использовать его как технический домен для приложения Meta.

3. Переменные окружения

1. Откройте проект → Settings → Environment Variables.
2. Добавьте переменные:
   • FB_APP_ID — идентификатор приложения из Meta Developers.
   • FB_APP_SECRET — секрет приложения.

1. В панели приложения выберите Добавить сценарии использования.
2. В списке выберите: «Управление сообщениями и контентом в Instagram» — этот сценарий автоматически подключает Instagram Graph API и нужные разрешения.
3. Нажмите Настроить и пройдите шаги персонализации.
4. В мастере появятся шаги:
   • Добавить разрешения: instagram_business_basic, instagram_manage_comments, instagram_business_manage_messages;
   • Сгенерировать токен и добавить тестировщиков.

⚠ Это короткоживущий токен — только для ручного тестирования через Graph API Explorer. Можно продлить до 60 дней через endpoint exchange_token.

👉 Эти шаги можно пропустить, если работаете через Business Manager (см. Часть II). Важно только активировать сценарий, чтобы он отображался в списке.

Если получаете токен по Части II:

• Системный пользователь и системный токен заменяют тестировщиков;
• Разрешения выдаются при генерации токена в бизнес-портфолио;
• Токен генерируется не здесь, а в Системные пользователи → Business Manager.

Такой токен даёт права на публикацию от имени связанного Instagram Business Account без участия «тестировщика» и без входа через Facebook Login. Срок — 60 дней или дольше (до ручного отзыва).

5. Убедитесь, что сценарий отображается как активный — это значит, Instagram Graph API подключён.
6. При необходимости добавьте сценарий Вход через Facebook (нужен для user-токенов, для системного доступа не обязателен).

1. В меню выберите Роли → Роли приложения.
2. Убедитесь, что вы Администратор.
3. При необходимости добавьте других пользователей: разработчиков, тестировщиков.

1. Перейдите на business.facebook.com/settings.
2. В меню слева: Аккаунты → Приложения.
3. Нажмите Добавить → Добавить приложение.
4. Введите App ID и подтвердите.

1. Перейдите на business.facebook.com/settings.
2. Откройте Аккаунты → Страницы — убедитесь, что нужная страница есть.
3. Откройте Аккаунты → Аккаунты Instagram — убедитесь, что Instagram привязан.
4. Если нет — добавьте через Центр аккаунтов → Аккаунты и профили.

1. В меню слева: Пользователи → Системные пользователи.
2. Нажмите Добавить.
3. Введите имя (например, Test_autopost), выберите тип доступа: Полный контроль.
4. Сохраните.

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

1. В карточке системного пользователя нажмите Сгенерировать маркер.
2. Выберите приложение.
3. Отметьте разрешения:
   • instagram_basic
   • instagram_content_publish
   • instagram_manage_insights
   • pages_read_engagement
   • pages_show_list
   • business_management
4. Скопируйте токен и сохраните в надёжном месте.

💡 Вывод: токен из мастера сценария (User Access Token) — только для тестирования. Для рабочих интеграций и автопостинга используйте системный токен (System User Token), созданный в Business Manager.

1. Убедитесь, что Instagram-аккаунт подключён к странице Facebook через Центр аккаунтов.
2. В Business Manager: Аккаунты → Аккаунты Instagram — скопируйте ID (начинается с 1784…).
3. Если ID не виден — запросите через Graph API:

curl -X GET "https://graph.facebook.com/v21.0/{PAGE_ID}?fields=connected_instagram_account{id,username}&access_token={ACCESS_TOKEN}"

В ответе:

"connected_instagram_account": {
  "id": "17841477721935556",
  "username": "ваше_имя_в_Instagram"
}

Первый шаг к публикации — создание временного объекта (контейнера) с изображением и подписью.

curl -X POST \
  "https://graph.facebook.com/v21.0/{IG_BUSINESS_ID}/media" \
  -F "image_url=https://example.com/image.jpg" \
  -F "caption=Тестовая публикация 🚀" \
  -F "access_token={ACCESS_TOKEN}"

В ответе:

{ "id": "CREATION_ID" }

Можно убедиться, что изображение загружено и готово к публикации:

curl -X GET \
  "https://graph.facebook.com/v21.0/{CREATION_ID}?fields=status_code&access_token={ACCESS_TOKEN}"

Ожидаемый ответ: { "status_code": "FINISHED" }

Опубликуйте загруженный контейнер:

curl -X POST \
  "https://graph.facebook.com/v21.0/{IG_BUSINESS_ID}/media_publish" \
  -F "creation_id={CREATION_ID}" \
  -F "access_token={ACCESS_TOKEN}"

В ответе: { "id": "PUBLISHED_MEDIA_ID" } — ID опубликованного поста.

curl -X GET \
  "https://graph.facebook.com/v21.0/{PUBLISHED_MEDIA_ID}?fields=permalink,caption,timestamp&access_token={ACCESS_TOKEN}"

Пример ответа:

{
  "permalink": "https://www.instagram.com/p/ABC123xyz/",
  "caption": "Тестовая публикация 🚀",
  "timestamp": "2025-11-12T09:00:00+0000"
}

💡 Рекомендация:

• Graph API Explorer — для проверки токенов и отладки GET-запросов.
• Терминал или сервер (cURL/Postman) — для публикаций и автоматизации.
• Всегда используйте актуальную версию API (например, v21.0).