Relier Instagram et Facebook

1. Créer l’application Meta

Ouvrez Meta for Developers → Mes applications avec le profil Facebook qui administre votre Page. Créez une application nommée Needlz Dashboard.

Choisissez le parcours permettant l’API Instagram avec connexion Facebook (« Instagram API with Facebook Login »). Les intitulés des cas d’usage varient selon le tableau de bord Meta. Ajoutez la connexion Facebook / Facebook Login for Business proposée par ce parcours.

Pour vos essais, gardez l’application en développement et utilisez un profil ayant un rôle dans l’application ainsi que les accès à la Page et au compte Instagram. Si Meta demande un portefeuille Business, associez celui qui possède ces comptes.

2. Configurer le retour vers le dashboard

Dans les réglages de Facebook Login, activez la connexion OAuth web et ajoutez cette adresse exacte aux URI de redirection OAuth valides :

https://dashboard.lagence.site/api/meta/callback

Utilisez la même adresse de base que AUTH_URL. Une variation entre localhost et 127.0.0.1 suffit à empêcher le retour.

Le code fonctionne localement. Si votre configuration Meta impose HTTPS et refuse localhost, il faudra une adresse de développement HTTPS ou un hébergement HTTPS, puis mettre à jour AUTH_URL et les adresses de retour Meta et Google.

3. Activer les permissions de lecture

• pages_show_list
• pages_read_engagement
• instagram_basic
• instagram_manage_insights

Ces permissions servent à lister vos Pages, lire le compte Instagram et consulter ses statistiques. Aucune permission de publication ou de messagerie n’est demandée.

Si vous utilisez Facebook Login for Business, créez une configuration avec un jeton d’utilisateur et ces permissions, puis conservez son identifiant de configuration pour META_LOGIN_CONFIG_ID.

La disponibilité dépend du cas d’usage, des rôles et du niveau d’accès de l’application. Si une permission manque, vérifiez le parcours Instagram avec Facebook Login. L’accès à des comptes d’autres personnes peut nécessiter une validation Meta ; ce guide concerne vos propres comptes.

4. Renseigner les paramètres locaux

Dans les paramètres généraux de l’application Meta, récupérez son identifiant et son secret. Collez-les directement dans le fichier .env du dossier needlz_dashboard :

META_APP_ID=""
META_APP_SECRET=""
META_GRAPH_VERSION="v26.0"
# Seulement avec Facebook Login for Business
META_LOGIN_CONFIG_ID=""

Gardez les paramètres Google et Neon existants. N’envoyez pas le secret Meta dans la conversation. Redémarrez le serveur avec npm run dev après la modification.

5. Autoriser et synchroniser

1. Dans Connexions, ouvrez votre session Google si nécessaire, puis cliquez sur Connecter Meta.
2. Autorisez la Page et le compte Instagram correspondants, ainsi que les permissions demandées.
3. Choisissez la Page au retour. L’option Facebook peut rester cochée ou être désactivée pour ce premier branchement.
4. Validez les comptes puis lancez Synchroniser Instagram.
5. Activez « Afficher mes données réelles » pour consulter les publications importées.

Facebook possède son propre bouton : vous pouvez le synchroniser plus tard.

Instagram : publications et Reels, compteurs et statistiques disponibles selon les formats. Facebook : publications, likes, commentaires, partages et abonnés ; vues et watch time à ajouter. Chaque import ajoute des relevés sans effacer l’historique ni les métadonnées éditoriales.

Un même contenu publié sur plusieurs plateformes arrive pour l’instant sous des fiches séparées à classer. Le rapprochement éditorial entre plateformes sera une étape distincte, sans fusion automatique sur le seul titre.