InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram messaging_postbacks-webhook: ice breakers en knoppen

Het webhook-veld messaging_postbacks van Instagram stuurt een app een melding wanneer iemand in een gesprek met een professioneel account een ice breaker-vraag, een postback-knop in een template of een item uit het persistent menu aanraakt. Het postback-object van de gebeurtenis bevat title, de tekst die de persoon aanraakte; payload, de string die de app voor die optie instelde; en mid, de bericht-ID, vanaf Graph API v11.0.

easyCoexistence abonneert elk verbonden Instagram-account op comments, messages en mentions en stuurt die gebeurtenissen, inclusief quick reply-tikken, door naar je HTTPS-endpoint zodra ze binnenkomen, ondertekend met de geheime sleutel van dat account en zonder kopie te bewaren.

4

Het maximum aantal ice breaker-vragen dat een account kan instellen via de Ice Breaker API van Meta.

v11.0

De Graph API-versie vanaf waar postback-gebeurtenissen mid bevatten; het veld zelf vereist v8.0 of later.

3

Het maximum aantal knoppen in een button template-bericht, elk een postback- of web_url-knop.

24 hours

Reactietijd nadat iemand een item uit het persistent menu aanraakt, wat het standaard berichtenvenster opent.

13

Het maximum aantal quick replies dat één bericht aanbiedt; een aangeraakte quick reply komt binnen op messages, niet op messaging_postbacks.

Wanneer wordt messaging_postbacks verstuurd?

Wanneer een persoon in een gesprek een van de gestructureerde opties van het account aanraakt, zodra de app en het account zijn geabonneerd op het veld. De gidsen van Meta noemen deze bronnen:

  • Een ice breaker-vraag, een van maximaal 4 die het account aanbiedt wanneer een gesprek begint. Niet beschikbaar op desktop.
  • Een postback-knop in een button template, maximaal 3 per bericht, of in een generic template, maximaal 3 per element.
  • Een postback-item in het persistent menu van het account.
  • Een ice breaker aangeraakt in een nieuw gesprek dat is geopend vanuit een ig.me-link met een ref-parameter: de postback bevat dan ook referral.
  • Een zelf-berichtentest, waarin het account zijn eigen knop aanraakt: de gebeurtenis krijgt is_self met de waarde true.

Hoe ziet een postback-melding eruit?

Een messaging-gebeurtenis met een postback-object op de plek waar een DM zijn bericht zou hebben. Het voorbeeld van Meta voor Instagram Login bevat mid, title en payload, en de ice breaker-gids toont hetzelfde object zonder mid. Een melding ziet er zo uit:

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>"
          }
        }
      ]
    }
  ]
}

Wat betekent elk veld?

De velden die Meta voor een postback documenteert, van buiten naar binnen:

  • sender.id: de Instagram-scoped ID van de persoon die aanraakte, de ID om naar terug te antwoorden. recipient.id en entry[].id: het professionele account.
  • timestamp: wanneer de persoon aanraakte, volgens de ice breaker-gids van Meta.
  • postback.title: de ice breaker-vraag of de knoptitel die de persoon zag.
  • postback.payload: de string die bij het aanmaken voor die optie is ingesteld, gekozen door de app.
  • postback.mid: de ID van het bericht dat de tik naar het account stuurde, vanaf Graph API v11.0.
  • postback.referral: ref, source en type, wanneer het gesprek is geopend vanuit een ig.me-link met een ref-parameter.
  • is_self: ingesteld op true, naast postback, wanneer het account zijn eigen knop aanraakt in een zelf-berichtentest.

Hoe worden ice breakers ingesteld?

Met POST /<IG_ID>/messenger_profile op graph.instagram.com: platform ingesteld op instagram en een ice_breakers-array waarin call_to_actions maximaal 4 vraag- en payload-paren bevatten, met een locale voor elke vertaalde set. GET /me/messenger_profile?fields=ice_breakers toont ze, en een DELETE met fields op ice_breakers verwijdert ze. De hier gekozen payload is wat messaging_postbacks teruggeeft wanneer de vraag wordt aangeraakt.

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>" }
      ]
    }
  ]
}

Hoe worden postback-knoppen verstuurd?

In een bericht dat het account verstuurt met POST /<IG_ID>/messages. Een button template bevat text van maximaal 640 tekens en 1 tot 3 knoppen; een generic template bevat maximaal 10 elementen, elk met maximaal 3 knoppen. Een knop van type postback geeft zijn payload terug op messaging_postbacks wanneer hij wordt aangeraakt, terwijl een web_url-knop in plaats daarvan een pagina opent in de in-app browser. Het persistent menu, ingesteld op messenger_profile, kent dezelfde twee typen.

Gebruiken quick replies messaging_postbacks?

Nee: ze komen binnen op messages. Een aangeraakte quick reply plaatst zijn title als bericht in het gesprek, en de messages-gebeurtenis bevat text ingesteld op die title en quick_reply.payload ingesteld op de payload van de optie. Een bericht kan maximaal 13 quick replies aanbieden van elk maximaal 20 tekens, alleen platte tekst. De Instagram Messaging-gids van Meta noemt ook ice breaker- en generic template-selecties tussen wat messages meldt, zonder voorbeeld-payload.

Opent een tik het berichtenvenster?

Voor het persistent menu zegt Meta van wel: een tik op een menu-item opent het standaard berichtenvenster, en het account heeft 24 uur om te antwoorden. Antwoord met POST /<IG_ID>/messages en recipient.id ingesteld op de sender.id van de postback. Het antwoord van het account komt terug op messages als echo, met is_echo ingesteld op true.

Stuurt easyCoexistence postbacks door?

Alleen quick reply-tikken. Die komen binnen op messages, waarop de app van easyCoexistence en elk verbonden account geabonneerd zijn, dus ze bereiken je endpoint met quick_reply.payload. Ice breaker-, knop- en menutikken komen binnen op messaging_postbacks, waarop easyCoexistence niet abonneert, dus die worden niet doorgestuurd.

Veelgemaakte fouten

  • Wachten op quick replies op messaging_postbacks. Een quick reply komt binnen op messages, met quick_reply.payload naast de tekst van de aangeraakte optie.
  • Routeren op postback.title. De title is wat de persoon zag en kan per locale verschillen; route op payload, die de app instelt.
  • Een mid verwachten op een oudere API-versie. Meta bevat postback.mid alleen vanaf Graph API v11.0.
  • Meer dan 4 ice breakers instellen, of ze testen op desktop. De Ice Breaker API van Meta neemt maximaal 4 vragen aan, en de functie is niet beschikbaar op desktop.
Dit doen met EasyCoexistence

send_social_dm antwoordt de persoon binnen het 24-uursvenster. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Welk webhook-veld meldt tikken op Instagram ice breakers?

messaging_postbacks. Het postback-object bevat de vraag als title en de payload die ervoor is ingesteld, plus mid vanaf Graph API v11.0.

Hoeveel ice breakers kan een Instagram-account hebben?

Maximaal 4 vragen, ingesteld met POST /<IG_ID>/messenger_profile en platform ingesteld op instagram, optioneel per locale.

Hoe antwoord ik op een Instagram-postback?

Met POST /<IG_ID>/messages en recipient.id ingesteld op de sender.id van de postback, de Instagram-scoped ID van de persoon die aanraakte. Na een tik op het persistent menu geeft Meta het account 24 uur om te antwoorden.

Moet ik Instagram-postbacks routeren op title of op payload?

Op payload, de string die de app voor de optie instelde. title is de tekst die de persoon zag, die per locale kan verschillen.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op