commit 4947f25c84d6faf873af7306896cb17c12f876b8 Author: Jo Bo <3+jobo@noreply.localhost> Date: Fri Jul 24 10:57:58 2026 +0200 Téléverser les fichiers vers "/" diff --git a/GUIDE-config-Meta-Facebook-Instagram.md b/GUIDE-config-Meta-Facebook-Instagram.md new file mode 100644 index 0000000..026cf8d --- /dev/null +++ b/GUIDE-config-Meta-Facebook-Instagram.md @@ -0,0 +1,153 @@ +# GUIDE PAS-À-PAS — Configuration Meta (Facebook + Instagram) + +> **Une seule app Meta** couvre à la fois **Facebook** et **Instagram**, et **un seul « Se connecter »** +> dans le plugin obtiendra un jeton valable pour les deux. C'est le gros avantage de l'écosystème Meta. +> +> ⚠️ **Les libellés exacts des écrans Meta changent souvent** (Meta réorganise ses consoles plusieurs fois par an). +> Les **principes, permissions et endpoints** ci-dessous, eux, sont stables. Si un écran ne porte pas exactement +> le nom indiqué, cherche l'équivalent le plus proche — je t'aiderai à retomber sur mes pieds au moment du palier B. +> +> Tu réalises **toi-même** ces étapes (création de comptes, saisie de secrets) : je ne peux ni ne dois le faire à ta place. + +--- + +## Vue d'ensemble (l'ordre compte) + +``` +1. Compte Facebook (perso, admin) ─┐ +2. Page Facebook « Karaoke Clip » │ côté réseaux sociaux +3. Compte Instagram → Business/Creator │ +4. Lier l'Instagram à la Page Facebook ─┘ +5. Business Manager (portefeuille pro) ─┐ +6. App Meta for Developers │ côté développeur +7. Produits : Facebook Login + Instagram │ +8. Permissions + URI de redirection │ +9. App ID + App Secret → dans le plugin │ +10. (plus tard) Business Verification + App Review─┘ +``` + +Les étapes 1→9 suffisent pour **développer et tester** (mode Développement). L'étape 10 n'est requise que pour +publier **publiquement au grand public** (mode Live). + +--- + +## PARTIE 1 — Côté réseaux sociaux + +### Étape 1 — Compte Facebook administrateur +Utilise (ou crée) un compte Facebook personnel qui sera l'**administrateur** de tout. C'est lui qui possédera l'app, +la Page et le Business Manager. Active la **validation en deux étapes** dessus (Meta l'exige pour les rôles sensibles). + +### Étape 2 — Page Facebook +1. https://www.facebook.com/pages/create → crée la Page (nom : *Karaoke Clip*, catégorie *Musicien/Groupe* ou *Site web*). +2. Note le **nom exact** de la Page. Son identifiant (`PAGE_ID`) sera récupéré automatiquement par le plugin, tu n'as pas à le chercher à la main. +3. Publie au moins une photo de profil + une couverture (une Page vide peut coincer certaines vérifications). + +### Étape 3 — Compte Instagram en Business/Creator +1. Crée (ou utilise) un compte Instagram dédié. +2. Dans l'app Instagram → **Paramètres → Compte → Passer à un compte professionnel** → choisis **Business** (ou Creator). + > L'API de publication **refuse** les comptes personnels. C'est non négociable. + +### Étape 4 — Lier l'Instagram à la Page Facebook +Le plus fiable passe par **Meta Business Suite** : +1. https://business.facebook.com → connecte-toi avec le compte de l'étape 1. +2. **Paramètres → Comptes → Comptes Instagram → Ajouter** → connecte le compte IG Business. +3. **Paramètres → Comptes → Pages** → assure-toi que la Page FB (étape 2) est bien dans le portefeuille. +4. Vérifie la liaison : dans les paramètres de la Page → **Comptes liés → Instagram** doit montrer ton compte IG. + +> Test rapide de bonne liaison (facultatif) : dans Business Suite, tu dois pouvoir **programmer un post** vers la Page +> **et** vers l'Instagram depuis la même interface. Si oui, l'API pourra faire pareil. + +### Étape 5 — Business Manager / Portefeuille professionnel +Déjà créé de fait à l'étape 4 (business.facebook.com). Il servira à la **Business Verification** (étape 10). +Renseigne dès maintenant les infos de l'entreprise (nom, site `karaokeclip.video`) : ça accélère la vérif plus tard. + +--- + +## PARTIE 2 — Côté développeur (l'app Meta) + +### Étape 6 — Créer l'app +1. https://developers.facebook.com → **Log in** (compte étape 1) → accepte les conditions développeur si demandé. +2. **My Apps → Create App**. +3. Cas d'usage : choisis une app qui permet de **gérer une Page et publier du contenu**. Selon la version de la console, + c'est soit un choix « **Other** → type **Business** », soit un « use case » du type *« Manage everything on your Page »* / + *« Publish content »*. En cas de doute, prends le type **Business** : il donne accès à tout ce dont on a besoin. +4. Nomme l'app (ex. *KaraokeClip Publisher*), associe-la au **portefeuille pro** (étape 5). + +### Étape 7 — Ajouter les produits +Dans le tableau de bord de l'app → **Add Product** (ou « Use cases ») : +- **Facebook Login for Business** → pour l'OAuth (le bouton « Se connecter » du plugin). +- **Instagram** (Instagram Graph API / « Instagram API with Facebook Login ») → pour publier les Reels. + +### Étape 8 — URI de redirection OAuth +Dans **Facebook Login for Business → Settings → Valid OAuth Redirect URIs**, ajoute **exactement** l'URL de la page +de réglages du plugin (le plugin te l'affichera, comme pour YouTube). Format attendu : +``` +https://staging2.karaokeclip.video/wp-admin/admin.php?page=kcp-settings +``` +> Quand tu passeras en production, ajoute **aussi** l'URL du domaine final `https://karaokeclip.video/...`. +> Meta refuse toute redirection non listée ici — c'est la cause n°1 d'échec de connexion. + +### Étape 9 — Récupérer App ID + App Secret +**Settings → Basic** : +- **App ID** → tu le colleras dans le réglage `meta_app_id` du plugin. +- **App Secret** (bouton *Show*) → réglage `meta_app_secret` (champ mot de passe, jamais réaffiché — comme le secret Google). +- Renseigne au passage : **Privacy Policy URL**, **Terms of Service URL**, **App Domain**, catégorie. Ces champs + sont **obligatoires pour l'App Review** (étape 10) ; autant les remplir tout de suite. + +### Permissions dont le plugin aura besoin +Tu n'as rien à « cocher » manuellement ici : le plugin les demandera dans son flux OAuth. Mais pour information, +et pour l'App Review, ce sont : + +| Permission | À quoi elle sert | +|---|---| +| `pages_show_list` | lister tes Pages pour choisir la bonne | +| `pages_read_engagement` | lire les infos de la Page | +| `pages_manage_posts` | **publier la vidéo** sur la Page | +| `business_management` | accéder au portefeuille pro / liaison IG | +| `instagram_basic` | lire le compte IG Business lié | +| `instagram_content_publish` | **publier les Reels** Instagram | + +--- + +## PARTIE 3 — Connexion depuis le plugin (au palier B) + +Une fois le palier B livré, le processus côté plugin sera **calqué sur YouTube** : +1. Réglages → colle **App ID** + **App Secret** → **Enregistrer**. +2. Clique **« Se connecter à Meta »** → fenêtre de consentement Facebook → autorise Page + Instagram. +3. Le plugin échange le code, obtient un **jeton longue durée (~60 jours)**, en dérive le **Page token** et + détecte automatiquement l'**IG Business Account ID** lié. Il stocke tout dans une **option dédiée** + (jamais dans le blob de réglages — précaution anti-effacement, cf. passation §9.1). +4. Si tu as plusieurs Pages / comptes IG, un menu déroulant te laissera choisir la cible. + +> **Durée de vie du jeton** : ~60 jours pour le jeton utilisateur longue durée ; le **Page token** qui en dérive +> peut être de très longue durée. Le plugin surveillera l'expiration et t'alertera s'il faut reconnecter +> (exactement comme le rappel hebdo de Google en mode Test). + +--- + +## PARTIE 4 — Passage en production (App Review + Business Verification) + +Tant que l'app est en **mode Développement**, elle ne peut publier que via des comptes ayant un **rôle sur l'app** +(admin / développeur / testeur). **C'est parfait pour tester tout le palier B sur staging** sans validation Meta. + +Pour publier **publiquement** (mode Live), Meta demande : +1. **Business Verification** du portefeuille (documents d'entreprise) — via Business Manager. +2. **App Review** des permissions avancées (`pages_manage_posts`, `instagram_content_publish`, etc.) : + Meta demande une **vidéo de démonstration** montrant le parcours, et des **URL publiques** de politique de + confidentialité / conditions d'utilisation (d'où l'étape 9). +3. App en mode **Live**. + +> Rien de tout cela ne bloque le développement : on code et on teste **maintenant** en mode Dev. +> La revue se déclenche quand le site quitte le staging. + +--- + +## Récapitulatif « ce que tu me fourniras » (au palier B) + +- **App ID** et **App Secret** (tu les colles dans le plugin, tu ne me les envoies pas en clair ici). +- Confirmation que la **Page FB** existe et que l'**Instagram Business** y est **lié**. +- L'**URI de redirection** ajoutée dans l'app (le plugin te donnera la valeur exacte à coller). + +Le reste (Page ID, IG Business ID, jetons) est récupéré **automatiquement** par le plugin. Tu n'as pas à les chercher. + +*Fin du guide Meta.*