Webhook messaging_referral Instagram: linkuri ig.me și referral-uri din reclame
Câmpul messaging_referral al webhook-ului Instagram anunță o aplicație când o persoană care are deja o conversație cu un cont profesional deschide un link ig.me care conține un parametru ref. Evenimentul conține un obiect referral de nivel superior: ref, valoarea parametrului; source, SHORTLINKS; și type, OPEN_THREAD. Un ref dintr-o conversație nouă ajunge în schimb în evenimentul messages sau messaging_postbacks.
easyCoexistence abonează fiecare cont Instagram conectat la comentarii, mesaje și mențiuni, astfel încât un ref din primul mesaj al unei conversații noi și referral-ul unei reclame Click-to-Direct ajung la endpoint-ul HTTPS, în mesajul direct (DM) transmis, semnat cu secretul contului respectiv.
Numărul maxim de caractere al unui parametru ref ig.me: 2.083, folosind doar litere, cifre, cratime, caractere de subliniere și semne egal.
Tipul de referral pentru linkurile ig.me; referral-ul unei reclame Click-to-Direct îl folosește și el, cu sursa ADS.
Timpul pe care aplicația îl are la dispoziție să răspundă după un referral într-o conversație existentă, ceea ce resetează fereastra standard.
Cât poate dura fereastra care se deschide dintr-un prim mesaj trimis după click pe o reclamă Click-to-Direct.
Unde nu sunt acceptate linkurile ig.me, potrivit ghidului ig.me al Meta.
Când se declanșează messaging_referral?
Când o persoană care are deja o conversație cu contul profesional deschide un link ig.me care conține un parametru ref. Instagram deschide conversația existentă, iar Meta trimite referral-ul de la sine, fără niciun mesaj. Unde ajunge un ref depinde de conversație și de ce face persoana:
Cum arată o notificare de referral?
Un eveniment de mesagerie al cărui obiect referral stă alături de sender, recipient și timestamp, fără niciun mesaj sau postback în jur. Ghidul ig.me al Meta prezintă valorile referral-ului în aceeași structură ca celelalte evenimente de mesagerie Instagram:
{
"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"
}
}
]
}
]
}Ce înseamnă fiecare câmp?
Câmpurile pe care Meta le documentează pentru un referral ig.me, de la exterior spre interior:
- sender.id: ID-ul cu scop Instagram al persoanei care a deschis linkul. recipient.id și entry[].id: contul profesional.
- referral.ref: valoarea parametrului ref exact cum o conținea linkul.
- referral.source: SHORTLINKS în exemplele ig.me ale Meta. Un tabel din ghidul Instagram Messaging al Meta scrie SHORTLINK, iar pagina de exemple arată un substituent.
- referral.type:
OPEN_THREAD, pe care Meta îl folosește pentru referral-urile ig.me. - timestamp: momentul în care a fost declanșat evenimentul, în milisecunde în exemplele Meta.
Cum construiești un link ig.me cu ref?
Sub forma https://ig.me/<USERNAME>?ref=<VALUE>, unde USERNAME este handle-ul contului profesional, conform ghidului Instagram Login al Meta; ghidul Instagram Messaging scrie https://ig.me/m/<USERNAME>. Ref-ul poate avea până la 2.083 de caractere, din litere, cifre, cratime, caractere de subliniere și semne egal. Meta recomandă ref-uri pentru urmărirea canalelor, pentru a lega o persoană de o sesiune dintr-o altă aplicație sau pentru a o trimite spre un conținut specific, și recomandă ice breaker-ele, fiecare cu propriul ref, pentru conversațiile noi.
Unde ajung referral-urile din reclame?
În mesaje. O persoană care dă click pe o reclamă care deschide Instagram Direct și trimite un mesaj produce un eveniment messages a cărui message.referral conține ref-ul reclamei, dacă a fost setat unul, ad_id, source ADS, type OPEN_THREAD și ads_context_data cu titlul reclamei și photo_url sau video_url pe care s-a dat click. Paginile Instagram ale Meta documentează messaging_referral doar pentru linkurile ig.me.
"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>"
}
}
}Un referral deschide fereastra de mesagerie?
Da, într-o conversație existentă: ghidul ig.me al Meta spune că referral-ul resetează fereastra standard de mesagerie de 24 de ore, astfel încât aplicația poate răspunde în 24 de ore de la eveniment. Un prim mesaj trimis după click pe o reclamă Click-to-Direct poate deschide o fereastră de până la 7 zile de la acel mesaj. Răspundeți cu POST /<IG_ID>/messages, având recipient.id setat la sender.id al evenimentului.
easyCoexistence transmite referral-urile?
Pe cele care circulă prin mesaje. Fiecare cont Instagram conectat este abonat la comentarii, mesaje și mențiuni, astfel încât un ref din primul mesaj al unei conversații noi și referral-ul unei reclame Click-to-Direct ajung la endpoint-ul dumneavoastră, în mesajul direct (DM) transmis, ca message.referral. messaging_referral, pentru conversațiile existente, și messaging_postbacks, pentru atingerea ice breaker-elor, sunt câmpuri separate pe care Meta le livrează unei aplicații abonate la ele.
Greșeli frecvente
- Așteptarea messaging_referral pentru o conversație nouă. Acolo ref-ul ajunge în messages sau messaging_postbacks, în funcție de faptul că persoana a scris sau a atins un ice breaker.
- Punerea altor caractere în ref. Meta acceptă litere, cifre, cratime, caractere de subliniere și semne egal, până la 2.083 de caractere.
- Compararea lui source cu un singur șir exact. Exemplele Meta arată SHORTLINKS pentru ig.me și ADS pentru reclame, dar unul dintre tabelele sale scrie SHORTLINK, așa că ramificați logica pe locul unde se află referral-ul și pe ref.
- Testarea linkurilor pe Instagram Web. Meta nu acceptă linkurile ig.me acolo, așa că deschideți-le în aplicația Instagram.
send_social_dm răspunde în fereastra de 24 de ore. De la 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 conține referral.source la un referral Instagram?
SHORTLINKS în exemplele ig.me ale Meta și ADS pentru o reclamă Click-to-Direct, deși un tabel din ghidul Instagram Messaging al Meta scrie SHORTLINK. Ramificați logica pe locul unde se află referral-ul și pe ref, nu pe un singur șir exact.
Cât de lung poate fi un parametru ref ig.me?
Până la 2.083 de caractere, folosind doar litere, cifre, cratime, caractere de subliniere și semne egal.
Unde ajunge un ref ig.me într-o conversație Instagram nouă?
În messages, când persoana scrie un prim mesaj, sau în messaging_postbacks, când atinge un ice breaker. messaging_referral acoperă doar conversațiile existente.
Funcționează linkurile ig.me pe Instagram Web?
Nu. Ghidul ig.me al Meta spune că nu sunt acceptate pe Instagram Web.
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