Webhook messaging_referral w Instagramie: linki ig.me i odesłania z reklam
Pole webhooka messaging_referral w Instagramie informuje aplikację, gdy osoba, która ma już rozmowę z kontem zawodowym, otworzy link ig.me z parametrem ref. Zdarzenie zawiera obiekt referral najwyższego poziomu: ref, czyli wartość parametru; source, SHORTLINKS; oraz type, OPEN_THREAD. Odesłanie przy nowej rozmowie trafia zamiast tego do zdarzenia messages lub messaging_postbacks.
easyCoexistence subskrybuje każde podłączone konto Instagrama do komentarzy, wiadomości i wzmianek, więc ref w pierwszej wiadomości nowego wątku oraz odesłanie reklamy Click-to-Direct docierają do Twojego endpointu HTTPS w przekazanym DM, podpisanym sekretem tego konta.
Maksymalna liczba znaków, jaką może zawierać parametr ref w linku ig.me. Dozwolone są wyłącznie litery, cyfry, myślniki, podkreślniki i znaki równości.
Typ odesłania dla linków ig.me; używa go też odesłanie reklamy Click-to-Direct, z source ADS.
Czas, w którym aplikacja może odpowiedzieć po odesłaniu w istniejącej rozmowie. Resetuje on standardowe okno wiadomości.
Jak długo może trwać okno liczone od pierwszej wiadomości wysłanej po kliknięciu reklamy Click-to-Direct.
Miejsca, w których linki ig.me nie są obsługiwane, według przewodnika Meta po ig.me.
Kiedy uruchamia się messaging_referral?
Gdy osoba, która już ma rozmowę z kontem zawodowym, otworzy link ig.me z parametrem ref. Instagram otwiera istniejący wątek, a Meta wysyła odesłanie samo, bez wiadomości. Miejsce, w którym pojawi się odesłanie, zależy od wątku i od tego, co zrobi osoba:
Jak wygląda powiadomienie o odesłaniu?
Zdarzenie wiadomości, w którym obiekt referral znajduje się obok sender, recipient i timestamp, bez wiadomości ani postbacka wokół. Przewodnik Meta po ig.me podaje wartości odesłania w tej samej strukturze co pozostałe zdarzenia wiadomości Instagrama:
{
"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"
}
}
]
}
]
}Co oznacza każde pole?
Pola udokumentowane przez Meta dla odesłania ig.me, od zewnątrz do środka:
- sender.id: identyfikator Instagram-scoped osoby, która otworzyła link. recipient.id oraz entry[].id: konto zawodowe.
- referral.ref: wartość parametru ref z linku, dokładnie taka, jaką zawierał link.
- referral.source: w przykładach Meta dla ig.me to SHORTLINKS. Jedna tabela w przewodniku Meta po Instagram Messaging zapisuje to jako SHORTLINK, a strona z przykładami pokazuje symbol zastępczy.
- referral.type:
OPEN_THREAD, którego Meta używa dla odesłań ig.me. - timestamp: moment wywołania zdarzenia, w milisekundach w przykładach Meta.
Jak zbudować link ig.me z ref?
Jako https://ig.me/<USERNAME>?ref=<VALUE>, gdzie USERNAME to nazwa użytkownika konta zawodowego, według przewodnika Meta Instagram Login; jego przewodnik Instagram Messaging zapisuje https://ig.me/m/<USERNAME>. Ref może mieć do 2,083 znaków: liter, cyfr, myślników, podkreśleń i znaków równości. Meta sugeruje refy do śledzenia kanałów, łączenia osoby z sesją w innej aplikacji lub kierowania na konkretne treści, a dla nowych rozmów zaleca ice breakery, każdy z własnym ref.
Dokąd trafiają odesłania z reklam?
Do wiadomości. Osoba, która kliknie reklamę otwierającą Instagram Direct i wyśle wiadomość, wywołuje zdarzenie messages, którego message.referral zawiera ref reklamy, jeśli został ustawiony, ad_id, source ADS, type OPEN_THREAD oraz ads_context_data z tytułem reklamy i klikniętym photo_url lub video_url. Strony Meta dla Instagrama dokumentują messaging_referral wyłącznie dla linków 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>"
}
}
}Czy odesłanie otwiera okno wiadomości?
Tak, w istniejącym wątku: przewodnik Meta po ig.me mówi, że odesłanie resetuje standardowe 24-godzinne okno wiadomości, więc aplikacja może odpowiedzieć w ciągu 24 godzin od zdarzenia. Pierwsza wiadomość wysłana po kliknięciu reklamy Click-to-Direct może otworzyć okno do 7 dni od tej wiadomości. Odpowiedz przez POST /<IG_ID>/messages, ustawiając recipient.id na sender.id zdarzenia.
Czy easyCoexistence przekazuje odesłania?
Te, które jadą wraz z wiadomościami. Każde podłączone konto jest subskrybowane do komentarzy, wiadomości i wzmianek, więc ref w pierwszej wiadomości nowego wątku oraz odesłanie reklamy Click-to-Direct docierają do Twojego endpointu w przekazanej wiadomości DM jako message.referral. messaging_referral dla istniejących wątków i messaging_postbacks dla stuknięć w ice breakery to osobne pola, które Meta dostarcza aplikacji zasubskrybowanej do nich.
Typowe błędy
- Czekanie na messaging_referral w nowej rozmowie. Tam ref pojawia się w messages lub messaging_postbacks, zależnie od tego, czy osoba napisała wiadomość, czy stuknęła ice breaker.
- Wpisywanie innych znaków w ref. Meta akceptuje litery, cyfry, myślniki, podkreślniki i znaki równości, do 2,083 znaków.
- Porównywanie source z jednym dokładnym ciągiem. Przykłady Meta pokazują SHORTLINKS dla ig.me i ADS dla reklam, ale jedna z tabel podaje SHORTLINK, więc rozgałęziaj logikę według miejsca odesłania i wartości ref.
- Testowanie linków w Instagram Web. Meta nie obsługuje tam linków ig.me, więc otwieraj je w aplikacji Instagram.
send_social_dm odpowiada w ramach 24-godzinnego okna. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.
Najczęściej zadawane pytania
Co zawiera referral.source w odesłaniu z Instagrama?
SHORTLINKS w przykładach Meta dla ig.me oraz ADS dla reklamy Click-to-Direct, choć jedna tabela w przewodniku Meta po Instagram Messaging zapisuje to jako SHORTLINK. Rozgałęziaj logikę według miejsca odesłania i wartości ref, a nie jednego dokładnego ciągu.
Jak długi może być parametr ref w linku ig.me?
Do 2,083 znaków, używając wyłącznie liter, cyfr, myślników, podkreśleń i znaków równości.
Gdzie trafia ref z linku ig.me w nowej rozmowie na Instagramie?
Do messages, gdy osoba wpisze pierwszą wiadomość, albo do messaging_postbacks, gdy stuknie ice breaker. messaging_referral obejmuje wyłącznie istniejące wątki.
Czy linki ig.me działają na Instagram Web?
Nie. Przewodnik Meta po ig.me mówi, że nie są one obsługiwane na Instagram Web.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w