Kutajwa na majibu ya Story ya Instagram kwenye webhook
Instagram inatuma kutajwa kwenye Story na majibu ya Story kama DM kwenye sehemu ya messages ya webhook. Kutajwa hufika kama ujumbe ambao attachments zake zina kipengee cha aina story_mention, chenye URL ya CDN ya Story kwenye payload.url. Jibu hubeba maandishi ya mtu na reply_to.story yenye url na id ya Story, na kwa Story yenye link sticker, link_sticker_url.
easyCoexistence humsajili kila akaunti ya Instagram iliyounganishwa kwenye messages, hivyo kutajwa kwenye Story na majibu ya Story hufika kwenye HTTPS endpoint yako pamoja na DM nyingine za akaunti zinapowasili, zikisainiwa kwa siri ya akaunti hiyo na bila nakala yoyote kuhifadhiwa.
Aina ya attachment ya tukio la messages ambalo Meta hutuma mtu anapotaja akaunti kwenye Story yake.
Sehemu ambayo Meta iliongeza kwenye reply_to.story tarehe 12 Desemba 2025, ikibeba URL ya link sticker ya Story iliyojibiwa.
Muda ambao Story hudumu; mara inapoisha muda au kufutwa, URL yake ya kutajwa haionyeshi tena.
Akaunti ambazo kutajwa kwenye Story kwake hufika; kutajwa na akaunti ya faragha hufika tu ikiwa inafuata akaunti ya kitaalamu.
Majibu ya Story ambayo webhook haiyasaidii, kulingana na mwongozo wa Meta wa Instagram Messaging.
Kutajwa kwenye Story hufika vipi?
Kama DM. Mtu anapotaja akaunti ya kitaalamu kwenye Story yake, Instagram huweka ujumbe unaorejelea Story hiyo kwenye kikasha cha akaunti, na Meta hutuma tukio la messages kwa ajili yake. sender.id ni Instagram-scoped ID ya mtu, na message.attachments ina kipengee kimoja cha aina story_mention ambacho payload.url ni URL ya CDN ya Story. Sampuli za Meta hazina maandishi yoyote, kwa hivyo soma attachment hiyo:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Jibu la Story hufika vipi?
Pia kama DM, likiwa na ujumbe wa mtu na kitu reply_to kinachoelekeza kwenye Story ya akaunti. reply_to.story hubeba url ya CDN ya Story na id yake. Rejeleo la webhook la Meta pia linaorodhesha link_sticker_url hapo, lililoongezwa Desemba 2025 kwa majibu ya Story yenye link sticker, ambalo Meta inapendekeza kwa kuelekeza automations kwa link. Jibu la ndani kwa ujumbe wa awali hutumia reply_to.mid badala yake.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Kila sehemu inamaanisha nini?
Sehemu ambazo Meta inaandika kwa matukio haya mawili, kutoka nje kuingia ndani:
- entry[].id na recipient.id: akaunti ya kitaalamu. sender.id: Instagram-scoped ID ya mtu, ID ambayo jibu hutumwa kwake.
- timestamp: wakati ujumbe ulipotumwa, kwa milisekunde katika sampuli za Meta; entry[].time ni wakati Meta ilipotuma arifa.
- message.mid: ID ya ujumbe, kwa kuondoa marudio ya majaribio upya na kwa kujibu kwa
reply_to.mid. - attachments[].type
story_mentionna payload.url: kutajwa, na URL ya CDN ya Story iliyosababisha kutajwa. reply_to.story.url nareply_to.story.id: Story ya akaunti ambayo mtu alijibu.reply_to.story.link_sticker_url: URL iliyo kwenye link sticker ya Story hiyo.- message.text: maneno ya jibu, yanajumuishwa ujumbe unapokuwa na maandishi.
URL ya Story hufanya kazi kwa muda gani?
Kwa muda ambao Story yenyewe ipo. Story hupotea baada ya saa 24 au mwandishi wake akiifuta, na mwongozo wa kutajwa kwenye Story wa Meta unasema URL hiyo basi huacha kuonyeshwa; muhtasari wake unaongeza kuwa URL za CDN za Instagram zinazingatia faragha na hazirudishi chochote kwa maudhui yaliyofutwa au yaliyoisha muda. Mwongozo huo huo unaruhusu kuhifadhi URL ya CDN lakini si media: programu lazima isihifadhi wala kuweka kwenye cache maudhui ya Story kwenye seva zake, na inapaswa kuonyesha kishikilia nafasi mara Story inapoondoka.
Lini tukio lolote kati ya mawili halitokei?
Miongozo ya Meta inataja hali hizi, ambapo handler inayosubiri tukio la Story haipati chochote:
- Kutajwa kwenye Story na akaunti ya faragha isiyofuata akaunti ya kitaalamu.
- Kutambulishwa kwenye chapisho la kawaida: Meta inasema ni kutajwa kwenye Story pekee huanzisha webhook ya messages, si kutambulishwa kwenye machapisho.
- Jibu la Story lililotumia GIF au sticker, ambalo webhook haiyasaidii.
- Story kupitia API ya kutajwa: GET /<
IG_ID>/tags na POST /<IG_ID>/mentions haziziungi mkono, kwa hiyo DM ndiyo njia ambayo kutajwa kwenye Story hufika.
Je, kutajwa na majibu ya Story vinafungua dirisha la ujumbe?
Jibu ni ujumbe kutoka kwa mtu, na Meta inaorodhesha kutajwa kwenye Story miongoni mwa njia ambazo mtu huanzisha mazungumzo. Dirisha ambalo kitendo chake hufungua huchukua saa 24 kwa vitendo vingi, kwa hivyo akaunti inaweza kujibu kwa POST /<IG_ID>/messages na recipient.id ikiwekwa kwenye sender.id ya tukio wakati dirisha bado liko wazi. Jibu la akaunti hurudi kwenye messages kama echo, na is_echo ikiwa na thamani true.
easyCoexistence inavyovipeleka?
Kupitia sehemu ya messages, ambayo kila akaunti iliyounganishwa imejisajili kwake, hivyo kutajwa kwenye Story na majibu ya Story hufika kwenye endpoint yako pamoja na DM nyingine za akaunti: kila entry ikiwa ndani ya bahasha yenye platform, account_id, external_id na entry, iliyosainiwa kwenye X-EC-Signature kwa siri ya akaunti, ikitumwa mara moja na bila nakala yoyote kuhifadhiwa. send_social_dm humjibu mtu kwa sender.id ya tukio kama recipient_id, ndani ya dirisha la saa 24.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}Makosa ya kawaida
- Kuhifadhi media ya Story. Mwongozo wa Meta wa kutajwa kwenye Story unaruhusu kuweka URL ya CDN, si maudhui, ambayo hayapaswi kuhifadhiwa wala kuwekwa kwenye cache kwenye seva zako.
- Kusoma message.text pekee. Kutajwa kwenye Story hubeba attachment ya aina story_mention na, katika sampuli za Meta, hakuna maandishi, kwa hiyo handler ya maandishi pekee huona ujumbe tupu.
- Kuonyesha URL ya Story siku kadhaa baadaye. Haifanyi kazi tena Story inapoisha baada ya saa 24 au kufutwa, kwa hivyo onyesha kishikilia nafasi kuanzia hapo.
- Kutafuta kutajwa kwenye Story kwenye sehemu ya comments au kwenye API ya kutajwa. Meta huyatuma kama DM kwenye messages.
send_social_dm humjibu mtu ndani ya dirisha la saa 24, kutoka kwa Claude, ChatGPT au msimbo wako mwenyewe. Kuanzia US$ 9 kwa muunganisho kwa mwezi, hadi US$ 0.75 kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, tukio la kutajwa kwenye Story la Instagram lina maandishi?
Si katika sampuli za Meta. Kutajwa kwenye Story hubeba attachment ya aina story_mention yenye URL ya CDN ya Story, kwa hiyo handler inayosoma message.text pekee huona ujumbe tupu.
link_sticker_url katika jibu la Story la Instagram ni nini?
Ni URL iliyo kwenye link sticker ya Story ambayo mtu alijibu, katika reply_to.story.link_sticker_url. Meta iliiongeza tarehe 12 Desemba 2025 na inapendekeza itumike kuelekeza automations kwa link.
Je, majibu ya Story yenye GIF au sticker huwasha webhook?
Hapana. Mwongozo wa Instagram Messaging wa Meta unasema webhook haisaidii majibu ya Story yaliyotumia GIF au sticker.
Je, akaunti za faragha huwasha webhook za kutajwa kwenye Story?
Ni pale tu akaunti ya faragha inapofuata akaunti ya kitaalamu. Kutajwa kutoka kwa akaunti za umma hufika kadri vinavyotokea.
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