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

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

Polje messaging_referral u Instagram webhooku obaveštava aplikaciju kada osoba koja već ima konverzaciju sa profesionalnim nalogom otvori ig.me link sa ref parametrom. Događaj sadrži objekat referral na najvišem nivou: ref, vrednost parametra; source, SHORTLINKS; i type, OPEN_THREAD. Ref u novoj konverzaciji stiže unutar događaja messages ili messaging_postbacks.

easyCoexistence pretplaćuje svaki povezani Instagram nalog na comments, messages i mentions, pa ref u prvoj poruci nove konverzacije i referral Click-to-Direct oglasa stižu do vašeg HTTPS endpointa unutar prosleđene DM poruke, potpisane tajnim ključem tog naloga.

2,083

Najviše znakova koje ref parametar ig.me linka može da sadrži, uz slova, cifre, crtice, donje crte i znake jednakosti.

OPEN_THREAD

Tip referrala za ig.me linkove; referral Click-to-Direct oglasa takođe koristi ovaj tip, ali sa source ADS.

24 hours

Vreme koje aplikacija ima da odgovori posle referrala u postojećoj konverzaciji, što resetuje standardni prozor.

7 days

Koliko može da traje prozor koji se otvori prvom porukom poslatom posle klika na Click-to-Direct oglas.

Instagram Web

Mesta na kojima ig.me linkovi nisu podržani, prema Metinom vodiču za ig.me.

Kada se pokreće messaging_referral?

Kada osoba koja već ima konverzaciju sa profesionalnim nalogom otvori ig.me link koji nosi ref parametar. Instagram otvara postojeću konverzaciju, a Meta šalje referral sam, bez poruke. Gde će ref stići zavisi od konverzacije i od onoga što osoba uradi:

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 obaveštenje o referralu?

Događaj poruke čiji se objekat referral nalazi pored sender, recipient i timestamp, bez poruke ili postbacka oko njega. Metin vodič za ig.me navodi vrednosti referrala, unutar istog omotača kao i drugi događaji Instagram poruka:

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

Šta znači svako polje?

Polja koja Meta dokumentuje za ig.me referral, od spolja ka unutra:

  • sender.id: Instagram-scoped ID osobe koja je otvorila link. recipient.id i entry[].id: profesionalni nalog.
  • referral.ref: vrednost ref parametra linka, onako kako ju je link nosio.
  • referral.source: SHORTLINKS u Metinim ig.me primerima. Jedna tabela u njegovom vodiču za Instagram poruke piše SHORTLINK, a stranica sa primerima prikazuje placeholder.
  • referral.type: OPEN_THREAD, koji Meta koristi za ig.me referrale.
  • timestamp: trenutak kada je događaj pokrenut, u milisekundama u Metinim primerima.

Kako se pravi ig.me link sa ref?

Kao https://ig.me/<USERNAME>?ref=<VALUE>, gde je USERNAME korisničko ime profesionalnog naloga, u Metinom vodiču za Instagram Login; njegov vodič za Instagram poruke piše https://ig.me/m/<USERNAME>. Ref može imati do 2.083 znaka: slova, cifre, crtice, donje crte i znake jednakosti. Meta predlaže refove za praćenje kanala, povezivanje osobe sa sesijom u drugoj aplikaciji ili upućivanje na određeni sadržaj, i preporučuje ice breakere, svaki sa sopstvenim ref, za nove konverzacije.

Gde stižu referrali iz oglasa?

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

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

Da li referral otvara prozor za slanje poruka?

Da, u postojećoj konverzaciji: Metin vodič za ig.me kaže da referral resetuje standardni prozor za slanje od 24 sata, pa aplikacija može da odgovori u roku od 24 sata od događaja. Prva poruka poslata posle klika na Click-to-Direct oglas može otvoriti prozor do 7 dana od te poruke. Odgovorite preko POST /<IG_ID>/messages sa recipient.id postavljenim na sender.id događaja.

Da li easyCoexistence prosleđuje referrale?

One koje nose poruke. Svaki povezani nalog je pretplaćen na comments, messages i mentions, pa ref u prvoj poruci nove konverzacije i referral Click-to-Direct oglasa stižu do vašeg endpointa unutar prosleđene DM poruke, kao message.referral. messaging_referral, za postojeće konverzacije, i messaging_postbacks, za dodir na ice breaker, su zasebna polja koja Meta isporučuje aplikaciji pretplaćenoj na njih.

Česte greške

  • Čekanje messaging_referral u novoj konverzaciji. Tamo ref stiže u messages ili messaging_postbacks, zavisno od toga da li je osoba ukucala poruku ili dodirnula ice breaker.
  • Stavljanje drugih znakova u ref. Meta prihvata slova, cifre, crtice, donje crte i znake jednakosti, do 2.083 znaka.
  • Poređenje source sa jednim tačnim stringom. Metini primeri pokazuju SHORTLINKS za ig.me i ADS za oglase, ali jedna njena tabela piše SHORTLINK, pa grananje treba zasnovati na mestu referrala i na ref.
  • Testiranje linkova na Instagram Webu. Meta tamo ne podržava ig.me linkove, pa ih otvorite u Instagram aplikaciji.
Ovo radite uz EasyCoexistence

send_social_dm odgovara unutar 24-satnog prozora. US$ 9 do US$ 0,75 po povezanoj vezi mesečno, uz pad cene kako dodajete veze i besplatni probni period od 3 dana.

Često postavljana pitanja

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

SHORTLINKS u Metinim ig.me primerima i ADS za Click-to-Direct oglas, mada jedna tabela u Metinom vodiču za Instagram poruke piše SHORTLINK. Grananje zasnujte na mestu referrala i na ref, a ne na jednom tačnom stringu.

Koliko može biti ig.me ref parametar?

Do 2.083 znaka, uz samo slova, cifre, crtice, donje crte i znake jednakosti.

Gde ig.me ref stiže u novoj Instagram konverzaciji?

U messages kada osoba ukuca prvu poruku, ili u messaging_postbacks kada dodirne ice breaker. messaging_referral pokriva samo postojeće konverzacije.

Da li ig.me linkovi rade na Instagram Webu?

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

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