Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Instagram webhook messaging_postbacks: ice breaker i gumbi

Instagram polje webhooka messaging_postbacks obavještava aplikaciju kad osoba dodirne ice breaker pitanje, postback gumb u predlošku ili stavku trajnog izbornika u razgovoru s profesionalnim računom. Objekt postback događaja nosi title, tekst koji je osoba dodirnula; payload, niz koji je aplikacija postavila za tu opciju; i mid, ID poruke, od Graph API v11.0.

easyCoexistence pretplaćuje svaki povezani Instagram račun na comments, messages i mentions te prosljeđuje te događaje, uključujući dodire brzih odgovora, na vaš HTTPS endpoint čim stignu, potpisane tajnom tog računa i bez zadržane kopije.

4

Najviše ice breaker pitanja koje račun može postaviti putem Metinog Ice Breaker API-ja.

v11.0

Verzija Graph API-ja od koje događaji postbacka uključuju mid; samo to polje zahtijeva v8.0 ili noviju.

3

Najviše gumba u poruci predloška gumba, svaki tipa postback ili web_url.

24 hours

Vrijeme za odgovor nakon što osoba dodirne stavku trajnog izbornika, koja otvara standardni prozor za razmjenu poruka.

13

Najviše brzih odgovora koje jedna poruka nudi; dodirnuti brzi odgovor stiže u messages, a ne u messaging_postbacks.

Kada se aktivira messaging_postbacks?

Kad osoba dodirne jednu od strukturiranih opcija računa u razgovoru, nakon što su aplikacija i račun pretplaćeni na polje. Metini vodiči navode ove izvore:

  • ice breaker pitanje, jedno od najviše 4 koja račun nudi na početku razgovora. Nije dostupno na računalu.
  • postback gumb u predlošku gumba, najviše 3 po poruci, ili u generičkom predlošku, najviše 3 po elementu.
  • postback stavka u trajnom izborniku računa.
  • ice breaker dodirnut u novom razgovoru otvorenom iz ig.me poveznice s parametrom ref: postback tada nosi i referral.
  • Testiranje samo-poruke, kad račun dodirne vlastiti gumb: događaj dodaje is_self postavljen na true.

Kako izgleda obavijest o postbacku?

Događaj poruke s objektom postback nalazi se na mjestu na kojem bi inače bila izravna poruka. Metin primjer za Instagram Login sadrži mid, title i payload, a njegov vodič za ice breaker prikazuje isti objekt bez mid. Obavijest izgleda ovako:

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

Što znači svako polje?

Polja koja Meta dokumentira za postback, od vanjskog prema unutarnjem:

  • sender.id: ID osobe koja je dodirnula, ID za odgovor, specifičan za Instagram. recipient.id i entry[].id: profesionalni račun.
  • timestamp: kad je osoba dodirnula, prema Metinom vodiču za ice breaker.
  • postback.title: pitanje ice breakera ili naslov gumba koji je osoba vidjela.
  • postback.payload: niz postavljen za tu opciju pri stvaranju, koji bira aplikacija.
  • postback.mid: ID poruke koju je dodir poslao računu, od Graph API v11.0.
  • postback.referral: ref, source i type, kad je razgovor otvoren iz ig.me poveznice s parametrom ref.
  • is_self: postavljen na true, uz postback, kad račun dodirne vlastiti gumb u testiranju samo-poruke.

Kako se postavljaju ice breaker pitanja?

POST zahtjevom na /<IG_ID>/messenger_profile na graph.instagram.com: platform postavljen na instagram i niz ice_breakers čiji call_to_actions sadrže najviše 4 para pitanja i payloada, s localeom za svaki prijevod. GET na /me/messenger_profile?fields=ice_breakers ih ispisuje, a DELETE s fields postavljenim na ice_breakers ih uklanja. Payload odabran ovdje je ono što messaging_postbacks vraća kad se pitanje dodirne.

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

Kako se šalju postback gumbi?

Unutar poruke koju račun šalje zahtjevom POST na /<IG_ID>/messages. Predložak gumba nosi text do 640 znakova i 1 do 3 gumba; generički predložak nosi najviše 10 elemenata, svaki s najviše 3 gumba. Gumb tipa postback vraća svoj payload na messaging_postbacks kad se dodirne, dok gumb web_url umjesto toga otvara stranicu u pregledniku unutar aplikacije. Trajni izbornik, postavljen na messenger_profile, ima ista dva tipa.

Koriste li brzi odgovori messaging_postbacks?

Ne: stižu na messages. Dodirnuti brzi odgovor objavljuje svoj naslov u razgovoru kao poruku, a događaj messages nosi text postavljen na taj naslov i quick_reply.payload postavljen na payload opcije. Poruka može ponuditi najviše 13 brzih odgovora, svaki do 20 znakova, samo čisti tekst. Metin vodič za Instagram Messaging također navodi odabire ice breakera i generičkog predloška među onim što messages prijavljuje, bez primjera payloada.

Otvara li dodir prozor za razmjenu poruka?

Za trajni izbornik Meta to kaže: dodir stavke izbornika otvara standardni prozor za razmjenu poruka, a račun ima 24 sata za odgovor. Odgovorite zahtjevom POST na /<IG_ID>/messages s recipient.id postavljenim na sender.id postbacka. Odgovor računa vraća se na messages kao echo, s is_echo postavljenim na true.

Prosljeđuje li easyCoexistence postbacke?

Samo dodiri brzih odgovora. Stižu na polje messages, na koje su pretplaćeni aplikacija easyCoexistence i svaki povezani račun, pa do vašeg endpointa dolaze s quick_reply.payloadom. Dodiri ice breakera, gumba i stavki izbornika stižu na messaging_postbacks, na koje easyCoexistence nije pretplaćen, pa se ne prosljeđuju.

Uobičajene pogreške

  • Čekanje brzih odgovora na messaging_postbacks. Brzi odgovor stiže na messages, s quick_reply.payloadom uz tekst opcije koja je dodirnuta.
  • Usmjeravanje na postback.title. Naslov je ono što je osoba vidjela i može se razlikovati po localeu; usmjeravajte na payload, koji postavlja aplikacija.
  • Očekivanje mid na starijoj verziji API-ja. Meta uključuje postback.mid samo od Graph API v11.0.
  • Postavljanje više od 4 ice breakera ili testiranje na računalu. Metin Ice Breaker API prima najviše 4 pitanja, a funkcija nije dostupna na računalu.
Radite ovo uz EasyCoexistence

send_social_dm odgovara osobi unutar 24-satnog prozora. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Koje webhook polje prijavljuje dodire ice breakera na Instagramu?

messaging_postbacks. Objekt postback nosi pitanje kao title i postavljeni payload, plus mid od Graph API v11.0.

Koliko ice breaker pitanja Instagram račun može imati?

Najviše 4 pitanja, postavljena zahtjevom POST na /<IG_ID>/messenger_profile s platform postavljenim na instagram, opcionalno po localeu.

Kako odgovoriti na Instagram postback?

Zahtjevom POST na /<IG_ID>/messages s recipient.id postavljenim na sender.id postbacka, ID osobe koja je dodirnula, specifičan za Instagram. Nakon dodira stavke trajnog izbornika Meta računu daje 24 sata za odgovor.

Treba li Instagram postbacke usmjeravati po title ili payloadu?

Po payloadu, nizu koji je aplikacija postavila za opciju. title je tekst koji je osoba vidjela, a može se razlikovati po localeu.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na