Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram messaging_postbacks -webhook: ice breakerit ja painikkeet

Instagramin messaging_postbacks-webhook-kenttä ilmoittaa sovellukselle, kun henkilö napauttaa ice breaker -kysymystä, postback-painiketta viestipohjassa tai pysyvän valikon kohtaa ammattilaistilin keskustelussa. Tapahtuman postback-objekti sisältää title-kentän, eli henkilön napauttaman tekstin, payload-kentän, eli sovelluksen kyseiselle vaihtoehdolle asettaman merkkijonon, ja mid-kentän, eli viestin tunnuksen, Graph API v11.0:sta alkaen.

easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin kommentteihin, viesteihin ja maininnoihin ja välittää nämä tapahtumat, pikavastausten napautukset mukaan lukien, HTTPS-päätepisteeseesi niiden saapuessa.

4

Enimmäismäärä ice breaker -kysymyksiä, jotka tili voi asettaa Metan Ice Breaker API:n kautta.

v11.0

Graph API -versio, josta lähtien postback-tapahtumissa on mid-kenttä. Kenttä itsessään vaatii v8.0:n tai uudemman.

3

Painikkeiden enimmäismäärä painikepohjaviestissä, joista kukin on postback- tai web_url-painike.

24 hours

Aika vastata sen jälkeen, kun henkilö napauttaa pysyvän valikon kohtaa, joka avaa tavallisen viestiikkunan.

13

Enimmäismäärä pikavastauksia, joita yksi viesti voi tarjota. Napautettu pikavastaus saapuu messages-kenttään, ei messaging_postbacks-kenttään.

Milloin messaging_postbacks laukeaa?

Kun henkilö napauttaa jotakin tilin rakenteellisista vaihtoehdoista keskustelussa, kunhan sovellus ja tili on tilattu kenttään. Metan oppaat listaavat nämä lähteet:

  • ice breaker -kysymys, joita tili tarjoaa enintään 4 keskustelun alussa. Ei saatavilla työpöytäversiossa.
  • postback-painike painikkeet sisältävässä viestipohjassa, enintään 3 viestiä kohden, tai yleisessä viestipohjassa, enintään 3 elementtiä kohden.
  • postback-kohta tilin pysyvässä valikossa.
  • ice breaker, joka napautetaan uudessa keskusteluketjussa, joka avattiin ig.me-linkistä ref-parametrilla: postback sisältää silloin myös referral-tiedon.
  • itseviestitesti, jossa tili napauttaa omaa painiketta: tapahtumaan lisätään is_self, jonka arvo on true.

Miltä postback-ilmoitus näyttää?

Viestitapahtuma, jossa postback-objekti on siinä kohdassa, jossa DM olisi viesti. Metan esimerkki Instagram Loginille sisältää mid-, title- ja payload-kentät, ja sen ice breaker -opas näyttää saman objektin ilman mid-kenttää. Ilmoitus näyttää tältä:

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

Mitä kukin kenttä tarkoittaa?

Metan dokumentoimat postback-kentät ulkoa sisäänpäin:

  • sender.id: sen henkilön Instagram-kohtainen tunnus, joka napautti, eli tunnus, johon vastataan. recipient.id ja entry[].id: ammattilaistili.
  • timestamp: milloin henkilö napautti Metan ice breaker -oppaan mukaan.
  • postback.title: ice breaker -kysymys tai painikkeen otsikko, jonka henkilö näki.
  • postback.payload: merkkijono, joka asetettiin tälle vaihtoehdolle sen luomisen yhteydessä ja jonka valitsee sovellus.
  • postback.mid: viestin tunnus, jonka napautus lähetti tilille, Graph API v11.0:sta alkaen.
  • postback.referral: ref, source ja type, kun keskusteluketju avattiin ig.me-linkistä ref-parametrilla.
  • is_self: asetetaan arvoon true postback-kentän rinnalle, kun tili napauttaa omaa painiketta itseviestitestissä.

Miten ice breaker -kysymykset asetetaan?

POST-pyyntö osoitteeseen graph.instagram.com, polkuun /<IG_ID>/messenger_profile: platform asetetaan arvoon instagram ja ice_breakers-taulukko, jonka call_to_actions sisältää enintään 4 kysymys- ja payload-paria. Jokaiselle käännetylle joukolle on oma locale. GET /me/messenger_profile?fields=ice_breakers listaa ne, ja DELETE-pyyntö, jonka fields-arvo on ice_breakers, poistaa ne. Tässä valittu payload on se, minkä messaging_postbacks palauttaa, kun kysymystä napautetaan.

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

Miten postback-painikkeet lähetetään?

Viestin sisällä, jonka tili lähettää POST /<IG_ID>/messages -pyynnöllä. Painikepohjan teksti voi olla enintään 640 merkkiä pitkä, ja siinä on 1–3 painiketta. Yleisessä viestipohjassa on enintään 10 elementtiä, joista kussakin enintään 3 painiketta. Postback-tyyppinen painike palauttaa payload-arvonsa messaging_postbacks-kenttään napautettaessa, kun taas web_url-painike avaa sivun sovelluksen sisäisessä selaimessa. Pysyvä valikko, joka asetetaan messenger_profile-kentässä, käyttää samoja kahta tyyppiä.

Käyttävätkö pikavastaukset messaging_postbacks-kenttää?

Eivät: ne saapuvat messages-kenttään. Napautettu pikavastaus lähettää otsikkonsa keskusteluun viestinä, ja messages-tapahtuma sisältää text-kentän, jonka arvo on tuo otsikko, sekä quick_reply.payload-kentän, jonka arvo on vaihtoehdon payload. Viesti voi tarjota enintään 13 pikavastausta, joista kussakin enintään 20 merkkiä, vain pelkkää tekstiä. Metan Instagram Messaging -opas luettelee myös ice breaker- ja yleisten viestipohjien valinnat niihin asioihin, jotka messages raportoi, mutta ilman esimerkkipayloadia.

Avaako napautus viestiikkunan?

Pysyvän valikon osalta Meta kertoo niin: valikon kohdan napautus avaa tavallisen viestiikkunan, ja tilillä on 24 tuntia aikaa vastata. Vastaa POST /<IG_ID>/messages -pyynnöllä, jossa recipient.id on postbackin sender.id. Tilin vastaus palaa messages-kenttään kaikuna, jossa is_echo on true.

Välittääkö easyCoexistence postbackit?

Vain pikavastausten napautukset. Ne saapuvat messages-kenttään, johon easyCoexistencen sovellus ja jokainen yhdistetty tili on tilattu, joten ne tulevat päätepisteeseesi quick_reply.payload-kentän kanssa. Ice breaker -, painike- ja valikkonapautukset saapuvat messaging_postbacks-kenttään, johon easyCoexistence ei tilaa, joten niitä ei välitetä.

Yleiset virheet

  • Pikavastausten odottaminen messaging_postbacks-kentästä. Pikavastaus saapuu messages-kenttään, ja quick_reply.payload on napautetun vaihtoehdon tekstin rinnalla.
  • Reititys postback.title-kentän perusteella. Otsikko on se, minkä henkilö näki, ja se voi vaihdella kielen mukaan. Reititä payloadin perusteella, jonka sovellus asettaa.
  • Mid-kentän odottaminen vanhemmassa API-versiossa. Meta sisältää postback.mid-kentän vain Graph API v11.0:sta alkaen.
  • Yli 4 ice breakerin asettaminen tai testaaminen työpöydällä. Metan Ice Breaker API ottaa enintään 4 kysymystä, eikä ominaisuus ole saatavilla työpöydällä.
Näin teet tämän EasyCoexistencen avulla

Ne on allekirjoitettu kyseisen tilin salaisuudella, eikä kopiota säilytetä. send_social_dm vastaa henkilölle 24 tunnin ikkunan sisällä. Hinta on US$ 9 per yhteys kuukaudessa, laskien US$ 0.75:een yhteyksien lisääntyessä, ja ensimmäiset 3 päivää ovat ilmaiseksi.

Usein kysytyt kysymykset

Mikä webhook-kenttä ilmoittaa Instagramin ice breaker -napautuksista?

messaging_postbacks. Postback-objekti sisältää kysymyksen title-kentässä, sille asetetun payloadin ja mid-kentän Graph API v11.0:sta alkaen.

Kuinka monta ice breakeria Instagram-tilillä voi olla?

Enintään 4 kysymystä. Ne asetetaan POST /<IG_ID>/messenger_profile -pyynnöllä, jossa platform on instagram, halutessa kielikohtaisesti.

Miten vastaan Instagram-postbackiin?

POST /<IG_ID>/messages -pyynnöllä, jossa recipient.id on postbackin sender.id, eli napauttaneen henkilön Instagram-kohtainen tunnus. Pysyvän valikon napautuksen jälkeen Meta antaa tilille 24 tuntia aikaa vastata.

Pitäisikö Instagram-postbackit reitittää title- vai payload-kentän perusteella?

Payloadin perusteella, eli sovelluksen vaihtoehdolle asettaman merkkijonon perusteella. title on se teksti, jonka henkilö näki, ja se voi vaihdella kielen mukaan.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu