Подключите Meta с помощью токена (System User)

Шаг 1 — Откройте настройки бизнеса

Перейдите в Meta Business Manager и войдите под аккаунтом администратора.

Открыть Meta Business Settings

ℹ️ Если вы управляете несколькими бизнесами, проверьте в левом верхнем углу, что выбран правильный — тот, которому принадлежит рекламный аккаунт.

Шаг 2 — Создайте системного пользователя

System User — это «технический пользователь» бизнеса, созданный специально для интеграций.

1. В левом меню перейдите в Users → System users.
2. Нажмите Add.
3. Дайте узнаваемое название, например RoyLead Sync.
4. Роль: Employee — достаточно доступа на чтение, Admin не нужен. Нажмите Create system user.

Шаг 3 — Назначьте рекламный аккаунт

Токен работает только с активами, которые вы явно назначите этому пользователю.

1. При выбранном системном пользователе нажмите Assign assets.
2. В разделе Ad accounts выберите аккаунт, который хотите подключить.
3. В разрешениях включите только переключатель «View performance» (в разделе Partial access): это доступ на чтение, необходимый для ads_read. Оставьте «Manage campaigns» и «Full control» выключенными.
4. Нажмите Assign assets.

⚠️ Если пропустить этот шаг, при подключении аккаунта появится ошибка прав доступа: токен был бы действителен, но «не видел» бы ни одного аккаунта.

Шаг 4 — Подготовьте приложение

Токен генерируется через приложение бизнеса, и системному пользователю нужна роль в этом приложении. Если у вас уже есть приложение, связанное с системным пользователем, переходите к Шагу 5.

Создайте приложение (если у вас его нет)

Проверка Meta не требуется: приложение — это просто технический «контейнер» для токена, подойдёт любое бизнес-приложение с Marketing API.

1. Перейдите в Business Settings → Accounts → Apps → Add → «Create a new app ID».

2. App name: например, RoyLead Sync (email для связи уже ваш).

3. Use cases: оставьте выбранным «Create and manage ads with the Marketing API» (первый вариант, отмечен по умолчанию).

4. Business: привяжите приложение к своему бизнес-портфелю, чтобы оно принадлежало нужному бизнесу.
5. Проверьте Overview и нажмите Create app. Marketing API уже включён благодаря выбранному use case.

Свяжите приложение с системным пользователем

Одного создания приложения недостаточно: системному пользователю нужна роль в приложении, иначе шаг «Assign permissions» токена останется пустым.

1. Перейдите в Accounts → Apps и выберите своё приложение.
2. Нажмите Assign people.

3. Выберите системного пользователя roylead, включите переключатель «Develop app» и нажмите Assign.

Шаг 5 — Сгенерируйте токен

1. У системного пользователя нажмите Generate new token.
2. Выберите своё приложение из списка (то, что подготовили на Шаге 4).
3. Среди разрешений отметьте ads_read.
4. Срок действия токена: можно установить Never для постоянного подключения.
5. Нажмите Generate token и сразу скопируйте его.

⚠️ Если на шаге «Assign permissions» видите «No permissions available», значит приложение не связано с системным пользователем: завершите Шаг 4 и попробуйте снова.

🔒 Meta показывает токен только один раз. Если вы его потеряли — не страшно: сгенерируйте новый и заново вставьте в RoyLead.

Шаг 6 — Найдите ID рекламного аккаунта

1. В Business Settings перейдите в Accounts → Ad accounts.
2. Выберите аккаунт: ID — это показанный номер (например, 123456789012345).

RoyLead принимает как просто номер, так и формат act_123456789012345.

Шаг 7 — Вставьте всё в RoyLead

1. Откройте раздел Реклама в RoyLead.
2. Нажмите Connect account и выберите Facebook · with token.
3. Вставьте токен и ID аккаунта, затем подтвердите.

Перейти в Рекламу ↗

RoyLead сразу проверяет токен через Meta, автоматически получает название и валюту аккаунта (выбирать их не нужно) и сохраняет подключение.

Шаг 8 — Проверьте

• Аккаунт появится в списке со статусом Connected.
• Автоматическая синхронизация запускается каждые несколько часов; можно также запустить её вручную кнопкой Sync.
• После первой синхронизации расход и ROI появятся в Analytics рядом с вашими лидами.

Токен и приложение: как они сосуществуют

Ручной токен и вход через Facebook (OAuth) — два способа получить одно и то же: разрешение читать данные аккаунта. Можно использовать токен сейчас и перейти на OAuth в любой момент, не теряя исторические данные.

ℹ️ Один нюанс: токен привязан к приложению Meta, через которое он был сгенерирован. Если это приложение будет заблокировано Meta, перестанут работать и токен, и OAuth. Токен защищает вас от проблем с процессом входа, но не от блокировки приложения.

Если токен истёк или перестал работать

Если вы сгенерировали токен со сроком действия, и он истёк, либо вы отозвали его в Business Manager, RoyLead пометит аккаунт статусом ошибки.

Чтобы исправить: на карточке аккаунта в меню ⋯ → Edit credentials вставьте новый токен и сохраните. Полностью пересоздавать подключение не нужно.

Решение проблем

💡 Генерируйте токен со сроком действия Never, чтобы избежать перебоев: это самый удобный вариант для непрерывной синхронизации.

Лучшие практики

• 🔑 Используйте отдельного системного пользователя для RoyLead: отзыв его токена заблокирует только эту интеграцию.
• 🔒 Назначайте системному пользователю только те рекламные аккаунты, которые реально хотите синхронизировать.
• 🚨 Относитесь к токену как к паролю: если подозреваете утечку, перегенерируйте его в Business Manager и вставьте заново.