Connectez Meta avec un token (System User)

Étape 1 — Ouvrez les paramètres de l'entreprise

Allez sur le Business Manager de Meta et connectez-vous avec un compte administrateur.

Ouvrir Meta Business Settings

ℹ️ Si vous gérez plusieurs entreprises, vérifiez en haut à gauche que vous avez sélectionné la bonne — celle qui possède le compte publicitaire.

Étape 2 — Créez un utilisateur système

Un utilisateur système (System User) est un "utilisateur technique" de l'entreprise, conçu spécifiquement pour les intégrations.

1. Dans le menu de gauche, allez sur Utilisateurs → Utilisateurs système.
2. Cliquez sur Ajouter.
3. Donnez-lui un nom reconnaissable, ex. RoyLead Sync.
4. Rôle : Employé — l'accès en lecture suffit, pas besoin d'Admin. Cliquez sur Créer un utilisateur système.

Étape 3 — Attribuez le compte publicitaire

Le token ne fonctionne que sur les actifs que vous attribuez explicitement à cet utilisateur.

1. Avec l'utilisateur système sélectionné, cliquez sur Attribuer des actifs.
2. Sous Comptes publicitaires, sélectionnez le compte que vous voulez connecter.
3. Dans les permissions, activez uniquement le bouton "Afficher les performances" (sous Accès partiel) : c'est l'accès en lecture dont ads_read a besoin. Laissez "Gérer les campagnes" et "Contrôle total" désactivés.
4. Cliquez sur Attribuer des actifs.

⚠️ Si vous sautez cette étape, la connexion du compte échouera avec une erreur de permissions : le token serait valide mais ne "verrait" aucun compte.

Étape 4 — Préparez l'app

Le token est généré via une app de l'entreprise, et l'utilisateur système a besoin d'un rôle sur cette app. Si vous avez déjà une app liée à l'utilisateur système, passez à l'Étape 5.

Créez l'app (si vous n'en avez pas)

Pas besoin de validation Meta : l'app est juste le "conteneur" technique du token, et n'importe quelle app d'entreprise avec la Marketing API convient.

1. Allez sur Paramètres de l'entreprise → Comptes → Apps → Ajouter → "Créer un nouvel ID d'app".

2. Nom de l'app : ex. RoyLead Sync (l'email de contact est déjà le vôtre).

3. Cas d'usage : laissez sélectionné "Créer et gérer des publicités avec l'API Marketing" (la première option, cochée par défaut).

4. Entreprise : liez l'app à votre portfolio d'entreprise pour qu'elle appartienne à la bonne entreprise.
5. Vérifiez l'Aperçu et cliquez sur Créer l'app. La Marketing API est déjà incluse grâce au cas d'usage choisi.

Liez l'app à l'utilisateur système

Créer l'app ne suffit pas : l'utilisateur système a besoin d'un rôle sur l'app, sinon l'étape "Attribuer des permissions" du token reste vide.

1. Allez sur Comptes → Apps et sélectionnez votre app.
2. Cliquez sur Attribuer des personnes.

3. Sélectionnez l'utilisateur système roylead, activez le bouton "Développer l'app" et cliquez sur Attribuer.

Étape 5 — Générez le token

1. Sur l'utilisateur système, cliquez sur Générer un nouveau token.
2. Sélectionnez votre app dans la liste (celle préparée à l'Étape 4).
3. Parmi les permissions, cochez ads_read.
4. Expiration du token : vous pouvez la régler sur Jamais pour une connexion permanente.
5. Cliquez sur Générer le token et copiez-le immédiatement.

⚠️ Si à l'étape "Attribuer des permissions" vous voyez "Aucune permission disponible", l'app n'est pas liée à l'utilisateur système : complétez l'Étape 4 et réessayez.

🔒 Meta n'affiche le token qu'une seule fois. Si vous le perdez, pas de problème : générez-en un autre et recollez-le dans RoyLead.

Étape 6 — Trouvez l'ID du compte publicitaire

1. Dans les paramètres de l'entreprise, allez sur Comptes → Comptes publicitaires.
2. Sélectionnez le compte : l'ID est le numéro affiché (ex. 123456789012345).

RoyLead accepte aussi bien le numéro seul que le format act_123456789012345.

Étape 7 — Collez le tout dans RoyLead

1. Ouvrez la section Publicité dans RoyLead.
2. Cliquez sur Connecter un compte et choisissez Facebook · avec token.
3. Collez le token et l'ID de compte, puis confirmez.

Aller sur Publicité ↗

RoyLead valide immédiatement le token auprès de Meta, récupère automatiquement le nom et la devise du compte (vous n'avez rien à choisir) et enregistre la connexion.

Étape 8 — Vérifiez

• Le compte apparaît dans la liste avec le statut Connecté.
• La synchronisation automatique s'exécute toutes les quelques heures ; vous pouvez aussi la forcer avec le bouton Synchroniser.
• Après la première synchronisation, les dépenses et le ROI apparaissent dans Analytics aux côtés de vos leads.

Token et app : comment ils cohabitent

Le token manuel et "Se connecter avec Facebook" (OAuth) sont deux façons d'obtenir la même chose : la permission de lire les données du compte. Vous pouvez utiliser le token maintenant et passer à l'OAuth quand vous voulez, sans perdre les données historiques.

ℹ️ Une mise en garde : le token est lié à l'app Meta utilisée pour le générer. Si cette app est suspendue par Meta, le token et l'OAuth s'arrêtent tous les deux. Le token vous protège des problèmes du flux de connexion, pas d'une suspension de l'app.

Si le token expire ou cesse de fonctionner

Si vous générez un token avec une expiration et qu'elle survient, ou si vous le révoquez depuis Business Manager, RoyLead signale le compte avec un statut d'erreur.

Pour le réparer : sur la carte du compte, menu ⋯ → Modifier les identifiants, collez le nouveau token et enregistrez. Pas besoin de refaire toute la connexion.

Résolution de problèmes

💡 Générez le token avec une expiration Jamais pour éviter les interruptions : c'est le choix le plus pratique pour une synchronisation continue.

Bonnes pratiques

• 🔑 Utilisez un utilisateur système dédié à RoyLead : révoquer son token ne bloque que cette intégration.
• 🔒 N'attribuez à l'utilisateur système que les comptes publicitaires que vous voulez réellement synchroniser.
• 🚨 Traitez le token comme un mot de passe : si vous pensez qu'il a fuité, régénérez-le dans Business Manager et recollez-le.