Pourquoi une connexion à l'API Instagram cesse de fonctionner, et comment la garder active
Une connexion API Instagram cesse de fonctionner lorsque Meta n'accepte plus son token ou que le compte ne remplit plus les conditions : un token longue durée non renouvelé pendant 60 jours, un changement de mot de passe, une autorisation ou toute l'application retirée par le propriétaire, un passage à un compte personnel, ou une restriction du compte. Chacun renvoie sa propre erreur, et la plupart se règlent quand le propriétaire se reconnecte.
easyCoexistence surveille chaque connexion Instagram en permanence : il renouvelle le token bien avant la fin des 60 jours, vérifie le compte toutes les 6 heures, vous envoie un e-mail unique lorsque Meta refuse l'accès et transmet channel.disconnected aux plateformes, si bien qu'une connexion coupée se rétablit par une seule connexion.
Les tokens Instagram non renouvelés dans les 60 jours expirent et ne peuvent plus être renouvelés.
Sous-code de l'API Graph, sous le code 190, pour une session terminée par un changement de mot de passe ; la personne doit se reconnecter.
Livraisons de webhooks de messagerie échouées avant que Meta les désactive et désabonne l'application du compte.
Meta peut mettre fin à l'accès d'une application aux autorisations ou fonctionnalités qu'elle n'a pas utilisées pendant une période de 28 jours.
Fréquence à laquelle easyCoexistence vérifie chaque compte Instagram connecté, en renouvelant son token bien avant la fin des 60 jours.
Pourquoi une connexion API Instagram cesse-t-elle de fonctionner ?
Parce que Meta cesse d'accepter le token, ou que le compte cesse de remplir les conditions de l'API. La documentation de Meta énumère les causes, chacune avec ce que l'API renvoie et l'étape qui rétablit l'accès. La plupart apparaissent d'abord sous la forme d'un appel échoué, c'est pourquoi les contrôles plus bas les recherchent selon un calendrier :
| What the API returns | What restores it | |
|---|---|---|
| Token not refreshed for 60 days | Code 190; a refresh is no longer possible | The owner signs in again |
| Password changed | Code 190 with subcode 460 | The owner signs in again |
| Permission missing or removed | Code 10, or a code from 200 to 299 | A new sign-in that grants it |
| App removed in Instagram's settings | A call to the app's deauthorize callback | A new sign-in, if the owner wants it back |
| Switched to a personal account | (#10) Access is denied because the instagram account type is not business or creator. | Back to Business or Creator, then a new sign-in |
| Allow access to messages off | Code 200 with subcode 2534041, on DMs | The owner turns the setting back on |
| Account restricted, inactive or checkpointed | Code 25 with subcode 2207050 | The owner acts in the Instagram app |
| Webhook endpoint failing for an hour | A Webhooks Disabled alert, the account unsubscribed | A working endpoint, then a new subscription |
Quand un token expire-t-il, et quand peut-il encore être renouvelé ?
Avec Instagram Login, un token longue durée est valable 60 jours à compter de son dernier renouvellement. Un renouvellement avec grant_type=ig_refresh_token lui accorde 60 jours supplémentaires, à condition qu'il ait au moins 24 heures, qu'il ne soit pas expiré et que le propriétaire ait accordé instagram_business_basic. Une fois les 60 jours écoulés, les appels échouent avec le code 190 et seule une nouvelle connexion permet de rétablir l'accès. Avec Unified Login, la configuration détermine si le token expire ou non.
Que font un changement de mot de passe et une autorisation retirée ?
Un changement de mot de passe peut mettre fin à la session à laquelle appartient le token : le guide des erreurs de l'API Graph de Meta le signale avec le code 190 et le sous-code 460, et indique que la personne doit se reconnecter à l'application. Une autorisation qui n'a jamais été accordée ou qui a été retirée renvoie le code 10, ou un code compris entre 200 et 299 ; sur les messages privés, le code 200 avec le sous-code 2534041 signifie que le propriétaire a désactivé l'accès aux messages. Les Conditions de la plateforme de Meta permettent aussi de mettre fin à l'accès d'une application à une autorisation ou fonctionnalité inutilisée pendant 28 jours.
Que se passe-t-il quand le propriétaire retire l'application ?
Son accès aux données non publiques prend fin. Le propriétaire retire l'application dans Instagram, sous « Website permissions », « Apps and websites », « Active », et Meta appelle l'URL de rappel de révocation enregistrée dans les paramètres de connexion professionnelle de l'application. Le Centre d'aide d'Instagram indique qu'une application retirée ne peut plus accéder qu'aux informations publiques du compte ; la connexion est donc terminée jusqu'à ce que le propriétaire se reconnecte.
Que se passe-t-il quand le compte change de type ou est restreint ?
Dans les deux cas, le compte sort de ce que l'API prend en charge. L'API de Meta ne fonctionne qu'avec les comptes professionnels, et le tableau de dépannage d'Unified Login donne le message (#10) Access is denied because the instagram account type is not business or creator pour un compte passé en personnel ; le propriétaire repasse en professionnel, puis se reconnecte. Un compte restreint, inactif ou soumis à une vérification de sécurité renvoie le code 25 avec le sous-code 2207050, que le propriétaire règle dans l'application Instagram.
Comment les webhooks cessent-ils d'arriver ?
Par un endpoint défaillant. Meta retente une notification Instagram pendant jusqu'à 36 heures, mais les livraisons de messagerie sont plus strictes : après 15 minutes d'échecs, une alerte est envoyée au compte développeur, puis après une heure Meta envoie une alerte Webhooks Disabled et désabonne l'application du compte. Une fois l'endpoint de nouveau fonctionnel, POST /<IG_ID>/subscribed_apps avec les mêmes champs réactive les notifications.
Comment repérer une coupure avant vos utilisateurs ?
En vérifiant la connexion selon un calendrier, plutôt que d'attendre qu'une publication échoue :
- Enregistrez
expires_inà chaque échange et renouvelez le token bien avant le 60e jour, dès qu'il a au moins un jour. - Effectuez un appel authentifié peu coûteux selon un calendrier, par exemple GET /me?fields=
user_id,username, et traitez le code 190 ou 102 comme une reconnexion nécessaire. - Implémentez le callback de révocation, pour qu'un retrait dans les paramètres d'Instagram vous parvienne immédiatement.
- Lisez les Developer Alerts et l'e-mail professionnel associé à l'application, où Meta envoie les notifications de webhook et de revue.
- Journalisez le code, le sous-code et le
fbtrace_idde chaque erreur par compte, afin qu'une restriction se distingue d'une mauvaise requête.
Comment rétablir chaque cas ?
La plupart des causes se règlent de la même manière : une nouvelle connexion par le titulaire du compte, qui émet un nouveau code et un nouveau token. Les exceptions sont des paramètres que le propriétaire modifie dans l'application Instagram :
- Token expiré, mot de passe changé, application ou autorisation retirée : faites repasser le propriétaire par la connexion et laissez-le approuver les autorisations.
- Compte personnel : repassez en professionnel ou créateur dans l'application Instagram, puis reconnectez-vous.
- Messages désactivés : activez Allow access to messages sous Connected tools ; aucune nouvelle connexion n'est nécessaire.
- Compte restreint : suivez ce que demande l'application Instagram ; une nouvelle connexion n'y change rien.
- Webhooks désactivés : corrigez l'endpoint, puis réabonnez le compte.
Que fait easyCoexistence pour maintenir une connexion active ?
easyCoexistence surveille chaque compte Instagram connecté en permanence. Il renouvelle le token dès qu'il reste moins de 20 jours sur les 60, vérifie le compte toutes les 6 heures avec GET /me, et marque la connexion comme à reconnecter dès que Meta refuse le token, que ce soit lors de cette vérification ou lors d'un appel d'outil. Il répond immédiatement aux livraisons de webhooks de Meta et les transmet ensuite. Lorsque le propriétaire retire l'application dans les paramètres d'Instagram, le callback de révocation de Meta met fin à la connexion et la retire de la facturation.
Comment easyCoexistence vous prévient-il, et comment reconnecter ?
Une seule fois, par e-mail, en nommant le compte, avec un bouton vers la page du canal ; les plateformes reçoivent aussi un événement channel.disconnected signé. Tant que le propriétaire n'agit pas, list_social_accounts affiche le statut et la dernière erreur de Meta, et les outils répondent que le compte doit être reconnecté. La reconnexion se fait en une seule connexion avec le même compte Instagram, qui rétablit la même connexion avec ses paramètres.
Erreurs courantes
- Renouveler un token seulement après l'échec d'un appel. Une fois expiré, Meta refuse le renouvellement ; planifiez donc les renouvellements tant qu'il est encore valide.
- Renvoyer un compte restreint vers la connexion. Le code 25 avec le sous-code 2207050 décrit l'état du compte, que le propriétaire règle dans l'application Instagram.
- Ne pas configurer le callback de révocation. Un retrait dans les paramètres d'Instagram n'apparaît alors qu'au prochain appel échoué.
- Corriger un endpoint défaillant puis attendre. Après une alerte Webhooks Disabled, les notifications restent désactivées tant que le compte n'est pas réabonné avec POST /<IG_ID>/subscribed_apps.
De US$ 9 à US$ 0.75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Utiliser un token Instagram l'empêche-t-il d'expirer ?
Non. Seul un renouvellement prolonge un token longue durée, et un token resté 60 jours sans renouvellement expire, quelle que soit la fréquence de son utilisation.
Instagram supprime-t-il une application professionnelle après 90 jours sans utilisation ?
Non. Le Centre d'aide d'Instagram indique que les applications disposant d'autorisations de gestion des comptes professionnels et créateurs n'expirent pas après 90 jours d'inactivité.
Un compte déconnecté compte-t-il toujours dans la facturation d'easyCoexistence ?
Oui, jusqu'à ce que vous le reconnectiez ou le supprimiez. Un compte dont le propriétaire a retiré l'application dans les paramètres d'Instagram sort du décompte dès que Meta signale le retrait.
Combien coûte la surveillance d'un compte Instagram avec easyCoexistence ?
La surveillance est incluse dans chaque connexion : de US$ 9 à US$ 0.75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le