8.6 KiB
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
- https://www.facebook.com/pages/create → crée la Page (nom : Karaoke Clip, catégorie Musicien/Groupe ou Site web).
- 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. - Publie au moins une photo de profil + une couverture (une Page vide peut coincer certaines vérifications).
Étape 3 — Compte Instagram en Business/Creator
- Crée (ou utilise) un compte Instagram dédié.
- 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 :
- https://business.facebook.com → connecte-toi avec le compte de l'étape 1.
- Paramètres → Comptes → Comptes Instagram → Ajouter → connecte le compte IG Business.
- Paramètres → Comptes → Pages → assure-toi que la Page FB (étape 2) est bien dans le portefeuille.
- 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
- https://developers.facebook.com → Log in (compte étape 1) → accepte les conditions développeur si demandé.
- My Apps → Create App.
- 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.
- 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_iddu 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 :
- Réglages → colle App ID + App Secret → Enregistrer.
- Clique « Se connecter à Meta » → fenêtre de consentement Facebook → autorise Page + Instagram.
- 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).
- 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 :
- Business Verification du portefeuille (documents d'entreprise) — via Business Manager.
- 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). - 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.