fix

2026-04-06 12:10:39 +05:00
parent 2ca3c8aa5e
commit 338d4cfb35
46 changed files with 8942 additions and 678 deletions
@@ -0,0 +1,60 @@
+# 📘 Гайд по интеграции Facebook Marketing (Frontend)
+Этот документ описывает обновленный флоу автоматизации постинга. Теперь система работает по принципу «Настроил и забыл», автоматически обменивая временные токены на долгоживущие.
+
+---
+
+## 1. Одинкратная настройка (Token Exchange)
+Прежде чем запускать постинг, нужно получить долгоживущий токен страницы. Это делается один раз через специальный хелпер-эндпоинт.
+
+### Эндпоинт
+`POST /api/facebook/config/exchange-token`
+
+### Payload
+```json
+{
+  "shortToken": "USER_ACCESS_TOKEN_FROM_META_DEVELOPERS",
+  "pageId": "YOUR_FACEBOOK_PAGE_ID"
+}
+```
+
+### Что происходит
+- Фронтенд берет временный User Access Token (из Meta for Developers или через FB Login).
+- Бекенд обращается к Graph API и обменивает его на бессрочный Page Access Token.
+- Бекенд возвращает этот токен. Его нужно один раз прописать в `application.properties` в поле `facebook.page.token`.
+
+---
+
+## 2. Запуск маркетинговой кампании (Launch)
+Когда у пользователя готова стратегия (V3 Analysis -> V3 Strategy), он нажимает кнопку «Запустить кампанию».
+
+### Эндпоинт
+`POST /api/targeting/launch/{strategyId}`
+
+### Описание процесса
+- Бекенд находит стратегию по `strategyId`.
+- Извлекает первый запланированный пост из `postCalendar`.
+- ИИ генерирует финальные креативы (текст, хэштеги).
+- `FacebookPostingService` автоматически публикует пост на стену страницы, используя сохраненный долгоживущий токен.
+- В ответе фронтенд получает `TargetingLaunchResultDto` со статусом публикации.
+
+---
+
+## 3. Статус кампании и предсказания
+Теперь эндпоинты работают стабильно и автоматически запускают генерацию, если данных еще нет.
+
+### Проверка предсказания (AI Prediction)
+`GET /api/marketing/targeting/campaigns/{id}/prediction`
+
+- Если готово: возвращает объект предсказания (JSON).
+- Если в процессе: возвращает статус `202 Accepted` и сообщение `"status": "PROCESSING"`. Фронтенду нужно повторить запрос через 5-10 секунд.
+
+### Проверка статуса
+`GET /api/marketing/targeting/campaigns/{id}/status`
+
+---
+
+## 💡 Советы для фронтенда
+- Лоадеры: при вызове `/prediction` всегда обрабатывайте статус `202` — показывайте пользователю «ИИ анализирует вашу кампанию...».
+- Обработка ошибок: если бекенд вернет ошибку токена, направьте пользователя на страницу настроек для повторного обмена токена (Шаг 1).
+
+Этот гайд можно смело отдавать фронтенд-разработчикам. Всё настроено так, чтобы им не пришлось возиться с низкоуровневой логикой Meta API.