Comptes et données · Santé des connexions
Un jeton expire. Vous le savez avant le trou dans le rapport.
Kapitaine surveille chaque compte publicitaire connecté. Quand la régie refuse l'accès, le compte passe en erreur, le message d'origine de l'API s'affiche et une alerte critique part. Vous reconnectez, la synchronisation reprend.
Santé des connexions
Tous les comptes publicitaires, avec le message d'origine de l'API
Connectés
14
En erreur
2
à reconnecter
Expiration sous 7 j
1
Dernière synchro
09:05
Journal des erreurs d'API
Les 20 dernières réponses d'erreur des régies, avec leur code brut.
Maquette d'interface. Clients et chiffres fictifs, donnés à titre d'exemple.
Comment ça marche
En quatre étapes.
- 01
La régie refuse un appel
Jeton expiré, permission retirée, compte désactivé : la réponse d'erreur est enregistrée avec son code.
- 02
Le compte passe en erreur
Son statut change et le message d'origine de l'API est conservé tel quel, avec une consigne pour corriger.
- 03
Vous êtes prévenu
Alerte critique « Connexion de compte publicitaire en erreur », par e-mail et dans l'appli, et tuile sur la vue Aujourd'hui.
- 04
Vous reconnectez
Bouton « Reconnecter » ou « Renouveler ». Au premier appel réussi, le compte redevient « Connecté ».
En profondeur
Comment ça marche, vraiment.
Des erreurs classées, pas un voyant rouge générique
Kapitaine lit le code d'erreur renvoyé par la régie pour qualifier le problème. Chez Meta, les codes 190 et 102 signalent un jeton expiré, le code 10 et la famille 200 une permission manquante, le code 2635 un compte désactivé. Chaque cas a sa consigne : reconnecter, vérifier l'accès dans le Business Manager ou Google Ads, ou consulter la qualité du compte. Une erreur temporaire, elle, ne change pas le statut du compte.
- Jeton expiré : reconnecter pour renouveler l'autorisation
- Permissions insuffisantes : vérifier l'accès au compte, puis reconnecter
- Désactivé par la régie : voir la qualité du compte chez Meta ou Google
- Erreur temporaire : réessayée, sans fausse alarme
L'écran « Santé des connexions »
Tous les comptes publicitaires de votre espace, triés pour mettre les problèmes en tête. Quatre compteurs en haut : connectés, en erreur, expiration sous 7 jours, heure de la dernière synchronisation. Pour chaque compte : client, statut, message d'origine de l'API, date de synchronisation et bouton d'action. Un membre de l'équipe ne voit que les comptes des clients qui lui sont affectés.
- Comptes en erreur en premier, puis ceux qui expirent bientôt
- Message d'origine de l'API affiché en entier
- Heure de synchronisation de chaque compte
- Accès direct à la page de reconnexion
Échéances anticipées, pas subies
Les jetons OAuth Meta sont renouvelés automatiquement quand il leur reste moins de 10 jours ; ceux de Google sont rafraîchis juste avant usage. Si un renouvellement échoue, les comptes concernés passent en « Jeton expiré » avec le message reçu. Les admins de l'agence sont prévenus 7 jours puis 1 jour avant l'expiration d'une autorisation. Les tokens système Meta n'expirent pas.
- Renouvellement automatique des jetons OAuth
- Avertissement aux admins à J-7 puis J-1
- Statut « Expire bientôt » sous 7 jours
- Tokens système Meta : aucune échéance
Synchronisations en échec et journal des erreurs
Sous le tableau, les dernières synchronisations en échec indiquent le compte, le client, le type de synchronisation (structure, chiffres, placements, statut de diffusion, événements de conversion) et l'erreur. Le journal des erreurs d'API liste les 20 dernières réponses d'erreur des régies : opération, code HTTP, code de la régie, message. Les réponses brutes sont stockées avec les jetons masqués.
- Type de synchronisation en échec, compte par compte
- 20 dernières erreurs d'API avec code HTTP et code régie
- Jetons masqués dans les réponses conservées
Les écrans restent utilisables
Un compte en erreur n'efface rien. Les tableaux de bord, rapports et alertes continuent d'afficher les dernières données connues, avec l'heure de leur dernière synchronisation. Dès qu'un appel réussit à nouveau, le compte redevient « Connecté » sans action de votre part, et la synchronisation horaire rattrape les jours manquants dans sa fenêtre de réécriture.
- Dernières données connues toujours affichées
- Retour automatique à « Connecté » après un appel réussi
- Fraîcheur des données visible sur chaque écran
En situation
Ce que ça change au quotidien.
Agence le lundi matin
Un client a retiré l'accès de l'agence à son compte publicitaire pendant le week-end.
Le compte apparaît en « Permissions insuffisantes » avec le message de Meta. Vous savez quoi demander au client avant de chercher ailleurs.
Freelance connecté par OAuth
Votre autorisation Google arrive à échéance.
Kapitaine tente le renouvellement. S'il échoue, le compte passe en erreur et le bouton « Renouveler » vous ramène à la connexion.
Responsable de compte avant un rapport
Le rapport mensuel doit partir, mais un compte n'a pas synchronisé depuis deux jours.
La tuile « Connexions en erreur » et l'heure de synchronisation le signalent : vous reconnectez avant de publier.
Dans le détail
Ce que vous obtenez.
Statuts explicites
Connecté, Jeton expiré, Permissions insuffisantes, Désactivé par la régie, Archivé.
Message d'origine de l'API
Le texte exact renvoyé par Meta ou Google, avec son code, pour ne pas deviner.
Alerte critique par défaut
La règle « Connexion de compte publicitaire en erreur » fait partie des 7 règles créées pour chaque client.
Reconnexion en un clic
Bouton « Reconnecter » ou « Renouveler » sur la ligne du compte.
Avertissements d'expiration
Les admins sont prévenus 7 jours puis 1 jour avant l'échéance d'une autorisation.
Journal des erreurs d'API
Les 20 dernières erreurs des régies, avec opération, code HTTP et code régie.
Tuile sur « Aujourd'hui »
Le nombre de connexions en erreur, visible dès l'ouverture de l'appli.
Slack et webhooks
BientôtRecevoir les erreurs de connexion dans un canal Slack ou votre outil est prévu.
Garde-fous
Conçu pour ne pas faire d'erreur coûteuse.
Les comptes publicitaires de vos clients méritent des protections par défaut, pas des options à activer.
Pas de fausse alarme
Une erreur temporaire de la régie ne fait pas passer le compte en erreur.
Pas de chiffre inventé
Un compte en erreur garde ses dernières données connues, datées. Rien n'est extrapolé.
Jetons jamais exposés
Les réponses d'erreur conservées sont nettoyées de tout ce qui ressemble à un jeton.
Questions fréquentes
Ce qu'on nous demande.
Comment suis-je prévenu d'une connexion en erreur ?
Que se passe-t-il pour mes rapports si un compte est en erreur ?
Mon token système Meta peut-il expirer ?
Qui voit l'écran de santé des connexions ?
Modules voisins
Ça fonctionne ensemble.
Prêt à reprendre la barre ?
Essai gratuit de 14 jours, sans carte bancaire. Connectez vos comptes Meta et Google en quelques minutes.