154 lines
8.6 KiB
Markdown
154 lines
8.6 KiB
Markdown
# 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.*
|