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

Instagramin messaging_referral-webhook: ig.me-linkit ja mainosviittaukset

Instagramin messaging_referral-webhook-kenttä ilmoittaa sovellukselle, kun henkilö, jolla on jo keskustelu ammattitilin kanssa, avaa ig.me-linkin, jossa on ref-parametri. Tapahtuma sisältää ylimmän tason referral-objektin: ref, parametrin arvo; source, SHORTLINKS; ja type, OPEN_THREAD. Ref uudessa keskustelussa tulee sen sijaan messages- tai messaging_postbacks-tapahtuman sisällä.

easyCoexistence tilaa jokaisen yhdistetyn Instagram-tilin kommentteihin, viesteihin ja maininnoihin, joten ref uuden ketjun ensimmäisessä viestissä ja Click-to-Direct-mainoksen viittaus saavuttavat HTTPS-päätepisteesi välitetyn DM:n sisällä, allekirjoitettuna kyseisen tilin salaisuudella.

2,083

Suurin merkkimäärä, jonka ig.me-ref-parametri voi sisältää, kun käytetään vain kirjaimia, numeroita, tavuviivoja, alaviivoja ja yhtäsuuruusmerkkejä.

OPEN_THREAD

Viittauksen tyyppi ig.me-linkeille; myös Click-to-Direct-mainoksen viittaus käyttää sitä, lähteenä ADS.

24 hours

Aika, jonka sovelluksella on vastata olemassa olevan keskustelun viittauksen jälkeen; tämä nollaa tavallisen ikkunan.

7 days

Kuinka kauan ikkuna voi kestää ensimmäisestä viestistä, joka lähetetään Click-to-Direct-mainoksen napsautuksen jälkeen.

Instagram Web

Missä ig.me-linkit eivät ole tuettuja Metan ig.me-oppaan mukaan.

Milloin messaging_referral lähetetään?

Kun henkilö, jolla on jo keskustelu ammattitilin kanssa, avaa ig.me-linkin, joka sisältää ref-parametrin. Instagram avaa olemassa olevan ketjun, ja Meta lähettää viittauksen itsenäisesti ilman viestiä. Missä ref saapuu, riippuu ketjusta ja siitä, mitä henkilö tekee:

Existing threadmessaging_referral: a referral object beside sender, with no message.
New thread, ice breaker tappedmessaging_postbacks: postback.referral beside title and payload.
New thread, message typedmessages: message.referral beside mid.
Click-to-Direct admessages: message.referral with source ADS, ad_id and ads_context_data.

Miltä viittausilmoitus näyttää?

Messaging-tapahtuma, jonka referral-objekti on lähettäjän, vastaanottajan ja aikaleiman rinnalla, ilman viestiä tai postbackia sen ympärillä. Metan ig.me-opas antaa viittauksen arvot samassa kuoressa kuin muut Instagram-viestitapahtumat:

A messaging_referral notification
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "referral": {
            "ref": "<REF_PARAMETER_VALUE>",
            "source": "SHORTLINKS",
            "type": "OPEN_THREAD"
          }
        }
      ]
    }
  ]
}

Mitä kukin kenttä tarkoittaa?

Kentät, jotka Meta dokumentoi ig.me-viittaukselle, ulkoa sisäänpäin:

  • sender.id: linkin avanneen henkilön Instagram-kohtainen tunniste. recipient.id ja entry[].id: ammattitili.
  • referral.ref: linkin ref-parametrin arvo sellaisena kuin linkki sen kantoi.
  • referral.source: SHORTLINKS Metan ig.me-esimerkeissä. Yksi taulukko sen Instagram Messaging -oppaassa kirjoittaa sen muodossa SHORTLINK, ja sen esimerkkisivu näyttää paikanpitäjän.
  • referral.type: OPEN_THREAD, jota Meta käyttää ig.me-viittauksissa.
  • timestamp: milloin tapahtuma laukaistiin, millisekunteina Metan esimerkeissä.

Miten ig.me-linkki rakennetaan ref-parametrilla?

Muodossa https://ig.me/<USERNAME>?ref=<VALUE>, jossa USERNAME on ammattitilin käyttäjätunnus, Metan Instagram Login -oppaassa; sen Instagram Messaging -opas kirjoittaa https://ig.me/m/<USERNAME>. Ref voi olla enintään 2 083 merkkiä pitkä, ja siinä saa olla kirjaimia, numeroita, tavuviivoja, alaviivoja ja yhtäsuuruusmerkkejä. Meta ehdottaa refejä kanavien seuraamiseen, henkilön yhdistämiseen toiseen sovellukseen istunnossa tai ohjaamiseen tiettyyn sisältöön, ja suosittelee jäänmurtajia, joilla kullakin on oma ref, uusiin keskusteluihin.

Mihin mainosviittaukset saapuvat?

Viesteihin. Henkilö, joka napsauttaa mainosta, joka avaa Instagram Directin ja lähettää viestin, tuottaa messages-tapahtuman, jonka message.referral sisältää mainoksen ref-arvon, jos se on asetettu, ad_id:n, lähteen ADS, tyypin OPEN_THREAD ja ads_context_data:n mainoksen otsikon sekä napsautetun photo_url- tai video_url-kentän. Metan Instagram-sivut dokumentoivat messaging_referral-kentän vain ig.me-linkeille.

A Click-to-Direct ad referral, inside messages
"message": {
  "mid": "<MESSAGE_ID>",
  "referral": {
    "ref": "<AD_REF_IF_SET>",
    "ad_id": "<AD_ID>",
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ads_context_data": {
      "ad_title": "<AD_TITLE>",
      "photo_url": "<IMAGE_URL_CLICKED>",
      "video_url": "<THUMBNAIL_URL_FOR_THE_AD_VIDEO>"
    }
  }
}

Avaako viittaus viestiikkunan?

Kyllä, olemassa olevassa ketjussa: Metan ig.me-opas kertoo, että viittaus nollaa 24 tunnin tavallisen viestiikkunan, joten sovellus voi vastata 24 tunnin sisällä tapahtumasta. Ensimmäinen viesti, joka lähetetään Click-to-Direct-mainoksen napsautuksen jälkeen, voi avata jopa 7 päivän ikkunan tuon viestin lähettämisestä. Vastaa kutsulla POST /<IG_ID>/messages, jossa recipient.id on tapahtuman sender.id.

Välittääkö easyCoexistence viittaukset?

Ne, jotka kulkevat viestien mukana. Jokainen yhdistetty tili tilataan kommentteihin, viesteihin ja maininnoihin, joten ref uuden ketjun ensimmäisessä viestissä ja Click-to-Direct-mainoksen viittaus saavuttavat päätepisteesi välitetyn DM:n sisällä message.referral-kenttänä. messaging_referral olemassa oleville ketjuille ja messaging_postbacks jäänmurtajien napautuksille ovat erillisiä kenttiä, jotka Meta toimittaa niihin tilattuihin sovelluksiin.

Yleiset virheet

  • Odottaa messaging_referral-tapahtumaa uudessa keskustelussa. Siellä ref saapuu messages- tai messaging_postbacks-tapahtumaan sen mukaan, kirjoittiko henkilö viestin vai napautti jäänmurtajaa.
  • Muiden merkkien käyttäminen ref-kentässä. Meta hyväksyy kirjaimet, numerot, tavuviivat, alaviivat ja yhtäsuuruusmerkit, enintään 2 083 merkkiä.
  • Source-kentän vertaaminen yhteen tarkkaan merkkijonoon. Metan esimerkit näyttävät SHORTLINKS ig.me-linkeille ja ADS mainoksille, mutta yksi sen taulukoista kirjoittaa SHORTLINK, joten haara sen mukaan, missä viittaus on ja mikä ref on.
  • Linkkien testaaminen Instagram Webissä. Meta ei tue ig.me-linkkejä siellä, joten avaa ne Instagram-sovelluksessa.
Näin teet tämän EasyCoexistencen avulla

send_social_dm vastaa 24 tunnin ikkunan sisällä. Alkaen US$ 9 ja laskien US$ 0,75:een per yhteys kuukaudessa, kun lisäät yhteyksiä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Mikä referral.source sisältää Instagram-viittauksessa?

SHORTLINKS Metan ig.me-esimerkeissä ja ADS Click-to-Direct-mainokselle, vaikka yksi taulukko Metan Instagram Messaging -oppaassa kirjoittaa sen muodossa SHORTLINK. Haara sen mukaan, missä viittaus on ja mikä ref on, eikä yhden tarkan merkkijonon mukaan.

Kuinka pitkä ig.me-ref-parametri voi olla?

Enintään 2 083 merkkiä, ja siinä saa käyttää vain kirjaimia, numeroita, tavuviivoja, alaviivoja ja yhtäsuuruusmerkkejä.

Mihin ig.me-ref saapuu uudessa Instagram-keskustelussa?

messages-tapahtumaan, kun henkilö kirjoittaa ensimmäisen viestin, tai messaging_postbacks-tapahtumaan, kun hän napauttaa jäänmurtajaa. messaging_referral kattaa vain olemassa olevat ketjut.

Toimivatko ig.me-linkit Instagram Webissä?

Eivät. Metan ig.me-oppaan mukaan niitä ei tueta Instagram Webissä.

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