AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

Instagram messaging_postbacks Webhook: Ice Breaker und Buttons

Das Webhook-Feld messaging_postbacks von Instagram benachrichtigt eine App, wenn eine Person in einer Konversation mit einem professionellen Konto eine Ice-Breaker-Frage, einen Postback-Button in einem Template oder einen Eintrag im persistenten Menü antippt. Das postback-Objekt des Ereignisses enthält title, den Text, den die Person angetippt hat; payload, die Zeichenfolge, die die App für diese Option festgelegt hat; und mid, die Nachrichten-ID, ab Graph API v11.0.

easyCoexistence abonniert jedes verbundene Instagram-Konto für comments, messages und mentions und leitet diese Ereignisse, einschließlich Quick-Reply-Auswahlen, sobald sie eintreffen, an Ihren HTTPS-Endpoint weiter, signiert mit dem Secret dieses Kontos und ohne eine Kopie zu speichern.

4

Höchstens 4 Ice-Breaker-Fragen, die ein Konto über die Ice Breaker API von Meta festlegen kann.

v11.0

Graph-API-Version, ab der Postback-Ereignisse mid enthalten; das Feld selbst benötigt v8.0 oder neuer.

3

Höchstens 3 Schaltflächen in einer Button-Template-Nachricht, jede ein Postback- oder web_url-Button.

24 hours

Antwortzeit nach dem Antippen eines Eintrags im persistenten Menü, der das Standard-Messaging-Fenster öffnet.

13

Höchstens 13 Quick Replies, die eine Nachricht anbietet; eine angetippte Quick Reply kommt über messages an, nicht über messaging_postbacks.

Wann löst messaging_postbacks aus?

Wenn eine Person eine der strukturierten Optionen des Kontos in einer Konversation antippt, sobald App und Konto für das Feld abonniert sind. Metas Leitfäden nennen diese Quellen:

  • Eine Ice-Breaker-Frage, von denen das Konto bis zu 4 anbietet, wenn eine Konversation beginnt. Nicht auf dem Desktop verfügbar.
  • Ein Postback-Button in einem Button-Template, bis zu 3 pro Nachricht, oder in einem generischen Template, bis zu 3 pro Element.
  • Ein Postback-Eintrag im persistenten Menü des Kontos.
  • Eine Ice-Breaker-Frage, angetippt in einer neuen Konversation, die über einen ig.me-Link mit ref-Parameter geöffnet wurde: Das Postback enthält dann zusätzlich referral.
  • Ein Selbstnachricht-Test, bei dem das Konto seinen eigenen Button antippt: Das Ereignis enthält is_self mit dem Wert true.

Wie sieht eine Postback-Benachrichtigung aus?

Ein Messaging-Ereignis mit einem postback-Objekt, wo sonst eine DM ihre Nachricht enthielte. Metas Beispiel für Instagram Login enthält mid, title und payload, und der Ice-Breaker-Leitfaden zeigt dasselbe Objekt ohne mid. Eine Benachrichtigung sieht so aus:

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

Was bedeutet jedes Feld?

Die Felder, die Meta für ein Postback dokumentiert, von außen nach innen:

  • sender.id: die Instagram-scoped-ID der Person, die angetippt hat, also die ID, an die Sie antworten. recipient.id und entry[].id: das professionelle Konto.
  • timestamp: wann die Person angetippt hat, laut Metas Ice-Breaker-Leitfaden.
  • postback.title: die Ice-Breaker-Frage oder der Button-Titel, den die Person gesehen hat.
  • postback.payload: die Zeichenfolge, die für diese Option bei der Erstellung festgelegt wurde, von der App gewählt.
  • postback.mid: die ID der Nachricht, die der Tipp an das Konto gesendet hat, ab Graph API v11.0.
  • postback.referral: ref, source und type, wenn die Konversation über einen ig.me-Link mit ref-Parameter geöffnet wurde.
  • is_self: auf true gesetzt, neben postback, wenn das Konto im Selbstnachricht-Test seinen eigenen Button antippt.

Wie werden Ice Breaker festgelegt?

Mit POST /<IG_ID>/messenger_profile auf graph.instagram.com: platform auf instagram gesetzt und ein Array ice_breakers, dessen call_to_actions bis zu 4 Paare aus Frage und payload enthalten, mit einem locale für jeden übersetzten Satz. GET /me/messenger_profile?fields=ice_breakers listet sie auf, und ein DELETE mit fields auf ice_breakers entfernt sie. Der hier gewählte payload ist das, was messaging_postbacks zurückgibt, wenn die Frage angetippt wird.

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

Wie werden Postback-Buttons gesendet?

In einer Nachricht, die das Konto mit POST /<IG_ID>/messages sendet. Ein Button-Template enthält text mit bis zu 640 Zeichen und 1 bis 3 Buttons; ein generisches Template enthält bis zu 10 Elemente, jedes mit bis zu 3 Buttons. Ein Button vom Typ postback gibt beim Antippen seinen payload auf messaging_postbacks zurück, während ein web_url-Button stattdessen eine Seite im In-App-Browser öffnet. Das persistente Menü, auf messenger_profile gesetzt, kennt dieselben zwei Typen.

Verwenden Quick Replies messaging_postbacks?

Nein: Sie kommen über messages an. Eine angetippte Quick Reply wird mit ihrem Titel als Nachricht in die Konversation gestellt, und das messages-Ereignis enthält text mit diesem Titel und quick_reply.payload mit der Payload der Option. Eine Nachricht kann bis zu 13 Quick Replies mit je bis zu 20 Zeichen anbieten, nur Klartext. Metas Instagram-Messaging-Leitfaden nennt Ice-Breaker- und generische-Template-Auswahlen ebenfalls unter dem, was messages meldet, ohne Beispiel-payload.

Öffnet ein Tipp das Messaging-Fenster?

Für das persistente Menü sagt Meta es: Ein Tipp auf einen Menüpunkt öffnet das Standard-Messaging-Fenster, und das Konto hat 24 Stunden, um zu antworten. Antworten Sie mit POST /<IG_ID>/messages, wobei recipient.id auf die sender.id des Postbacks gesetzt wird. Die Antwort des Kontos kommt über messages als echo zurück, mit is_echo auf true gesetzt.

Leitet easyCoexistence Postbacks weiter?

Nur Quick-Reply-Auswahlen. Sie kommen über messages an, das die App von easyCoexistence und jedes verbundene Konto abonniert haben, und erreichen Ihren Endpoint daher mit ihrem quick_reply.payload. Das Antippen von Ice Breakern, Buttons und Menüpunkten kommt über messaging_postbacks, das easyCoexistence nicht abonniert, daher wird es nicht weitergeleitet.

Häufige Fehler

  • Quick Replies über messaging_postbacks erwarten. Eine Quick Reply kommt über messages an, mit quick_reply.payload neben dem Text der angetippten Option.
  • Routing über postback.title. Der Titel ist das, was die Person gesehen hat, und kann je nach Locale abweichen; routen Sie über payload, den die App setzt.
  • Ein mid bei einer älteren API-Version erwarten. Meta enthält postback.mid erst ab Graph API v11.0.
  • Mehr als 4 Ice Breaker festlegen oder sie auf dem Desktop testen. Die Ice Breaker API von Meta nimmt bis zu 4 Fragen an, und die Funktion ist auf dem Desktop nicht verfügbar.
Mit EasyCoexistence

send_social_dm antwortet der Person innerhalb des 24-Stunden-Fensters. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend, je mehr Verbindungen Sie hinzufügen, mit den ersten 3 Tagen als kostenlose Testphase.

Häufig gestellte Fragen

Welches Webhook-Feld meldet Antippen von Ice Breakern auf Instagram?

messaging_postbacks. Das postback-Objekt enthält die Frage als title und die dafür festgelegte Payload, dazu mid ab Graph API v11.0.

Wie viele Ice Breaker kann ein Instagram-Konto haben?

Bis zu 4 Fragen, festgelegt mit POST /<IG_ID>/messenger_profile und platform auf instagram gesetzt, optional pro locale.

Wie antworten Sie auf einen Instagram-Postback?

Mit POST /<IG_ID>/messages und recipient.id auf die sender.id des Postbacks gesetzt, also die Instagram-scoped-ID der Person, die angetippt hat. Nach einem Tipp auf einen Menüpunkt gibt Meta dem Konto 24 Stunden Zeit für die Antwort.

Sollten Sie Instagram-Postbacks per title oder payload routen?

Per payload, die Zeichenfolge, die die App für die Option festgelegt hat. title ist der Text, den die Person gesehen hat; er kann je nach Locale abweichen.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am