Webhook na messaging_referral sa Instagram: ig.me links at ad referrals
Ina-notify ng messaging_referral field ng Instagram ang app kapag may taong may umiiral nang conversation sa professional account at nagbukas ng ig.me link na may ref parameter. Ang event ay may top-level na referral object: ref, ang value ng parameter; source, SHORTLINKS; at type, OPEN_THREAD. Ang ref sa bagong conversation ay dumarating sa loob ng messages o messaging_postbacks event.
Sine-subscribe ng easyCoexistence ang bawat connected Instagram account sa comments, messages at mentions, kaya ang ref sa unang mensahe ng bagong thread at ang referral ng Click-to-Direct ad ay umaabot sa HTTPS endpoint ninyo sa loob ng na-forward na DM, naka-sign gamit ang secret ng account na iyon.
Pinakamaraming characters na kayang hawakan ng ig.me ref parameter, gamit lang ang letters, digits, hyphens, underscores at equal signs.
Referral type para sa ig.me links; ginagamit din ito ng referral ng Click-to-Direct ad, na may source na ADS.
Oras na mayroon ang app para mag-reply pagkatapos ng referral sa umiiral na conversation, na nire-reset ang standard window.
Gaano katagal maaaring tumagal ang window mula sa unang mensaheng ipinadala pagkatapos mag-click ng Click-to-Direct ad.
Mga lugar kung saan hindi suportado ang ig.me links, ayon sa ig.me guide ng Meta.
Kailan nag-fi-fire ang messaging_referral?
Kapag may taong may umiiral nang conversation sa professional account na nagbukas ng ig.me link na may ref parameter. Binubuksan ng Instagram ang umiiral na thread at ipinapadala ng Meta ang referral nang mag-isa, walang mensahe. Kung saan dumarating ang ref ay nakadepende sa thread at sa ginawa ng tao:
Ano ang itsura ng referral notification?
Isang messaging event na nasa tabi ng sender, recipient at timestamp ang referral object, walang mensahe o postback sa paligid nito. Ibinibigay ng ig.me guide ng Meta ang mga value ng referral, nasa loob ng parehong envelope ng iba pang Instagram messaging events:
{
"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"
}
}
]
}
]
}Ano ang ibig sabihin ng bawat field?
Ang mga field na dokumentado ng Meta para sa ig.me referral, mula labas papasok:
- sender.id: ang Instagram-scoped ID ng taong nagbukas ng link. recipient.id at entry[].id: ang professional account.
- referral.ref: ang value ng ref parameter ng link, ayon sa pagkakalagay nito sa link.
- referral.source: SHORTLINKS sa mga sample ng Meta para sa ig.me. Iisang table sa Instagram Messaging guide nito ang nagsusulat ng SHORTLINK, at ang examples page nito ay nagpapakita ng placeholder.
- referral.type:
OPEN_THREAD, na ginagamit ng Meta para sa ig.me referrals. - timestamp: kung kailan na-trigger ang event, sa milliseconds sa mga sample ng Meta.
Paano gumawa ng ig.me link na may ref?
Bilang https://ig.me/<USERNAME>?ref=<VALUE>, kung saan ang USERNAME ay ang handle ng professional account, ayon sa Instagram Login guide ng Meta; sa Instagram Messaging guide nito, nakasulat ito bilang https://ig.me/m/<USERNAME>. Hanggang 2,083 characters ng letters, digits, hyphens, underscores at equal signs ang kayang laman ng ref. Iminumungkahi ng Meta ang mga ref para i-track ang channels, ikonekta ang tao sa session sa ibang app o ituro sila sa partikular na content, at nirerekomenda ang ice breakers, na may kanya-kanyang ref, para sa mga bagong conversation.
Saan dumarating ang ad referrals?
Sa messages. Ang taong nag-click ng ad na nagbubukas ng Instagram Direct at nagpapadala ng mensahe ay gumagawa ng messages event na may message.referral na naglalaman ng ref ng ad kung may nakatakda, ad_id, source na ADS, type na OPEN_THREAD, at ads_context_data na may title ng ad at ang photo_url o video_url na na-click. Dokumentado lang ng mga pahina ng Instagram ng Meta ang messaging_referral para sa ig.me links.
"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>"
}
}
}Nagbubukas ba ng messaging window ang referral?
Oo, sa umiiral na thread: sinasabi ng ig.me guide ng Meta na nire-reset ng referral ang 24-hour standard messaging window, kaya maaaring mag-reply ang app sa loob ng 24 oras mula sa event. Ang unang mensaheng ipinadala pagkatapos mag-click ng Click-to-Direct ad ay maaaring magbukas ng window na hanggang 7 araw mula sa mensaheng iyon. Mag-reply gamit ang POST /<IG_ID>/messages, na may recipient.id na nakatakda sa sender.id ng event.
Nagfo-forward ba ang easyCoexistence ng referrals?
Ang mga nakasakay sa messages. Naka-subscribe ang bawat connected account sa comments, messages at mentions, kaya ang ref sa unang mensahe ng bagong thread at ang referral ng Click-to-Direct ad ay umaabot sa endpoint ninyo sa loob ng na-forward na DM, bilang message.referral. Ang messaging_referral, para sa umiiral na thread, at ang messaging_postbacks, para sa mga ice breaker tap, ay hiwalay na field na ipinapadala ng Meta sa app na naka-subscribe sa mga ito.
Mga karaniwang pagkakamali
- Paghihintay ng messaging_referral sa bagong conversation. Doon, dumarating ang ref sa messages o messaging_postbacks, depende kung nag-type o nag-tap ng ice breaker ang tao.
- Paglalagay ng ibang characters sa ref. Tumatanggap ang Meta ng letters, digits, hyphens, underscores at equal signs, hanggang 2,083 characters.
- Pagtutugma ng source sa iisang eksaktong string. Nagpapakita ang sample ng Meta ng SHORTLINKS para sa ig.me at ADS para sa ads, pero may table na nagsasabing SHORTLINK, kaya i-branch base sa kinalalagyan ng referral at sa ref.
- Pagsubok ng links sa Instagram Web. Hindi sinusuportahan ng Meta ang ig.me links doon, kaya buksan ang mga ito sa Instagram app.
Sumasagot ang send_social_dm sa loob ng 24-hour window. US$ 9 hanggang US$ 0.75 kada connection kada buwan, bumababa habang dumarami ang connections, na may unang 3 araw na libre.
Mga madalas itanong
Ano ang laman ng referral.source sa Instagram referral?
SHORTLINKS sa mga sample ng Meta para sa ig.me, at ADS para sa Click-to-Direct ad, bagaman iisang table sa Instagram Messaging guide ng Meta ang nagsusulat ng SHORTLINK. I-branch base sa kinalalagyan ng referral at sa ref, hindi sa iisang eksaktong string.
Gaano kahaba ang ig.me ref parameter?
Hanggang 2,083 characters, gamit lang ang letters, digits, hyphens, underscores at equal signs.
Saan dumarating ang ig.me ref sa bagong Instagram conversation?
Sa messages kapag nag-type ng unang mensahe ang tao, o sa messaging_postbacks kapag nag-tap siya ng ice breaker. Umiiral na thread lang ang sakop ng messaging_referral.
Gumagana ba ang ig.me links sa Instagram Web?
Hindi. Sinasabi ng ig.me guide ng Meta na hindi sila suportado sa Instagram Web.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong