Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Instagram webhook fields: buong listahan

Para sa professional account sa Instagram Login, ang webhook fields table ng Meta ay naglilista ng comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover at standby, kung saan ang mentions ay ipinapadala sa loob ng comments; may message_edit din sa mga halimbawa nito. Bawat isa ay nangangailangan ng instagram_business_basic kasama ang instagram_business_manage_comments o, para sa karamihan ng messaging fields, instagram_business_manage_messages. Hindi inaalok ang story_insights sa Instagram Login.

Ini-subscribe ng easyCoexistence ang bawat konektadong Instagram account sa comments, messages at mentions, at ipinapasa ang mga event na iyon sa iyong HTTPS endpoint habang dumarating ang mga ito, may signature gamit ang secret ng account na iyon.

8

Mga field na naka-subscribe agad ang bagong Instagram product sa App Dashboard, kasama ang comments, messages at message_reactions.

Per app

Pinipili ang mga field para sa app, hindi kada account: nakakatanggap ang account ng mga field na pinili ng app.

Advanced Access

Access level na nakalista sa setup guide ng Meta para sa Instagram Login webhooks, at kinakailangan para sa notification ng comments at live_comments.

story_insights

Minarkahang hindi available sa Instagram Login sa fields table ng Meta, na inaalok ito sa Facebook Login at Unified Login.

10 Sep 2025

Nang ipinakilala ng Meta ang message_edit webhook para sa Business Login for Instagram at Facebook Login for Business.

Anong webhook fields ang inaalok ng Instagram Login?

Ito ang mga nasa fields table ng Meta, kasama ang kung ano ang nagti-trigger sa bawat isa ayon sa mga halimbawa at webhook reference nito. Kailangan din ng bawat field ang instagram_business_basic bukod sa permission na nakalista, at kinakailangan ng Meta ang Advanced Access para sa notification ng comments at 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.

Aling mga field ang hindi available sa Instagram Login?

Tatlong hanay sa fields table ng Meta ang walang permission para sa Instagram Login, kaya hindi ito natatanggap ng app na nasa Instagram Login. May isa pang field na umiiral lamang sa labas nito:

  • story_insights: metrics ng Story kapag nag-expire, gamit ang Facebook Login o Unified Login at instagram_manage_insights. Sinasabi ng media insights reference ng Meta na hindi suportado ang insights webhook sa Instagram Login.
  • messaging_policy_enforcement at response_feedback: nasa column lamang para sa Instagram Messaging API ng Meta.
  • mentions bilang sariling field: nakalista ito sa Facebook Login at Unified Login, kasama ang instagram_manage_comments, habang isinasama ng Instagram Login ang mentions sa comments.

Paano mag-subscribe sa fields?

Sa dalawang lugar. Sa App Dashboard, sa webhook settings ng Instagram product, i-save ang callback URL at verify token, na nagti-trigger ng verification request ng Meta, saka piliin ang mga field; ang bagong Instagram product ay naka-subscribe agad sa walo sa mga ito. Pagkatapos, i-subscribe ang bawat account gamit ang POST /<IG_ID>/subscribed_apps sa graph.instagram.com, kung saan nakatakda ang subscribed_fields sa mga field na pinili sa dashboard, pinaghihiwalay ng kuwit.

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 }

Puwede bang magkaiba ang fields ng bawat account?

Hindi. Sinasabi ng setup guide ng Meta na hindi maaaring piliin ang fields para sa bawat account ng app user: nakakatanggap ang account ng mga field na pinili para sa app. Ang subscribed_fields sa subscription ng account ay nilalayong ilista ang mga field ng dashboard, kaya dapat asahan ng handler ang alinmang field na pinili ng app at magpasya base sa laman ng bawat event, hindi sa hiniling para sa isang account.

Paano malalaman ang pagkakaiba ng fields sa notification?

Sa hugis ng entry. Ang comment fields ay dumarating sa changes array, at pinapangalanan ng bawat change ang field nito. Ang messaging fields ay dumarating sa messaging array na walang pangalan ng field, at ang key sa tabi ng sender, recipient at timestamp ang nagpapakilala sa kanila:

  • changes[].field: comments o live_comments, na may comment sa value.
  • message: messages, kasama ang echoes ng sariling mensahe ng account, na may is_echo na nakatakda sa true.
  • reaction: message_reactions. postback: messaging_postbacks. read: messaging_seen. message_edit: message_edit.
  • referral sa tabi ng sender: messaging_referral. Ang referral sa loob ng message ay kabilang sa messages, mula sa bagong thread o Click-to-Direct ad.
  • pass_thread_control, take_thread_control o request_thread_control: messaging_handover, ayon sa listahan ng webhook reference ng Meta.

Aling mga field ang sinusubscribe ng easyCoexistence?

comments, messages at mentions, ang listahan kung saan naka-subscribe ang bawat Instagram account kapag kumonekta ito. Sa Instagram Login, nasa loob ng comments ang mentions, kaya sakop ng subscription ang comments at DMs, kasama ang echoes, Story replies, Story mentions at attachments sa mga DM. Ang iba pang field sa table ay inihahatid ng Meta sa app na naka-subscribe sa mga ito at hindi bahagi ng subscription ng isang koneksyon. Kapag naitakda na ang endpoint gamit ang set_social_webhook_destination o ang Partner API, sinusuri ng easyCoexistence ang signature ng Meta, agad na sumasagot sa Meta, at nagpo-POST ng bawat entry para sa account sa endpoint na iyon:

  • platform at external_id: instagram, at ang Instagram ID ng account, katumbas ng entry.id.
  • account_id: ang ID ng koneksyon sa easyCoexistence, na ginagamit ng MCP tools.
  • entry: entry ng Meta para sa account, walang binago. Hindi ipinapasa ang object field ng Meta at ang X-Hub-Signature-256 header nito.
  • X-EC-Signature: t=<unix>,v1=<hex>, isang HMAC-SHA256 ng timestamp, tuldok at raw body, na may sariling secret ng account bilang key.
  • Delivery: isang attempt na may hanggang 8 segundo, walang sinusundang redirect, walang kopyang itinatago at walang retry.

Mga karaniwang pagkakamali

  • Paghihintay ng field na mentions sa Instagram Login. Isinasama ng Meta ang mentions sa notification ng comments, kaya hindi kailanman tumatakbo ang handler na nakatali sa field na mentions.
  • Pag-aakalang nakakatanggap ang account lamang ng mga field na pinangalanan ng sarili nitong subscription. Ipinapadala ng Meta ang mga field na pinili para sa app, kaya magpasya base sa laman ng bawat event.
  • Pagtrato sa message.referral at top-level na referral bilang iisang event. Ang una ay nasa messages; ang ikalawa ay messaging_referral, para sa ig.me link na binuksan sa umiiral na usapan.
  • Paghihintay ng story_insights sa Instagram Login. Minarkahan ito ng Meta na hindi available doon, kaya basahin ang metrics ng Story mula sa insights endpoint habang aktibo pa ito.
Ginagawa ito gamit ang EasyCoexistence

Hindi itinatago ang mga event bilang default; ang account na may naka-on na automation ay nagtatago ng DM at comment nito nang 7 araw. Itakda ang endpoint gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang Partner API. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na libre.

Mga madalas itanong

May hiwalay bang webhook field na mentions ang Instagram Login?

Wala. Isinasama ng Meta ang mentions sa notification ng comments para sa Instagram Login; ang mentions ay sariling field sa Facebook Login at Unified Login.

Available ba ang story_insights sa Instagram Login?

Hindi. Minarkahan ito ng fields table ng Meta na hindi available sa Instagram Login, at sinasabi ng media insights reference nito na hindi suportado doon ang insights webhook.

Anong permission ang kailangan ng Instagram messages webhook?

instagram_business_basic at instagram_business_manage_messages, na may Advanced Access, na nakalista sa setup guide ng Meta para sa Instagram Login webhooks.

Kailan idinagdag ng Meta ang message_edit webhook para sa Instagram?

Noong 10 Setyembre 2025, para sa Business Login for Instagram at Facebook Login for Business. Dumarating ang edit sa messaging array sa ilalim ng message_edit key.

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