IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

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.

8

Sehemu ambazo programu mpya ya Instagram katika App Dashboard huanza kuwa imejisajili nazo, zikiwemo comments, messages na message_reactions.

Per app

Sehemu huchaguliwa kwa programu, si kwa kila akaunti: akaunti hupokea sehemu ambazo programu imezichagua.

Advanced Access

Kiwango cha ufikiaji ambacho mwongozo wa usanidi wa Meta unakitaja kwa webhook za Instagram Login, na unachohitaji kwa arifa za comments na live_comments.

story_insights

Imewekwa alama kuwa haipatikani kwa Instagram Login kwenye jedwali la sehemu za Meta, ambalo linaitoa kwa Facebook Login na Unified Login.

10 Sep 2025

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.

commentsA comment or reply on the account's posts, Reels, Stories or ads, @mentions included. instagram_business_manage_comments.
live_commentsA comment on the account's Live while it is broadcast. instagram_business_manage_comments.
mentionsNo field of its own with Instagram Login: Meta includes mentions in the comments notification.
messagesA DM: text, attachments, shares, Story replies and mentions, quick replies, deletions, and echoes of the account's own messages. instagram_business_manage_messages.
message_echoesListed with instagram_business_manage_comments; the account's own messages arrive on messages with is_echo set to true.
message_reactionsA person reacts to a message or removes the reaction. instagram_business_manage_messages.
message_editA person edits a message, with mid, text and num_edit. In Meta's examples and changelog, not in its fields table.
messaging_postbacksA tap on an ice breaker, a template's postback button or a persistent menu item. instagram_business_manage_messages.
messaging_referralAn ig.me link with a ref parameter, opened in an existing conversation. instagram_business_manage_messages.
messaging_seenA person reads a message, reported as read.mid. instagram_business_manage_messages.
messaging_optinsListed with instagram_business_manage_messages; Meta's Instagram examples show no payload for it.
messaging_handoverThread control passed, taken or requested between apps under the handover protocol. instagram_business_manage_messages.
standbyA message that arrives while another app controls the conversation. instagram_business_manage_messages.

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 na instagram_manage_insights. Marejeo ya media insights ya Meta yanasema webhook ya insights haitumiki kwa Instagram Login.
  • messaging_policy_enforcement na response_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.

Subscribing one account to three fields
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_echo iliyowekwa 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_control au request_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.
Kufanya hili ukitumia EasyCoexistence

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