Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Webhook-ul messaging_postbacks pentru Instagram: întrebări de deschidere și butoane

Câmpul messaging_postbacks al webhook-ului Instagram notifică o aplicație când o persoană apasă o întrebare de deschidere, un buton postback dintr-un șablon sau un element din meniul persistent într-o conversație cu un cont profesional. Obiectul postback al evenimentului conține title, textul pe care persoana l-a apăsat; payload, șirul setat de aplicație pentru acea opțiune; și mid, ID-ul mesajului, din Graph API v11.0.

easyCoexistence abonează fiecare cont Instagram conectat la comments, messages și mentions și transmite aceste evenimente, inclusiv apăsările pe răspunsuri rapide, către endpoint-ul dumneavoastră HTTPS pe măsură ce sosesc, semnate cu secretul acelui cont și fără a păstra nicio copie.

4

Majoritatea întrebărilor de deschidere pe care le poate seta un cont, prin Ice Breaker API al Meta.

v11.0

Versiunea Graph API din care evenimentele postback includ mid; câmpul în sine necesită v8.0 sau mai nouă.

3

Majoritatea butoanelor dintr-un mesaj cu șablon de butoane, fiecare fiind un buton postback sau web_url.

24 hours

Timpul de răspuns după ce o persoană apasă un element din meniul persistent, care deschide fereastra standard de mesagerie.

13

Majoritatea răspunsurilor rapide pe care le oferă un mesaj; un răspuns rapid apăsat ajunge pe messages, nu pe messaging_postbacks.

Când se declanșează messaging_postbacks?

Când o persoană apasă una dintre opțiunile structurate ale contului într-o conversație, odată ce aplicația și contul sunt abonate la câmp. Ghidurile Meta enumeră aceste surse:

  • O întrebare de deschidere, dintre cele până la 4 pe care le oferă contul la începutul unei conversații. Nu este disponibilă pe desktop.
  • Un buton postback dintr-un șablon de butoane, până la 3 pe mesaj, sau dintr-un șablon generic, până la 3 pe element.
  • Un element postback din meniul persistent al contului.
  • O întrebare de deschidere apăsată într-un fir nou, deschis dintr-un link ig.me cu un parametru ref: postback-ul transportă atunci și referral.
  • Un test de auto-mesagerie, în care contul apasă propriul buton: evenimentul adaugă is_self setat la true.

Cum arată o notificare postback?

Un eveniment de mesagerie cu un obiect postback în locul în care un DM ar avea mesajul. Exemplul Meta pentru Instagram Login conține mid, title și payload, iar ghidul despre întrebările de deschidere arată același obiect fără mid. O notificare arată astfel:

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

Ce înseamnă fiecare câmp?

Câmpurile pe care Meta le documentează pentru un postback, de la exterior spre interior:

  • sender.id: ID-ul cu sfera Instagram al persoanei care a apăsat, adică ID-ul la care trimiteți răspunsul. recipient.id și entry[].id: contul profesional.
  • timestamp: momentul în care persoana a apăsat, conform ghidului Meta despre întrebările de deschidere.
  • postback.title: întrebarea de deschidere sau titlul butonului pe care l-a văzut persoana.
  • postback.payload: șirul setat pentru acea opțiune la creare, ales de aplicație.
  • postback.mid: ID-ul mesajului trimis contului prin apăsare, din Graph API v11.0.
  • postback.referral: ref, source și type, când conversația a fost deschisă dintr-un link ig.me cu un parametru ref.
  • is_self: setat la true, lângă postback, când contul apasă propriul buton într-un test de auto-mesagerie.

Cum se setează întrebările de deschidere?

Prin POST /<IG_ID>/messenger_profile pe graph.instagram.com: platform setat la instagram și un array ice_breakers ale cărui call_to_actions conțin până la 4 perechi întrebare și payload, cu un locale pentru fiecare set tradus. GET /me/messenger_profile?fields=ice_breakers le listează, iar un DELETE cu fields setat la ice_breakers le elimină. Payload-ul ales aici este cel pe care messaging_postbacks îl returnează când se apasă întrebarea.

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

Cum se trimit butoanele postback?

În interiorul unui mesaj pe care contul îl trimite prin POST /<IG_ID>/messages. Un șablon de butoane conține un text de până la 640 de caractere și 1 până la 3 butoane; un șablon generic conține până la 10 elemente, fiecare cu până la 3 butoane. Un buton de tip postback returnează payload-ul pe messaging_postbacks când este apăsat, în timp ce un buton web_url deschide o pagină în browserul din aplicație. Meniul persistent, setat pe messenger_profile, acceptă aceleași două tipuri.

Răspunsurile rapide folosesc messaging_postbacks?

Nu: ajung pe messages. Un răspuns rapid apăsat postează titlul său în conversație ca mesaj, iar evenimentul messages conține text setat la acel titlu și quick_reply.payload setat la payload-ul opțiunii. Un mesaj poate oferi până la 13 răspunsuri rapide, de până la 20 de caractere fiecare, doar text simplu. Ghidul Meta pentru mesageria Instagram menționează și selecțiile din întrebările de deschidere și din șablonul generic printre cele raportate de messages, fără un exemplu de payload.

Apăsarea deschide fereastra de mesagerie?

Pentru meniul persistent, Meta o spune explicit: apăsarea unui element din meniu deschide fereastra standard de mesagerie, iar contul are 24 de ore să răspundă. Răspundeți cu POST /<IG_ID>/messages și recipient.id setat la sender.id al postback-ului. Răspunsul contului revine pe messages ca echo, cu is_echo setat la true.

Transmite easyCoexistence postback-urile?

Doar apăsările pe răspunsuri rapide. Ele sosesc pe messages, la care sunt abonate aplicația easyCoexistence și fiecare cont conectat, deci ajung la endpoint-ul dumneavoastră cu quick_reply.payload. Apăsările pe întrebările de deschidere, pe butoane și pe meniu sosesc pe messaging_postbacks, la care easyCoexistence nu se abonează, deci nu sunt transmise mai departe.

Greșeli frecvente

  • Așteptarea răspunsurilor rapide pe messaging_postbacks. Un răspuns rapid ajunge pe messages, cu quick_reply.payload alături de textul opțiunii apăsate.
  • Rutarea pe postback.title. Titlul este ce a văzut persoana și poate diferi în funcție de locale; rutați pe payload, pe care îl setează aplicația.
  • Așteptarea lui mid pe o versiune mai veche a API-ului. Meta include postback.mid doar din Graph API v11.0.
  • Setarea a mai mult de 4 întrebări de deschidere sau testarea lor pe desktop. Ice Breaker API al Meta acceptă până la 4 întrebări, iar funcția nu este disponibilă pe desktop.
Faceți acest lucru cu EasyCoexistence

send_social_dm răspunde persoanei în fereastra de 24 de ore. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Ce câmp al webhook-ului raportează apăsările pe întrebările de deschidere Instagram?

messaging_postbacks. Obiectul postback conține întrebarea drept title și payload-ul setat pentru ea, plus mid din Graph API v11.0.

Câte întrebări de deschidere poate avea un cont Instagram?

Până la 4 întrebări, setate prin POST /<IG_ID>/messenger_profile cu platform setat la instagram, opțional pentru fiecare locale.

Cum răspund unui postback Instagram?

Prin POST /<IG_ID>/messages și recipient.id setat la sender.id al postback-ului, ID-ul cu sfera Instagram al persoanei care a apăsat. După o apăsare pe meniul persistent, Meta acordă contului 24 de ore să răspundă.

Ar trebui să rutez postback-urile Instagram pe title sau pe payload?

Pe payload, șirul setat de aplicație pentru opțiune. title este textul pe care l-a văzut persoana, care poate diferi în funcție de locale.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la