Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Les DM Instagram via l'API et la fenêtre de 24 heures

Via l'API d'Instagram, un compte professionnel peut répondre à toute personne lui ayant envoyé un DM, pendant une fenêtre de messagerie standard qui dure 24 heures pour la plupart des conversations. La personne doit écrire en premier, et le compte doit activer « Autoriser l'accès aux messages » dans l'application Instagram avant qu'une application puisse lire ou envoyer ses DM.

easyCoexistence répond aux DM Instagram avec send_social_dm depuis Claude, ChatGPT ou votre propre code, dans la fenêtre de 24 heures, et transmet les nouveaux DM à votre endpoint dès leur arrivée.

24 hours

La fenêtre standard pour répondre après un message de la personne, pour la plupart des actions de l'utilisateur.

7 days

La fenêtre distincte Human Agent de Meta, pour les réponses qu'une personne écrit et marque human_agent.

1,000 bytes

Le texte le plus long qu'un DM peut contenir via l'API, encodé en UTF-8.

2534022

Sous-code d'erreur, sous le code 10, pour un message envoyé hors de la fenêtre autorisée.

30 days

Inactivité au-delà de laquelle une conversation du dossier Demandes n'est plus renvoyée par l'API.

Qui un compte peut-il contacter via l'API ?

Toute personne qui lui a déjà écrit. Les conversations ne commencent que lorsqu'une personne écrit au compte, depuis le fil d'actualité, une publication, une mention dans une story ou ailleurs ; ensuite, une application peut lui répondre. Une personne qui commente une publication peut aussi recevoir une réponse privée, expliquée plus bas.

L'API ne permet pas d'envoyer le premier message, et les conversations de groupe ne sont pas prises en charge : chaque conversation se tient entre le compte et une seule personne.

Quelle est la durée de la fenêtre de messagerie ?

24 heures pour la plupart des conversations. Meta parle de fenêtre de messagerie standard, et l'action qui l'ouvre en fixe la durée : un message de la personne ouvre 24 heures, et son message suivant la rouvre. Lorsque le premier message vient d'une personne ayant cliqué sur une publicité Click-to-Direct, la fenêtre peut durer jusqu'à 7 jours.

Meta prévoit aussi une fenêtre distincte Human Agent de 7 jours, pour les réponses écrites par une personne et marquées human_agent par une application dotée de cette fonction, destinée aux demandes que la fenêtre standard ne peut pas couvrir. Un envoi hors de toute fenêtre ouverte échoue avec le code 10, sous-code 2534022.

Qu'est-ce que le réglage « Autoriser l'accès aux messages » ?

Un réglage de l'application Instagram qui permet aux outils connectés de lire et d'envoyer les messages privés du compte. Selon le guide de Meta, il se trouve dans Paramètres, Messages et réponses aux stories, Contrôles des messages, Outils connectés, et un compte doit l'activer avant qu'une application puisse gérer ses DM. Tant qu'il est désactivé, les envois échouent avec le code 200, sous-code 2534041 : le titulaire du compte a désactivé l'accès aux messages directs Instagram.

Comment fonctionnent les réponses privées aux commentaires ?

Un compte professionnel peut envoyer un seul message à une personne ayant commenté sa publication, son Reel ou sa story, dans les 7 jours suivant le commentaire, ou sur un Live uniquement pendant la diffusion. Le message arrive dans la boîte de réception de la personne si elle suit le compte, et dans les demandes de messages sinon ; il contient un lien vers la publication. Une relance doit attendre la réponse de la personne, puis part dans les 24 heures suivant cette réponse.

Où apparaissent les conversations API dans l'application ?

Dans la boîte de réception Instagram habituelle du compte, avec quelques différences à connaître  :

  • Les nouvelles conversations des abonnés commencent dans Principal ; celles des personnes qui ne suivent pas le compte, dans Demandes.
  • Une conversation à laquelle on répond via une application passe dans le dossier Général, quels que soient les réglages de la boîte de réception.
  • Les messages remis à une application ne sont pas marqués comme lus dans l'application Instagram tant qu'aucune réponse n'est envoyée.
  • Les demandes sans activité depuis 30 jours ne sont plus renvoyées par l'API.

Quelle est la cadence d'envoi d'un compte ?

Meta fixe les limites de messagerie par compte professionnel Instagram, indépendamment des autres appels API de l'application  :

  • Texte, liens, réactions et stickers : 100 appels par seconde.
  • Audio ou vidéo : 10 appels par seconde.
  • Réponses privées aux commentaires de publications et de Reels : 750 appels par heure.
  • Conversations API : 2 appels par seconde.

Que peut contenir un message ?

Du texte, des liens, des images, de l'audio, des vidéos, des fichiers PDF, des stickers, des réactions, des templates et des publications dont le compte est propriétaire. Le texte doit être en UTF-8 et ne pas dépasser 1 000 octets, ce qui représente moins de caractères dès que des accents et des emojis entrent en jeu. Les images peuvent être au format PNG ou JPEG, jusqu'à 8 Mo, et les fichiers audio, vidéo et PDF jusqu'à 25 Mo.

Erreurs courantes

  • Laisser le réglage « Autoriser l'accès aux messages » désactivé. Les envois échouent avec le code 200, sous-code 2534041, tant que le compte ne l'active pas dans l'application.
  • Compter les caractères au lieu des octets. Une lettre accentuée prend deux octets en UTF-8, la plupart des emojis quatre, si bien qu'un texte qui passe une vérification de 1 000 caractères peut encore être refusé.
  • Envoyer une deuxième réponse privée au même commentaire. Meta n'en autorise qu'une ; le message suivant attend la réponse de la personne.
  • Calculer la fenêtre à partir du premier message de la conversation. Elle part du dernier message de la personne, si bien que chaque réponse de sa part laisse plus de temps au compte.
Faire cela avec EasyCoexistence

Les automatisations peuvent répondre seules, avec un texte fixe ou une IA, et les règles commentaire-vers-DM envoient des réponses privées à toute heure. 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

Un professionnel peut-il envoyer le premier DM sur Instagram ?

Pas via l'API. La personne doit d'abord écrire au compte, ou commenter l'une de ses publications, ce qui permet une seule réponse privée dans les 7 jours.

Que se passe-t-il quand les 24 heures sont écoulées ?

L'API refuse l'envoi tant que la personne n'a pas réécrit, ce qui ouvre une nouvelle fenêtre. Les réponses écrites par une personne peuvent utiliser la fenêtre distincte Human Agent de Meta, de 7 jours, avec le tag human_agent.

Quelle est la longueur maximale d'un DM Instagram envoyé via l'API ?

Jusqu'à 1 000 octets de texte UTF-8 par message. Les accents et les emojis occupent chacun plus d'un octet, donc un message qui en contient tient en moins de 1 000 caractères.

Les messages lus via l'API apparaissent-ils comme lus dans l'application ?

Non. Un message remis à une application reste non lu dans la boîte Instagram tant qu'aucune réponse n'est envoyée.

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