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

Instagram messaging_referral webhook: ig.me poveznice i referrali iz oglasa

Instagram polje messaging_referral webhooka obavješćuje aplikaciju kada osoba koja već ima razgovor s profesionalnim računom otvori ig.me poveznicu s parametrom ref. Događaj sadrži objekt referral na najvišoj razini: ref, vrijednost parametra; source, SHORTLINKS; i type, OPEN_THREAD. Ref u novom razgovoru umjesto toga stiže unutar događaja messages ili messaging_postbacks.

easyCoexistence pretplaćuje svaki povezani Instagram račun na komentare, poruke i spominjanja, pa ref u prvoj poruci nove niti i referral Click-to-Direct oglasa stižu na vaš HTTPS endpoint unutar proslijeđene DM poruke, potpisane tajnom tog računa.

2,083

Najveći broj znakova koji parametar ig.me ref može imati, uz samo slova, brojke, crtice, donje crte i znakove jednakosti.

OPEN_THREAD

Vrsta referrala za ig.me poveznice; i referral Click-to-Direct oglasa je koristi, uz source ADS.

24 hours

Vrijeme koje aplikacija ima za odgovor nakon referrala u postojećem razgovoru, čime se resetira standardni prozor.

7 days

Koliko dugo prozor može trajati od prve poruke poslane nakon klika na Click-to-Direct oglas.

Instagram Web

Gdje ig.me poveznice nisu podržane, prema Metinom vodiču za ig.me.

Kada se aktivira messaging_referral?

Kada osoba koja već ima razgovor s profesionalnim računom otvori ig.me poveznicu koja nosi parametar ref. Instagram otvara postojeću nit, a Meta sama šalje referral, bez poruke. Gdje ref stiže ovisi o niti i o tome što osoba učini:

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.

Kako izgleda obavijest o referralu?

Događaj messaging tipa čiji objekt referral stoji uz sender, recipient i timestamp, bez poruke ili postbacka oko njega. Metin vodič za ig.me navodi vrijednosti referrala unutar istog okvira kao i ostali događaji Instagram messaginga:

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

Što znači svako polje?

Polja koja Meta dokumentira za ig.me referral, od vanjskog prema unutarnjem:

  • sender.id: Instagram ID (u opsegu aplikacije) osobe koja je otvorila poveznicu. recipient.id i entry[].id: profesionalni račun.
  • referral.ref: vrijednost ref parametra poveznice, onako kako ju je poveznica nosila.
  • referral.source: SHORTLINKS u Metinim ig.me primjerima. Jedna tablica u njihovom vodiču za Instagram Messaging piše SHORTLINK, a stranica s primjerima prikazuje samo zamjensku vrijednost.
  • referral.type: OPEN_THREAD, koji Meta koristi za ig.me referrale.
  • timestamp: trenutak kada je događaj pokrenut, u milisekundama u Metinim primjerima.

Kako napraviti ig.me poveznicu s ref parametrom?

Kao https://ig.me/<USERNAME>?ref=<VALUE>, gdje je USERNAME korisničko ime profesionalnog računa, prema Metinom vodiču za Instagram Login; njihov vodič za Instagram Messaging piše https://ig.me/m/<USERNAME>. Ref može imati do 2,083 znaka, uz slova, brojke, crtice, donje crte i znakove jednakosti. Meta predlaže refove za praćenje kanala, povezivanje osobe sa sesijom u drugoj aplikaciji ili upućivanje na određeni sadržaj te preporučuje ice breakeri, svaki sa svojim ref, za nove razgovore.

Gdje stižu referrali iz oglasa?

U porukama (messages). Osoba koja klikne oglas koji otvara Instagram Direct i pošalje poruku proizvede događaj messages čiji message.referral sadrži ref oglasa ako je postavljen, ad_id, source ADS, type OPEN_THREAD i ads_context_data s naslovom oglasa te photo_url ili video_url na koji je kliknuto. Metine stranice za Instagram dokumentiraju messaging_referral samo za ig.me poveznice.

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

Otvara li referral prozor za slanje poruka?

Da, u postojećem razgovoru: Metin vodič za ig.me kaže da referral resetira standardni 24-satni prozor za slanje poruka, pa aplikacija može odgovoriti unutar 24 sata od događaja. Prva poruka poslana nakon klika na Click-to-Direct oglas može otvoriti prozor do 7 dana od te poruke. Odgovorite pozivom POST /<IG_ID>/messages s recipient.id postavljenim na sender.id događaja.

Prosljeđuje li easyCoexistence referrale?

One koje nose poruke. Svaki povezani račun pretplaćen je na komentare, poruke i spominjanja, pa ref u prvoj poruci nove niti i referral Click-to-Direct oglasa stižu na vaš endpoint unutar proslijeđene DM poruke, kao message.referral. messaging_referral, za postojeće niti, i messaging_postbacks, za dodire ice breakera, zasebna su polja koja Meta isporučuje aplikaciji pretplaćenoj na njih.

Uobičajene pogreške

  • Čekanje messaging_referral u novom razgovoru. Tamo ref stiže u messages ili messaging_postbacks, ovisno o tome je li osoba upisala poruku ili dodirnula ice breaker.
  • Stavljanje drugih znakova u ref. Meta prihvaća slova, brojke, crtice, donje crte i znakove jednakosti, do 2,083 znaka.
  • Uspoređivanje source s jednim točnim nizom. Metini primjeri pokazuju SHORTLINKS za ig.me i ADS za oglase, ali jedna njihova tablica piše SHORTLINK, pa grananje treba temeljiti na tome gdje se referral nalazi i na ref.
  • Testiranje poveznica na Instagram webu. Meta tamo ne podržava ig.me poveznice, pa ih otvorite u aplikaciji Instagram.
Radite ovo uz EasyCoexistence

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

Često postavljana pitanja

Što referral.source sadrži u Instagram referralu?

SHORTLINKS u Metinim ig.me primjerima i ADS za Click-to-Direct oglas, iako jedna tablica u Metinom vodiču za Instagram Messaging piše SHORTLINK. Grananje temeljite na tome gdje se referral nalazi i na ref, a ne na jednom točnom nizu.

Koliko može biti dug parametar ig.me ref?

Do 2,083 znaka, uz samo slova, brojke, crtice, donje crte i znakove jednakosti.

Gdje ref iz ig.me poveznice stiže u novom Instagram razgovoru?

U porukama (messages) kada osoba upiše prvu poruku, ili u messaging_postbacks kada dodirne ice breaker. messaging_referral pokriva samo postojeće niti.

Rade li ig.me poveznice na Instagram webu?

Ne. Metin vodič za ig.me kaže da nisu podržane na Instagram webu.

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