Sehemu za webhook za Instagram: orodha kamili
Kwa akaunti ya kitaalamu kwenye Instagram Login, jedwali la sehemu za webhook la Meta linaorodhesha comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover na standby, huku mentions zikiwasilishwa ndani ya comments; mifano yake inaongeza message_edit. Kila moja inahitaji instagram_business_basic pamoja na instagram_business_manage_comments au, kwa sehemu nyingi za ujumbe, instagram_business_manage_messages. story_insights haitolewi kwa Instagram Login.
easyCoexistence inajisajili kila akaunti ya Instagram iliyounganishwa kwenye comments, messages na mentions, na inapeleka matukio hayo kwenye endpoint yako ya HTTPS yanapofika, yakiwa yamesainiwa kwa siri ya akaunti hiyo.
Sehemu ambazo programu mpya ya Instagram katika App Dashboard huanza kuwa imejisajili nazo, zikiwemo comments, messages na message_reactions.
Sehemu huchaguliwa kwa programu, si kwa kila akaunti: akaunti hupokea sehemu ambazo programu imezichagua.
Kiwango cha ufikiaji ambacho mwongozo wa usanidi wa Meta unakitaja kwa webhook za Instagram Login, na unachohitaji kwa arifa za comments na live_comments.
Imewekwa alama kuwa haipatikani kwa Instagram Login kwenye jedwali la sehemu za Meta, ambalo linaitoa kwa Facebook Login na Unified Login.
Wakati Meta ilipoanzisha webhook ya message_edit kwa Business Login for Instagram na Facebook Login for Business.
Ni sehemu gani za webhook ambazo Instagram Login inatoa?
Hizi, kutoka kwenye jedwali la sehemu za Meta, pamoja na kinachoanzisha kila moja kutoka mifano yake na marejeo ya webhook. Kila sehemu pia inahitaji instagram_business_basic juu ya ruhusa iliyoonyeshwa, na Meta inahitaji Advanced Access kwa arifa za comments na live_comments.
Ni sehemu gani hazipatikani kwa Instagram Login?
Safu tatu za jedwali la sehemu za Meta hazina ruhusa yoyote ya Instagram Login, kwa hiyo programu ya Instagram Login haizipokei, na sehemu moja zaidi ipo nje yake tu:
story_insights: metriki za Story wakati inapoisha muda, kwa Facebook Login au Unified Login nainstagram_manage_insights. Marejeo ya media insights ya Meta yanasema webhook ya insights haitumiki kwa Instagram Login.messaging_policy_enforcementnaresponse_feedback: zipo tu kwenye safu ya Instagram Messaging API ya Meta.- mentions kama sehemu yake yenyewe: Facebook Login na Unified Login zinaiorodhesha, pamoja na
instagram_manage_comments, wakati Instagram Login inaziingiza mentions ndani ya comments.
Unajisajili vipi kwa sehemu?
Mahali pawili. Kwenye App Dashboard, chini ya mipangilio ya webhook ya bidhaa ya Instagram, hifadhi URL ya callback na verify token, jambo linalozindua ombi la uthibitishaji la Meta, kisha chagua sehemu; bidhaa mpya ya Instagram huanza ikiwa imejisajili kwa nane kati yake. Kisha jisajili kila akaunti kwa POST /<IG_ID>/subscribed_apps kwenye graph.instagram.com, huku subscribed_fields ikiwa na sehemu zilizochaguliwa kwenye dashboard, zikitenganishwa kwa koma.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages,message_reactions
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }Je, kila akaunti inaweza kupata sehemu tofauti?
Hapana. Mwongozo wa usanidi wa Meta unasema sehemu haziwezi kuchaguliwa kwa kila akaunti ya mtumiaji wa programu: akaunti hupokea sehemu zilizochaguliwa kwa programu. subscribed_fields kwenye usajili wa akaunti inakusudiwa kuorodhesha sehemu za dashboard, kwa hiyo kishughulikiaji kinapaswa kutarajia sehemu yoyote ambayo programu imechagua na kuamua kwa kile kila tukio linachobeba, si kwa kile lilichoomba kwa akaunti moja.
Unatofautishaje sehemu katika arifa?
Kwa umbo la ingizo. Sehemu za maoni zinafika kwenye orodha ya changes, kila badiliko likitaja sehemu yake. Sehemu za ujumbe zinafika kwenye orodha ya messaging bila jina la sehemu, na ufunguo ulio karibu na sender, recipient na timestamp ndio unazitofautisha:
- changes[].field: comments au
live_comments, pamoja na maoni kwenye value. - message: messages, zikiwemo echo za ujumbe wa akaunti yenyewe, zenye
is_echoiliyowekwa kuwa true. - reaction:
message_reactions. postback:messaging_postbacks. read:messaging_seen.message_edit:message_edit. - referral karibu na sender:
messaging_referral. Referral ndani ya message ni ya messages, kutoka thread mpya au tangazo la Click-to-Direct. pass_thread_control,take_thread_controlaurequest_thread_control:messaging_handover, kama marejeo ya webhook ya Meta yanavyoziorodhesha.
easyCoexistence inajisajili kwa sehemu zipi?
comments, messages na mentions, orodha ambayo kila akaunti ya Instagram hujisajili nayo inapounganishwa. Kwa Instagram Login mentions zinakuja ndani ya comments, kwa hiyo usajili unafunika comments na DM, zikiwemo echo, majibu ya Story, mention za Story na viambatisho miongoni mwa DM. Sehemu nyingine za jedwali zinatolewa na Meta kwa programu iliyojisajili kwake na si sehemu ya usajili wa muunganisho. Mara tu endpoint inapowekwa kwa set_social_webhook_destination au Partner API, easyCoexistence inakagua sahihi ya Meta, inamjibu Meta mara moja na kutuma (POST) kila ingizo la akaunti kwake:
- platform na
external_id: instagram, na Kitambulisho cha Instagram cha akaunti, sawa na entry.id. account_id: Kitambulisho cha muunganisho katika easyCoexistence, kile ambacho zana za MCP zinakitumia.- entry: entry ya Meta kwa akaunti, bila mabadiliko. Sehemu ya object ya Meta na kichwa chake X-Hub-Signature-256 hazipelekwi.
- X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 ya muhuri wa muda, nukta na mwili ghafi, ikitumia siri ya akaunti yenyewe.
- Uwasilishaji: jaribio moja la hadi sekunde 8, bila kufuata uelekezaji upya, bila nakala na bila majaribio upya.
Makosa ya kawaida
- Kusubiri sehemu ya mentions kwa Instagram Login. Meta inaziingiza mentions kwenye arifa ya comments, kwa hiyo kishughulikiaji kilichofungwa kwenye sehemu ya mentions hakiwahi kukimbia.
- Kudhani akaunti hupata sehemu tu ambazo usajili wake ulizitaja. Meta inatuma sehemu zilizochaguliwa kwa programu, kwa hiyo tofautisha kwa kile kila tukio linachobeba.
- Kuchukulia message.referral na referral ya ngazi ya juu kama tukio moja. Ya kwanza iko kwenye messages; ya pili ni messaging_referral, kwa kiungo cha ig.me kilichofunguliwa katika mazungumzo yaliyopo.
- Kusubiri story_insights kwa Instagram Login. Meta inaiweka alama kuwa haipatikani hapo, kwa hiyo soma metriki za Story kutoka endpoint ya insights wakati bado inapatikana.
Matukio hayahifadhiwi kwa chaguo-msingi; akaunti yenye otomatiki iliyowashwa huhifadhi DM na maoni yake kwa siku 7. Weka endpoint kwa set_social_webhook_destination kutoka Claude au ChatGPT, au kwa Partner API. Kuanzia US$ 9 kwa kila muunganisho kwa mwezi hadi US$ 0.75 kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, Instagram Login ina sehemu tofauti ya webhook ya mentions?
Hapana, si tofauti. Meta inajumuisha mentions kwenye arifa ya comments kwa Instagram Login; mentions ni sehemu yake yenyewe kwa Facebook Login na Unified Login.
Je, story_insights inapatikana kwa Instagram Login?
Hapana. Jedwali la sehemu za Meta linaiweka alama kuwa haipatikani kwa Instagram Login, na marejeo ya media insights yanasema webhook ya insights haitumiki hapo.
Ni ruhusa zipi webhook ya ujumbe wa Instagram inahitaji?
instagram_business_basic na instagram_business_manage_messages, pamoja na Advanced Access, ambayo mwongozo wa usanidi wa Meta unaitaja kwa webhook za Instagram Login.
Meta iliongeza webhook ya message_edit kwa Instagram lini?
Tarehe 10 Septemba 2025, kwa Business Login for Instagram na Facebook Login for Business. Uhariri huja kwenye orodha ya messaging chini ya ufunguo wa message_edit.
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