Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Mentions et réponses aux Stories Instagram dans le webhook

Instagram livre les mentions et réponses aux Stories sous forme de messages privés, sur le champ messages du webhook. Une mention arrive comme un message dont attachments contient un élément de type story_mention, avec l'URL CDN de la Story dans payload.url. Une réponse porte le texte de la personne et reply_to.story, avec l'url et l'id de la Story et, pour une Story avec autocollant de lien, link_sticker_url.

easyCoexistence abonne chaque compte Instagram connecté au champ messages, si bien que les mentions et réponses en Story arrivent à votre endpoint HTTPS avec ses autres messages privés dès leur réception, signés avec le secret de ce compte et sans copie conservée.

story_mention

Type de pièce jointe de l'événement messages envoyé par Meta quand quelqu'un mentionne le compte dans sa Story.

link_sticker_url

Champ ajouté par Meta à reply_to.story le 12 décembre 2025, contenant l'URL de l'autocollant de lien de la Story à laquelle on répond.

24 hours

Durée de vie d'une Story ; une fois expirée ou supprimée, son URL de mention ne s'affiche plus.

Public

Comptes dont les mentions en Story arrivent ; la mention d'un compte privé n'arrive que s'il suit le compte professionnel.

GIF, sticker

Réponses aux Stories que le webhook ne prend pas en charge, selon le guide de messagerie Instagram de Meta.

Comment arrive une mention en Story ?

Sous forme de message privé. Quand une personne mentionne le compte professionnel dans sa Story, Instagram place dans la boîte de réception du compte un message qui renvoie à cette Story, et Meta envoie un événement messages à ce sujet. sender.id est l'identifiant Instagram propre à la personne, et message.attachments contient un seul élément de type story_mention dont payload.url est l'URL CDN de la Story. Les exemples de Meta ne comportent aucun texte ; lisez donc la pièce jointe :

A Story mention, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "message": {
            "mid": "<MESSAGE_ID>",
            "attachments": [
              {
                "type": "story_mention",
                "payload": { "url": "<CDN_URL>" }
              }
            ]
          }
        }
      ]
    }
  ]
}

Comment arrive une réponse à une Story ?

Également sous forme de message privé, avec le message de la personne et un objet reply_to qui pointe vers la Story du compte. reply_to.story contient l'url CDN de la Story et son id. La référence des webhooks de Meta mentionne aussi link_sticker_url à cet endroit, ajouté en décembre 2025 pour les réponses à des Stories avec un autocollant de lien, que Meta suggère pour router des automatisations par lien. Une réponse en ligne à un message précédent utilise à la place reply_to.mid.

The message object of a Story reply
"message": {
  "mid": "<MESSAGE_ID>",
  "text": "<MESSAGE_TEXT>",
  "reply_to": {
    "story": {
      "url": "<CDN_URL>",
      "id": "<STORY_ID>"
    }
  }
}

Que signifie chaque champ ?

Les champs que Meta documente pour ces deux événements, de l'extérieur vers l'intérieur :

  • entry[].id et recipient.id : le compte professionnel. sender.id : l'identifiant Instagram propre à la personne, celui auquel une réponse est adressée.
  • timestamp : le moment d'envoi du message, en millisecondes dans les exemples de Meta ; entry[].time est le moment où Meta a envoyé la notification.
  • message.mid : l'identifiant du message, pour dédupliquer les nouvelles tentatives et pour répondre avec reply_to.mid.
  • attachments[].type story_mention et payload.url : une mention, et l'URL CDN de la Story qui l'a produite.
  • reply_to.story.url et reply_to.story.id : la Story du compte à laquelle la personne a répondu.
  • reply_to.story.link_sticker_url : l'URL portée par l'autocollant de lien de cette Story.
  • message.text : les mots de la réponse, présents quand le message contient du texte.

Combien de temps l'URL de la Story fonctionne-t-elle ?

Aussi longtemps que la Story. Une Story disparaît après 24 heures ou lorsque son auteur la supprime ; le guide des mentions en Story de Meta indique que l'URL cesse alors de s'afficher, et sa présentation générale ajoute que les URL CDN d'Instagram respectent la vie privée et ne renvoient rien pour un contenu supprimé ou expiré. Le même guide autorise à conserver l'URL CDN mais pas le média : une application ne doit pas stocker ni mettre en cache le contenu de la Story sur ses serveurs, et doit afficher un espace réservé une fois la Story disparue.

Quand aucun des deux événements ne se déclenche-t-il ?

Les guides de Meta citent ces cas, où un gestionnaire qui attend un événement de Story ne reçoit rien :

  • Une mention en Story par un compte privé qui ne suit pas le compte professionnel.
  • Un marquage dans une publication classique : Meta précise que seules les mentions en Story déclenchent le webhook messages, pas le marquage dans les publications.
  • Une réponse à une Story faite avec un GIF ou un autocollant, que le webhook ne prend pas en charge.
  • Les Stories passant par l'API de mentions : GET /<IG_ID>/tags et POST /<IG_ID>/mentions ne les prennent pas en charge, si bien que le message privé est la voie par laquelle arrive une mention en Story.

Les mentions et réponses en Story ouvrent-elles la fenêtre de messagerie ?

Une réponse est un message de la personne, et Meta range les mentions en Story parmi les canaux par lesquels une personne démarre une conversation. La fenêtre ouverte par son action dure 24 heures pour la plupart des actions ; le compte peut donc répondre avec POST /<IG_ID>/messages et recipient.id égal au sender.id de l'événement tant qu'elle est ouverte. La réponse du compte revient sur messages sous forme d'écho, avec is_echo à true.

Comment easyCoexistence les transmet-il ?

Sur le champ messages, auquel chaque compte connecté est abonné ; les mentions et réponses en Story arrivent donc à votre endpoint avec les autres messages privés du compte : chaque entrée est placée dans une enveloppe composée de platform, account_id, external_id et entry, signée dans X-EC-Signature avec le secret du compte, envoyée une fois et sans copie conservée. send_social_dm répond à la personne en prenant le sender.id de l'événement comme recipient_id, dans la fenêtre de 24 heures.

A forwarded Story mention, headers included
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>

{
  "platform": "instagram",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<IG_ID>",
  "entry": {
    "id": "<IG_ID>",
    "time": 1793448000512,
    "messaging": [
      {
        "sender": { "id": "<IGSID>" },
        "recipient": { "id": "<IG_ID>" },
        "timestamp": 1793447999874,
        "message": {
          "mid": "<MESSAGE_ID>",
          "attachments": [
            { "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
          ]
        }
      }
    ]
  }
}

Erreurs courantes

  • Stocker le média de la Story. Le guide des mentions en Story de Meta autorise à conserver l'URL CDN, pas le contenu, qui ne doit pas être stocké ni mis en cache sur vos serveurs.
  • Ne lire que message.text. Une mention en Story porte une pièce jointe de type story_mention et, dans les exemples de Meta, aucun texte ; un gestionnaire qui ne lit que le texte voit donc un message vide.
  • Afficher l'URL de la Story des jours plus tard. Elle cesse de fonctionner une fois la Story expirée au bout de 24 heures ou supprimée ; affichez donc un espace réservé à partir de là.
  • Chercher les mentions en Story sur le champ comments ou dans l'API de mentions. Meta les livre sous forme de messages privés, sur messages.
Faire cela avec EasyCoexistence

send_social_dm répond à la personne dans la fenêtre de 24 heures, depuis Claude, ChatGPT ou votre propre code. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Un événement de mention en Story Instagram contient-il du texte ?

Pas dans les exemples de Meta. Une mention en Story porte une pièce jointe de type story_mention avec l'URL CDN de la Story, si bien qu'un gestionnaire qui ne lit que message.text voit un message vide.

Que contient link_sticker_url dans une réponse à une Story Instagram ?

L'URL portée par l'autocollant de lien de la Story à laquelle la personne a répondu, dans reply_to.story.link_sticker_url. Meta l'a ajoutée le 12 décembre 2025 et la suggère pour router des automatisations par lien.

Les réponses à une Story avec un GIF ou un autocollant déclenchent-elles le webhook ?

Non. Le guide de messagerie Instagram de Meta indique que le webhook ne prend pas en charge les réponses aux Stories faites avec un GIF ou un autocollant.

Les comptes privés déclenchent-ils les webhooks de mention en Story ?

Seulement lorsque le compte privé suit le compte professionnel. Les mentions venant de comptes publics arrivent au moment où elles se produisent.

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