Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Comment permettre à vos clients de connecter Instagram à votre application

Votre backend appelle POST /connect-sessions d'easyCoexistence avec channel instagram et envoie le client vers l'url renvoyée, où il se connecte avec Instagram Login sur un compte Business ou Creator. Il revient sur votre redirect_url avec un channel_id, et GET /channels/{id}?credentials=1 renvoie un token pour graph.instagram.com, afin que votre application puisse publier, lire les commentaires et répondre aux DMs.

100 posts

Publications envoyées par l'API qu'un compte Instagram peut faire sur une fenêtre glissante de 24 heures ; un carrousel compte pour une seule.

JPEG

Le seul format d'image que Meta accepte pour publier sur Instagram via l'API.

24 hours

Délai standard pour répondre à un DM Instagram d'une personne, pour la plupart des actions de l'utilisateur ; la personne doit écrire en premier.

1 private reply

Messages qu'un compte peut envoyer à un auteur de commentaire par réponse privée, dans les 7 jours suivant le commentaire.

1 hour

Durée de validité d'un lien de connexion easyCoexistence avant l'expiration de sa session.

Que doit faire le client pour se connecter ?

Il suffit d'un bouton. Votre application crée la session avec channel défini sur instagram, un redirect_url et l'identifiant de votre client comme external_ref, puis envoie le client vers son url. La page hébergée affiche le nom de votre entreprise et Continuer avec Instagram, qui ouvre la connexion Instagram dans le même onglet, donc cela fonctionne sur téléphone. Le client accepte l'accès et revient sur votre redirect_url avec status=connected et le channel_id, que votre backend confirme avec GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_id

Quels comptes Instagram peuvent se connecter ?

Les comptes professionnels, Business ou Creator, que l'API Instagram de Meta prend en charge. Un compte déjà connecté via un autre service qui utilise easyCoexistence est refusé, et le last_error de la session l'indique ; le client doit d'abord le retirer là-bas ou se connecter avec un autre compte. Pour les DMs, le compte doit aussi activer Autoriser l'accès aux messages dans l'application Instagram, et le guide de connexion Instagram en donne le chemin.

Quel token reçoit votre application ?

Un token d'utilisateur Instagram pour graph.instagram.com/v25.0, avec account_id_on_meta, l'identifiant Instagram du compte, obtenu via GET /channels/{id}?credentials=1. easyCoexistence le renouvelle bien avant l'expiration de ses 60 jours, et chaque renouvellement émet un nouveau token ; récupérez donc les identifiants au début de chaque tâche plutôt que de garder une copie.

Comment votre application publie-t-elle sur le compte ?

Avec POST /channels/{id}/posts. ig_type choisit IMAGE, CAROUSEL, REELS ou STORIES, et il est déduit du média si vous ne le renseignez pas : plusieurs fichiers forment un carrousel, une vidéo forme un Reel. Ici un carrousel accepte de 2 à 10 éléments, les images doivent être en JPEG, le texte peut aller jusqu'à 2 200 caractères, et une publication Instagram n'a pas de champ lien. Sans publish_at, la publication part immédiatement ; avec ce champ, elle part à l'heure indiquée, jusqu'à 90 jours à l'avance.

A carousel on the customer's Instagram account
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ig_post_2291" \
  -d '{
    "text": "Three looks for the weekend.",
    "ig_type": "CAROUSEL",
    "media": [
      { "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
    ]
  }'

Comment les commentaires et DMs arrivent-ils à votre application ?

Dès que vous définissez une destination. PUT /channels/{id}/webhook avec votre url renvoie le secret de signature de ce compte, puis ses commentaires, mentions et DMs vous sont transmis à mesure qu'ils arrivent, signés avec X-EC-Signature. Le corps contient platform, account_id, external_id et l'entrée webhook de Meta inchangée, avec changes pour les commentaires et mentions, et messaging pour les DMs.

Comment votre application répond-elle aux commentaires et DMs ?

Via l'API Instagram de Meta sur graph.instagram.com, avec le token du client, pour que chaque réponse vienne du compte du client :

  • Répondre à un commentaire : POST /<IG_COMMENT_ID>/replies avec un message.
  • Répondre à un DM : POST /<IG_ID>/messages avec recipient défini sur l'identifiant de la personne et le texte du message, dans les 24 heures suivant son dernier message.
  • Réponse privée à un commentaire : le même edge messages avec recipient comment_id, une fois par commentaire, dans les 7 jours qui suivent.
  • Masquer ou supprimer un commentaire : POST ou DELETE sur /<IG_COMMENT_ID>.

Que se passe-t-il quand l'accès du client prend fin ?

Votre URL d'événements reçoit channel.disconnected lorsque Instagram refuse le token ou que le propriétaire retire l'accès dans les paramètres d'Instagram. Une nouvelle session de connexion pour ce client rétablit le compte. Pour y mettre fin de votre côté, DELETE /channels/{id} révoque l'accès auprès du réseau et annule les publications encore en file d'attente, et la facturation s'arrête à la fin du cycle.

Erreurs courantes

  • Envoyer des images PNG ou WebP à Instagram. Meta ne publie qu'en JPEG, donc la publication est refusée avant d'entrer dans la file ; convertissez d'abord les images.
  • Mettre un champ lien sur une publication Instagram. Les publications Instagram ne portent pas de lien, la requête est donc refusée ; mettez l'URL dans le texte.
  • Afficher un bouton Répondre sur des DMs de plus de 24 heures. Meta autorise les réponses dans la fenêtre ouverte par le dernier message de la personne.
  • Envoyer une deuxième réponse privée au même commentaire. Meta n'en autorise qu'une ; une relance attend que la personne réponde.
Faire cela avec EasyCoexistence

easyCoexistence permet à vos clients de connecter Instagram à votre application par une seule connexion hébergée, puis fournit à votre backend un token renouvelé, un endpoint de publications, et leurs commentaires et DMs par webhook, chaque connexion étant surveillée 24/7. Les mêmes appels couvrent WhatsApp, Facebook, TikTok, YouTube, LinkedIn et d'autres canaux. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec les 3 premiers jours en essai gratuit.

Questions fréquemment posées

Dois-je avoir ma propre application Meta pour connecter les comptes Instagram de mes clients ?

Non. Vos clients se connectent via l'application d'easyCoexistence, et votre backend reçoit le token de l'API Instagram de Meta par l'appel d'identifiants.

Un client peut-il connecter plusieurs comptes Instagram ?

Oui, un par connexion. Créez une session de connexion pour chaque compte avec le même external_ref, et GET /channels?external_ref= les liste tous pour ce client.

Mon application peut-elle programmer des Stories Instagram ?

Oui. Réglez ig_type sur STORIES avec une image ou une vidéo et une heure publish_at, et la file la publiera à ce moment-là.

Combien coûte easyCoexistence par compte Instagram ?

Chaque compte connecté coûte de US$ 9 à US$ 0,75 par mois, selon la tranche de vos connexions totales, avec les 3 premiers jours en essai gratuit.

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