Prijavite seZapočnite besplatni probni period
easyCoexistence Zvanični API-ji

messaging_postbacks webhook za Instagram: ice breaker pitanja i dugmad

Polje webhook messaging_postbacks za Instagram obaveštava aplikaciju kada osoba dodirne ice breaker pitanje, postback dugme u šablonu ili stavku trajnog menija u konverzaciji sa profesionalnim nalogom. Objekat postback sadrži title, tekst koji je osoba dodirnula; payload, string koji je aplikacija postavila za tu opciju; i mid, ID poruke, od Graph API v11.0.

easyCoexistence povezuje svaki Instagram nalog na komentare, poruke i pominjanja i prosleđuje te događaje, uključujući dodire brzih odgovora, na vaš HTTPS endpoint čim stignu, potpisane tajnim ključem tog naloga i bez čuvanja kopije.

4

Većina ice breaker pitanja koje nalog može da podesi preko Metinog Ice Breaker API-ja.

v11.0

Verzija Graph API-ja od koje postback događaji sadrže mid; samo polje traži v8.0 ili noviju.

3

Većina dugmadi u šablonu poruke, svako tipa postback ili web_url.

24 hours

Vreme za odgovor nakon dodira na stavku trajnog menija, koji otvara standardni prozor za poruke.

13

Većina brzih odgovora koje jedna poruka može da ponudi; dodirnut brzi odgovor stiže na messages, a ne na messaging_postbacks.

Kada se aktivira messaging_postbacks?

Kada osoba dodirne jednu od strukturiranih opcija naloga u konverzaciji, čim su aplikacija i nalog pretplaćeni na polje. Metine smernice navode ove izvore:

  • ice breaker pitanje, jedno od najviše 4 koja nalog nudi kada počne konverzacija. Nije dostupno na desktopu.
  • postback dugme u šablonu sa dugmadima, do 3 po poruci, ili u generičkom šablonu, do 3 po elementu.
  • postback stavka u trajnom meniju naloga.
  • ice breaker dodirnut u novoj konverzaciji otvorenoj iz ig.me linka sa parametrom ref: postback tada nosi i referral.
  • Test slanja poruke samom sebi, kada nalog dodirne sopstveno dugme: događaj dodaje is_self postavljen na true.

Kako izgleda obaveštenje o postbacku?

Događaj poruke sa postback objektom, na mestu gde bi DM imao svoju poruku. Metin primer za Instagram Login sadrži mid, title i payload, a njegov vodič za ice breaker prikazuje isti objekat bez mid. Obaveštenje 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>"
          }
        }
      ]
    }
  ]
}

Šta znači svako polje?

Polja koja Meta dokumentuje za postback, od spolja ka unutra:

  • sender.id: Instagram-scoped ID osobe koja je dodirnula, na koji se odgovara. recipient.id i entry[].id: profesionalni nalog.
  • timestamp: kada je osoba dodirnula, prema Metinom vodiču za ice breaker.
  • postback.title: pitanje ice breakera ili naslov dugmeta koji je osoba videla.
  • postback.payload: string postavljen za tu opciju kada je kreirana, koji bira aplikacija.
  • postback.mid: ID poruke koju je dodir poslao nalogu, od Graph API v11.0.
  • postback.referral: ref, source i type, kada je konverzacija otvorena iz ig.me linka sa parametrom ref.
  • is_self: postavljeno na true, pored postback, kada nalog dodirne sopstveno dugme u testu slanja poruke samom sebi.

Kako se postavljaju ice breaker pitanja?

POST /<IG_ID>/messenger_profile na graph.instagram.com: platform postavljen na instagram i niz ice_breakers čiji call_to_actions sadrži do 4 parova pitanje i payload, uz locale za svaki prevedeni skup. GET /me/messenger_profile?fields=ice_breakers ih prikazuje, a DELETE sa fields postavljenim na ice_breakers ih uklanja. Payload izabran ovde je ono što messaging_postbacks vraća kada 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 dugmad?

Unutar poruke koju nalog šalje preko POST /<IG_ID>/messages. Šablon sa dugmadima nosi tekst do 640 karaktera i 1 do 3 dugmeta; generički šablon nosi do 10 elemenata, svaki sa do 3 dugmeta. Dugme tipa postback vraća svoj payload na messaging_postbacks kada se dodirne, dok web_url dugme otvara stranicu u pregledaču unutar aplikacije. Trajni meni, postavljen na messenger_profile, koristi ista dva tipa.

Da li brzi odgovori koriste messaging_postbacks?

Ne: stižu na messages. Dodirnut brzi odgovor šalje svoj naslov u konverzaciju kao poruku, a događaj messages nosi text postavljen na taj naslov i quick_reply.payload postavljen na payload opcije. Poruka može da ponudi do 13 brzih odgovora od najviše 20 karaktera svaki, samo čist tekst. Metin vodič za slanje poruka na Instagramu takođe navodi ice breaker i generičke izbore šablona među onim što messages prijavljuje, bez primera payloada.

Da li dodir otvara prozor za poruke?

Za trajni meni, Meta to kaže: dodir na stavku menija otvara standardni prozor za poruke, a nalog ima 24 sata da odgovori. Odgovorite preko POST /<IG_ID>/messages sa recipient.id postavljenim na sender.id postbacka. Odgovor naloga se vraća na messages kao echo, sa is_echo postavljenim na true.

Da li easyCoexistence prosleđuje postbackove?

Samo dodiri brzih odgovora. Stižu na messages, na koji su pretplaćeni easyCoexistence-ova aplikacija i svaki povezani nalog, pa stižu na vaš endpoint sa quick_reply.payload. Dodiri ice breaker-a, dugmadi i stavki menija stižu na messaging_postbacks, na koji easyCoexistence nije pretplaćen, pa se ne prosleđuju.

Česte greške

  • Čekanje brzih odgovora na messaging_postbacks. Brzi odgovor stiže na messages, sa quick_reply.payload pored teksta opcije koja je dodirnuta.
  • Rutiranje po postback.title. Naslov je ono što je osoba videla i može se razlikovati po lokalu; rutirajte po payloadu, koji postavlja aplikacija.
  • Očekivanje mid na starijoj verziji API-ja. Meta uključuje postback.mid samo od Graph API v11.0.
  • Podešavanje više od 4 ice breaker pitanja ili testiranje na desktopu. Metin Ice Breaker API prima do 4 pitanja, a funkcija nije dostupna na desktopu.
Ovo radite uz EasyCoexistence

send_social_dm odgovara osobi unutar 24-časovnog prozora. Od US$ 9 do US$ 0.75 po vezi mesečno, uz pad cene kako dodajete veze, uz besplatni probni period od 3 dana.

Često postavljana pitanja

Koje webhook polje prijavljuje dodire ice breakera na Instagramu?

messaging_postbacks. Objekat postback nosi pitanje kao title i payload postavljen za njega, plus mid od Graph API v11.0.

Koliko ice breaker pitanja nalog na Instagramu može imati?

Do 4 pitanja, podešena preko POST /<IG_ID>/messenger_profile sa platform postavljenim na instagram, po želji po lokalu.

Kako odgovoriti na Instagram postback?

Preko POST /<IG_ID>/messages sa recipient.id postavljenim na sender.id postbacka, Instagram-scoped ID osobe koja je dodirnula. Posle dodira na trajni meni, Meta daje nalogu 24 sata da odgovori.

Da li Instagram postbackove rutirati po title ili payloadu?

Po payloadu, stringu koji je aplikacija postavila za opciju. title je tekst koji je osoba videla, a može se razlikovati po lokalu.

Nastavite sa čitanjem

Povežite prvi kanal za dva minuta.

Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo zvanični API-ji
  • Nadzor 24/7

Provereno na