Webhook ya messaging_referral ya Instagram: viungo vya ig.me na marejeleo ya matangazo
Sehemu ya webhook ya messaging_referral ya Instagram humjulisha programu mtu ambaye tayari ana mazungumzo na akaunti ya kitaalamu anapofungua kiungo cha ig.me chenye parameta ya ref. Tukio hilo lina kitu cha referral cha ngazi ya juu: ref, thamani ya parameta; source, SHORTLINKS; na type, OPEN_THREAD. Ref ya mazungumzo mapya hufika ndani ya tukio la messages au messaging_postbacks badala yake.
easyCoexistence hujisajili kupokea maoni, ujumbe na kutajwa kwa kila akaunti ya Instagram iliyounganishwa, kwa hiyo ref kwenye ujumbe wa kwanza wa mazungumzo mapya na marejeleo ya tangazo la Click-to-Direct hufika kwenye HTTPS endpoint yako ndani ya DM iliyosambazwa, ikisainiwa kwa siri ya akaunti hiyo.
Idadi kubwa zaidi ya herufi ambayo parameta ya ref ya ig.me inaweza kubeba, ikitumia herufi, tarakimu, vistari, mistari ya chini na alama sawa tu.
Aina ya marejeleo kwa viungo vya ig.me; referral ya tangazo la Click-to-Direct pia hutumia aina hii, pamoja na source ADS.
Muda ambao programu ina kujibu baada ya marejeleo kwenye mazungumzo yaliyopo, ambao unaweka upya dirisha la kawaida.
Muda ambao dirisha linaweza kudumu baada ya ujumbe wa kwanza uliotumwa baada ya kubofya tangazo la Click-to-Direct.
Mahali ambapo viungo vya ig.me havitumiki, kulingana na mwongozo wa ig.me wa Meta.
Je, messaging_referral huwashwa lini?
Mtu ambaye tayari ana mazungumzo na akaunti ya kitaalamu anapofungua kiungo cha ig.me chenye parameta ya ref. Instagram hufungua mazungumzo yaliyopo na Meta hutuma marejeleo lenyewe, bila ujumbe wowote. Ref hufika wapi inategemea mazungumzo na kile mtu anachofanya:
Arifa ya marejeleo inaonekanaje?
Tukio la ujumbe ambalo kitu cha referral kipo pamoja na sender, recipient na timestamp, bila message wala postback kukizunguka. Mwongozo wa ig.me wa Meta unatoa thamani za referral, ndani ya bahasha ile ile kama matukio mengine ya ujumbe wa 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"
}
}
]
}
]
}Kila sehemu inamaanisha nini?
Sehemu ambazo Meta inaandika kwa marejeleo ya ig.me, kuanzia nje kwenda ndani:
- sender.id: Kitambulisho cha Instagram cha mtu aliyefungua kiungo. recipient.id na entry[].id: akaunti ya kitaalamu.
- referral.ref: thamani ya parameta ya ref ya kiungo, kama kiungo kilivyoibeba.
- referral.source: SHORTLINKS katika sampuli za ig.me za Meta. Jedwali moja katika mwongozo wake wa Instagram Messaging linaandika SHORTLINK, na ukurasa wa mifano unaonyesha kishikilia nafasi.
- referral.type:
OPEN_THREAD, ambayo Meta hutumia kwa marejeleo ya ig.me. - timestamp: wakati tukio lilipoanzishwa, kwa milisekunde katika sampuli za Meta.
Unajengaje kiungo cha ig.me chenye ref?
Kama https://ig.me/<USERNAME>?ref=<VALUE>, ambapo USERNAME ni jina la mtumiaji la akaunti ya kitaalamu, kwenye mwongozo wa Instagram Login wa Meta; mwongozo wake wa Instagram Messaging unaandika https://ig.me/m/<USERNAME>. Ref inaweza kuwa na hadi herufi 2,083, zikiwa herufi, tarakimu, vistari, mistari ya chini na alama sawa. Meta inapendekeza refs za kufuatilia njia, kumfunga mtu kwenye kikao cha programu nyingine au kumwelekeza kwenye maudhui maalum, na inapendekeza ice breakers, kila moja ikiwa na ref yake, kwa mazungumzo mapya.
Marejeleo ya matangazo yanafika wapi?
Kwenye ujumbe. Mtu anayebofya tangazo linalofungua Instagram Direct na kutuma ujumbe huzalisha tukio la messages ambalo message.referral ina ref ya tangazo ikiwa iliwekwa, ad_id, source ADS, type OPEN_THREAD, na ads_context_data yenye kichwa cha tangazo na URL ya picha au video aliyobofya. Kurasa za Meta za Instagram zinaeleza messaging_referral kwa viungo vya ig.me pekee.
"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>"
}
}
}Je, marejeleo yanafungua dirisha la ujumbe?
Ndiyo, katika mazungumzo yaliyopo: mwongozo wa ig.me wa Meta unasema marejeleo huweka upya dirisha la kawaida la ujumbe wa saa 24, hivyo programu inaweza kujibu ndani ya saa 24 tangu tukio. Ujumbe wa kwanza uliotumwa baada ya kubofya tangazo la Click-to-Direct unaweza kufungua dirisha la hadi siku 7 kutoka ujumbe huo. Jibu kwa POST /<IG_ID>/messages na recipient.id ikiwekwa sawa na sender.id ya tukio.
Je, easyCoexistence inasambaza marejeleo?
Yale yanayopanda kwenye ujumbe. Kila akaunti iliyounganishwa imejisajili kupokea maoni, ujumbe na kutajwa, kwa hiyo ref kwenye ujumbe wa kwanza wa mazungumzo mapya na marejeleo ya tangazo la Click-to-Direct hufika kwenye endpoint yako ndani ya DM iliyosambazwa, kama message.referral. messaging_referral, kwa mazungumzo yaliyopo, na messaging_postbacks, kwa mibofyo ya ice breakers, ni sehemu tofauti ambazo Meta huwasilisha kwa programu iliyojisajili.
Makosa ya kawaida
- Kusubiri messaging_referral kwenye mazungumzo mapya. Hapo ref hufika kwenye messages au messaging_postbacks, kulingana na kama mtu aliandika au aligusa ice breaker.
- Kuweka herufi zingine kwenye ref. Meta inakubali herufi, tarakimu, vistari, mistari ya chini na alama sawa, hadi herufi 2,083.
- Kulinganisha source na mfuatano mmoja kamili. Sampuli za Meta zinaonyesha SHORTLINKS kwa ig.me na ADS kwa matangazo, lakini jedwali moja linasoma SHORTLINK, kwa hiyo tawi kulingana na mahali marejeleo yalipo na kwa ref.
- Kujaribu viungo kwenye Instagram Web. Meta haitumii viungo vya ig.me huko, kwa hiyo vifungue kwenye programu ya Instagram.
send_social_dm hujibu ndani ya dirisha la saa 24. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka unapoongeza muunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Referral.source ina nini katika marejeleo ya Instagram?
SHORTLINKS katika sampuli za ig.me za Meta na ADS kwa tangazo la Click-to-Direct, ingawa jedwali moja katika mwongozo wa Instagram Messaging wa Meta linaandika SHORTLINK. Tawi kulingana na mahali marejeleo yalipo na kwa ref badala ya kutegemea mfuatano mmoja kamili.
Parameta ya ref ya ig.me inaweza kuwa ndefu kiasi gani?
Hadi herufi 2,083, ukitumia herufi, tarakimu, vistari, mistari ya chini na alama sawa pekee.
Ref ya ig.me hufika wapi kwenye mazungumzo mapya ya Instagram?
Kwenye messages mtu anapoandika ujumbe wa kwanza, au kwenye messaging_postbacks anapogusa ice breaker. messaging_referral inahusu mazungumzo yaliyopo pekee.
Je, viungo vya ig.me vinafanya kazi kwenye Instagram Web?
Hapana. Mwongozo wa ig.me wa Meta unasema havitumiki kwenye Instagram Web.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye