Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Webhook messaging_postbacks d'Instagram : ice breakers et boutons

Le champ webhook messaging_postbacks d'Instagram avertit une application lorsqu'une personne appuie sur une question d'ice breaker, sur un bouton postback dans un template, ou sur un élément du menu persistant dans une conversation avec un compte professionnel. L'objet postback de l'événement contient title, le texte appuyé par la personne ; payload, la chaîne définie par l'application pour cette option ; et mid, l'identifiant du message, à partir de Graph API v11.0.

easyCoexistence abonne chaque compte Instagram connecté aux commentaires, aux messages et aux mentions, et transmet ces événements, appuis sur les quick replies inclus, à votre endpoint HTTPS dès leur arrivée, signés avec le secret de ce compte et sans copie conservée.

4

Nombre maximal de questions ice breaker qu'un compte peut définir via l'API Ice Breaker de Meta.

v11.0

Version de Graph API à partir de laquelle les événements postback incluent mid ; le champ lui-même requiert la v8.0 ou une version ultérieure.

3

Nombre maximal de boutons dans un message de type button template, chacun étant un bouton postback ou web_url.

24 hours

Délai de réponse après qu'une personne a appuyé sur un élément du menu persistant, qui ouvre la fenêtre de messagerie standard.

13

Nombre maximal de quick replies qu'un message propose ; une quick reply appuyée arrive sur messages, pas sur messaging_postbacks.

Quand messaging_postbacks se déclenche-t-il ?

Lorsqu'une personne appuie sur l'une des options structurées du compte dans une conversation, une fois l'application et le compte abonnés au champ. Les guides de Meta listent ces sources :

  • Une question ice breaker, l'une des 4 maximum que le compte propose au début d'une conversation. Non disponible sur ordinateur.
  • Un bouton postback dans un button template, jusqu'à 3 par message, ou dans un generic template, jusqu'à 3 par élément.
  • Un élément postback du menu persistant du compte.
  • Un ice breaker appuyé dans une nouvelle conversation ouverte depuis un lien ig.me avec un paramètre ref : le postback transporte alors aussi referral.
  • Un test d'auto-messagerie, où le compte appuie sur son propre bouton : l'événement ajoute is_self défini sur true.

À quoi ressemble une notification postback ?

Un événement de messagerie avec un objet postback à la place du contenu d'un message privé. L'exemple de Meta pour Instagram Login contient mid, title et payload, et son guide ice breaker montre le même objet sans mid. Une notification ressemble à ceci :

A messaging_postbacks notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "postback": {
            "mid": "<MESSAGE_ID>",
            "title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
            "payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
          }
        }
      ]
    }
  ]
}

Que signifie chaque champ ?

Les champs que Meta documente pour un postback, de l'extérieur vers l'intérieur :

  • sender.id : l'identifiant Instagram de la personne qui a appuyé, l'identifiant auquel répondre. recipient.id et entry[].id : le compte professionnel.
  • timestamp : moment où la personne a appuyé, selon le guide ice breaker de Meta.
  • postback.title : la question ice breaker ou le titre du bouton tel que la personne l'a vu.
  • postback.payload : la chaîne définie pour cette option lors de sa création, choisie par l'application.
  • postback.mid : l'identifiant du message envoyé au compte par cet appui, à partir de Graph API v11.0.
  • postback.referral : ref, source et type, lorsque la conversation a été ouverte depuis un lien ig.me avec un paramètre ref.
  • is_self : défini sur true, à côté de postback, lorsque le compte appuie sur son propre bouton lors d'un test d'auto-messagerie.

Comment sont définis les ice breakers ?

Avec POST /<IG_ID>/messenger_profile sur graph.instagram.com : platform défini sur instagram et un tableau ice_breakers dont les call_to_actions contiennent jusqu'à 4 couples question et payload, avec une locale pour chaque ensemble traduit. GET /me/messenger_profile?fields=ice_breakers les liste, et un DELETE avec fields défini sur ice_breakers les supprime. Le payload choisi ici est celui que messaging_postbacks renvoie lorsque la question est appuyée.

Setting two ice breakers
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "platform": "instagram",
  "ice_breakers": [
    {
      "call_to_actions": [
        { "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
        { "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
      ]
    }
  ]
}

Comment envoyer des boutons postback ?

Dans un message que le compte envoie avec POST /<IG_ID>/messages. Un button template contient un texte de 640 caractères au maximum et 1 à 3 boutons ; un generic template contient jusqu'à 10 éléments, chacun avec jusqu'à 3 boutons. Un bouton de type postback renvoie son payload sur messaging_postbacks lorsqu'il est appuyé, tandis qu'un bouton web_url ouvre une page dans le navigateur intégré à l'application. Le menu persistant, défini sur messenger_profile, accepte les deux mêmes types.

Les quick replies utilisent-elles messaging_postbacks ?

Non : elles arrivent sur messages. Une quick reply appuyée publie son titre dans la conversation sous forme de message, et l'événement messages contient text défini sur ce titre et quick_reply.payload défini sur le payload de l'option. Un message peut proposer jusqu'à 13 quick replies de 20 caractères au maximum chacune, en texte brut uniquement. Le guide de messagerie Instagram de Meta mentionne aussi les sélections d'ice breaker et de generic template parmi ce que messages signale, sans exemple de payload.

Un appui ouvre-t-il la fenêtre de messagerie ?

Pour le menu persistant, Meta le précise : un appui sur un élément du menu ouvre la fenêtre de messagerie standard, et le compte dispose de 24 heures pour répondre. Répondez avec POST /<IG_ID>/messages et recipient.id défini sur le sender.id du postback. La réponse du compte revient sur messages sous forme d'écho, avec is_echo défini sur true.

easyCoexistence transmet-il les postbacks ?

Seuls les appuis sur les quick replies. Ils arrivent sur messages, auquel l'app d'easyCoexistence et chaque compte connecté sont abonnés, et atteignent donc votre endpoint avec leur quick_reply.payload. Les appuis sur les ice breakers, les boutons et le menu arrivent sur messaging_postbacks, auquel easyCoexistence ne s'abonne pas : ils ne sont donc pas transmis.

Erreurs courantes

  • Attendre les quick replies sur messaging_postbacks. Une quick reply arrive sur messages, avec quick_reply.payload à côté du texte de l'option appuyée.
  • Router sur postback.title. Le title est ce que la personne a vu et peut varier selon la locale ; routez sur payload, défini par l'application.
  • Attendre mid sur une ancienne version d'API. Meta n'inclut postback.mid qu'à partir de Graph API v11.0.
  • Définir plus de 4 ice breakers, ou les tester sur ordinateur. L'API Ice Breaker de Meta accepte jusqu'à 4 questions, et la fonctionnalité n'est pas disponible sur ordinateur.
Faire cela avec EasyCoexistence

send_social_dm répond à la personne dans la fenêtre de 24 heures. 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

Quel champ webhook signale les appuis sur les ice breakers Instagram ?

messaging_postbacks. L'objet postback contient la question dans title et le payload défini pour elle, plus mid à partir de Graph API v11.0.

Combien d'ice breakers un compte Instagram peut-il avoir ?

Jusqu'à 4 questions, définies avec POST /<IG_ID>/messenger_profile et platform défini sur instagram, éventuellement par locale.

Comment répondre à un postback Instagram ?

Avec POST /<IG_ID>/messages et recipient.id défini sur le sender.id du postback, l'identifiant Instagram de la personne qui a appuyé. Après un appui sur le menu persistant, Meta accorde au compte 24 heures pour répondre.

Faut-il router les postbacks Instagram sur title ou sur payload ?

Sur payload, la chaîne définie par l'application pour l'option. title est le texte vu par la personne, qui peut varier selon la locale.

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