Памятка по созданию приложения Meta и получению системного токена

Лайфхаки и инструкции

Памятка по созданию приложения Meta и получению системного токена

Эта пошаговая инструкция поможет создать приложение в Meta Developers, связать его с бизнес-портфолио в Meta Business Manager и получить системный токен для автоматической публикации постов в Instagram через Graph API.

ЧАСТЬ I — СОЗДАНИЕ ПРИЛОЖЕНИЯ В META ДЛЯ РАЗРАБОТЧИКОВ

Шаг 1. Создание бизнес-портфолио (бизнес-аккаунта Meta) и приложения

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

Перейдите на https://business.facebook.com/overview
Нажмите «Создать аккаунт».
Введите: название бизнеса, имя и фамилию владельца, рабочий email.
Нажмите «Отправить» и подтвердите.
После этого появится ваш бизнес-портфель (Business Account) с уникальным ID.

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

Шаг 2. Базовые настройки приложения

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

• URL сайта (Website URL). URL сайта (Website URL) в настройках приложения Meta указывается на странице «Настройки приложения → Основное». Этот параметр используется Meta для проверки домена, через который приложение взаимодействует с API.

Когда указывать обязательно:

• Если вы используете серверное приложение (например, размещённое на Vercel, AWS, Render и т.д.).
• Если используется авторизация (Facebook Login, OAuth или Redirect URI).
• Если приложение будет автоматически публиковать посты, получать токены или обмениваться данными с API.

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

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

Пример корректного заполнения:

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

Памятка: как создать сайт на Vercel для приложения Meta

Эта краткая инструкция поможет создать и развернуть тестовый или рабочий сайт на платформе Vercel, который можно использовать как технический домен для приложения Meta (например, для URL сайта в Meta Developersили получения токенов через сервер).

1️⃣ Регистрация и вход
1. Перейдите на сайт https://vercel.com.
2. Войдите через GitHub, GitLab или Email.
3. После входа вы окажетесь в личной панели управления Vercel.

2️⃣ Создание нового проекта
1. Нажмите «New Project» → «Add New…».
2. Выберите репозиторий из GitHub (если проект хранится там) или создайте вручную (опция «Import Project Manually»).
3. Введите имя проекта, например: insta-auth-server.
4. Нажмите «Deploy». Через несколько секунд ваш сайт будет опубликован.
Пример адреса: https://insta-auth-server.vercel.app/

3️⃣ Добавление переменных окружения
1. Откройте проект → вкладка «Settings» → раздел «Environment Variables».
2. Добавьте переменные, необходимые для вашего приложения:
• FB_APP_ID — идентификатор приложения из Meta Developers.
• FB_APP_SECRET — секрет приложения.

4️⃣ Указание URL в Meta Developers
1. Перейдите в Meta Developers → Настройки приложения → Основное.
2. Найдите раздел «Веб-сайт (Website URL)».
3. Вставьте адрес вашего сайта:
https://<ваш-проект>.vercel.app/
4. Нажмите «Сохранить изменения».

5️⃣ Проверка работы сайта

Перейдите в браузере по адресу вашего проекта (например, https://insta-auth-server.vercel.app/).
Если открывается страница (даже простая надпись «Hello World») — сайт успешно развернут.
Этот URL можно использовать как доверенный домен в Meta Developers, для API-запросов и токенов.

💡 Итог
После этих шагов у вас будет полноценный сервер на Vercel, который можно использовать для интеграции с MetaAPI. Вы сможете размещать свои скрипты, получать и обновлять токены, а также выполнять автоматические публикации.

Шаг 3. Добавление продуктов

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

ЭТО КОРОТКОЖИВУЩИЙ ТОКЕН, Он нужен только для тестирования API-запросов вручную через Graph API Explorer. Он может быть продлён до 60 дней (через endpoint exchange_token)

👉 Эти шаги можно пропустить, если вы работаете через Business Manager (шаги описаны в части II**). **Важно только активировать сценарий «Управление сообщениями и контентом в Instagram», чтобы он появился как активный в списке. Если получать токен через инструкцию в ЧАСТЬ II, то:

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

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

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

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

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

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

ЧАСТЬ II — НАСТРОЙКА СВЯЗЕЙ И ПОЛУЧЕНИЕ СИСТЕМНОГО ТОКЕНА ЧЕРЕЗ BUSINESSFACEBOOK

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

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

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

Сравнение токенов: пользовательский vs системный

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

ПУБЛИКАЦИЯ В INSTAGRAM ЧЕРЕЗ GRAPH API
После того как приложение создано, привязано к бизнес-портфолио и у вас есть системный токен, можно переходить к публикации в Instagram через Graph API.

Шаг 1. Получение Instagram Business ID

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

curl -X GET https://graph.facebook.com/v21.0/{PAGEID}?fields=connected_instagram_account{id,username}&access_token={ACCESS_TOKEN}
В ответе Вы увидите:
"connected_instagram_account": {
"id": "17841477721935556",
"username": "ваше_имя_в_Instagram"
}

Шаг 2. Создание контейнера публикации
Это первый шаг к публикации поста — создание временного объекта (контейнера) с изображением и подписью.
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" }

Шаг 3. Проверка статуса контейнера (необязательно)
Можно убедиться, что изображение загружено и готово к публикации:
curl -X GET \
"https://graph.facebook.com/v21.0/{CREATIONID}?fields=status_code&access_token={ACCESS_TOKEN}"
Ожидаемый ответ: { "status_code": "FINISHED" }

Шаг 4. Публикация поста
Теперь можно опубликовать загруженный контейнер в Instagram:
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 опубликованного поста.

Шаг 5. Получение ссылки на пост
Чтобы получить прямую ссылку на опубликованный пост:
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 vs Терминал

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

_{Meta Platforms*, а также принадлежащие ей социальные сети Facebook** и Instagram**}
_{* — признана экстремистской организацией, её деятельность в России запрещена}
_{** — запрещены в России}

Задайте нам вопрос

Укажите ваше имя, тему вопроса

Отправить сообщение

Мы ответим на все ваши вопросы и поможем с настройкой бота