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.
Mga field na naka-subscribe agad ang bagong Instagram product sa App Dashboard, kasama ang comments, messages at message_reactions.
Pinipili ang mga field para sa app, hindi kada account: nakakatanggap ang account ng mga field na pinili ng app.
Access level na nakalista sa setup guide ng Meta para sa Instagram Login webhooks, at kinakailangan para sa notification ng comments at live_comments.
Minarkahang hindi available sa Instagram Login sa fields table ng Meta, na inaalok ito sa Facebook Login at Unified Login.
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.
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 atinstagram_manage_insights. Sinasabi ng media insights reference ng Meta na hindi suportado ang insights webhook sa Instagram Login.messaging_policy_enforcementatresponse_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.
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_echona 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_controlorequest_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.
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