Instagram comments webhook: ang payload, bawat field
Ina-notify ng comments webhook field ng Instagram ang isang app kapag may nag-comment sa media ng professional account, kasama ang Reels, o nag-reply sa comment sa media na iyon. Nagpo-post ang Meta ng change na nakatakda ang field sa comments, at ang value nito ay may dalang id at text ng comment, ang Instagram-scoped ID at username ng author sa from, ang id at product type ng media, at parent_id kapag reply ang comment.
Sina-subscribe ng easyCoexistence ang bawat naka-connect na Instagram account sa comments at ipinapasa ang comments event na ipinapadala ng Meta para dito sa inyong HTTPS endpoint habang dumarating, naka-sign gamit ang secret ng account na iyon at walang kopyang itinatago.
Naroroon kapag reply ang comment, at hawak ang ID ng comment na sinasagot nito.
Idinadagdag sa from kapag nag-comment ang account sa sarili nitong media, katabi ng sariling ID ng account.
Hiwalay na field para sa comments habang may Live broadcast; humihinto ang notification nito kapag natapos ang broadcast.
Kailangan para sa notification ng comments at live_comments; ang media ng private account ay hindi nagpapadala ng anumang notification.
Natitirang oras para magpadala sa nag-comment ng isang private reply, na naka-address sa ID ng comment.
Kailan naa-trigger ang comments field?
Kapag may nag-comment sa media na pag-aari ng professional account, o nag-mention sa account, basta naka-subscribe na sa field ang app at ang account. Ang bawat comment ay isang change sa notification, at ang mga kasong ito ay may parehong hugis:
- Bagong comment sa post, Reel, Story o ad, na may media.
media_product_typena nagsasabi kung saang surface nakalagay ang media. - Reply sa ilalim ng umiiral na comment, na may
parent_idna may ID ng comment na sinasagot nito. - Comment na ginawa ng account sa sarili nitong media, kasama ang mga reply nito: ang from.id ay sariling ID ng account, at idinadagdag ng from ang
self_ig_scoped_id. - Isang @mention sa account: sa Instagram Login, isinasama ng Meta ang mentions sa comments notification sa halip na sariling field.
- Ang comment habang may Live broadcast ay dumarating sa hiwalay na field na
live_comments, na may parehong hugis ng value, at humihinto kapag natapos ang broadcast.
Ano ang hitsura ng comments notification?
Isang POST na may JSON na object na nakatakda sa instagram at isang entry array. Ang bawat entry ay isang professional account: ang ID nito, ang oras na ipinadala ng Meta ang notification, at isang changes array na may isang change sa bawat comment. Ganito ang itsura ng reply sa isang Reel:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}Ano ang ibig sabihin ng bawat field?
Ang mga field na inililista ng reference ng webhook ng Meta para sa comment, mula sa labas papasok:
- entry[].id: ang ID ng professional account, ang
user_idna ibinabalik ng /me para dito. Sinasabi nito kung aling account ang pinagmulan ng comment. - entry[].time: kailan ipinadala ng Meta ang notification, bilang Unix timestamp. Hindi ito ang oras kung kailan isinulat ang comment.
- changes[].field: comments, o
live_commentspara sa Live broadcast. I-check ito bago basahin ang value. - value.id: ID ng comment, ang sasagutin nang publiko o pribado, itatago o buburahin.
- value.text: ang text ng comment, kasama kapag may text ang comment.
- value.from.id at value.from.username: ang Instagram-scoped ID at username ng author. Lumalabas ang value.from.
self_ig_scoped_idkapag ang account mismo ang sumulat ng comment. - value.media.id at value.media.
media_product_type: ang media na nakomentuhan at ang surface nito; tinutukoy ng media reference ng Meta ang AD, FEED, STORY at REELS. - value.
parent_id: sa reply, ang ID ng comment na sinasagot nito. Walangparent_idang top-level na comment. - value.media.
ad_id,ad_titleatoriginal_media_id: nakalista sa reference para sa mga comment na ginawa sa ad.
Ano ang hindi iniuulat ng comments field?
May ilang bagay na maaaring asahan ng handler na wala sa event o hindi kailanman ipinapadala, ayon sa setup guide at mga reference ng Meta:
- Mga comment sa media na pag-aari ng private account: hindi nagpapadala ang Meta ng comment o mention notification para sa mga ito.
- Album ID: wala ang mga ito sa event, at sinasabi ng Meta na hanapin ang album gamit ang comment ID.
- Ad ID para sa media na ginamit sa dynamic ads.
- Oras ng paggawa ng comment: ibinabalik ito ng GET /<
COMMENT_ID>?fields=timestamp sa ISO 8601. - Mga live comment pagkatapos ng broadcast, kapag humihinto ang notification para sa live media.
- Mga story mention, na hindi sinusuportahan ng mentions API ng Meta; sa halip, umaabot ang mga ito sa account bilang DM.
- Mga nakaraang event: walang notification history ang Meta na maaaring i-query, kaya i-store ang kailangan ninyo habang dumarating ang bawat isa.
Ano ang kailangan ng comments field?
Sa Instagram Login, ang mga permission na instagram_business_basic at instagram_business_manage_comments, at Advanced Access, na kailangan ng Meta para sa comments at live_comments notification. Dapat Live ang app at naka-subscribe sa comments sa App Dashboard, at bawat account ay dapat naka-subscribe sa pamamagitan ng POST /<IG_ID>/subscribed_apps na may comments sa subscribed_fields. Mahigpit na inirerekomenda ng Meta ang webhook na ito kaysa polling para sa comments, dahil nakakatipid ito sa rate limit.
Paano sumagot sa comment mula sa event?
Gamit ang mga ID na dala nito. Ang POST /<COMMENT_ID>/replies na may mensahe ay nagpo-post ng pampublikong reply sa ilalim ng comment, gamit ang value.id. Ang POST /<IG_ID>/messages na may recipient.comment_id na nakatakda sa value.id ay nagpapadala sa author ng isang pribadong reply, sa loob ng 7 araw mula sa comment, o habang tumatakbo ang Live broadcast. Ang from.id ay isang Instagram-scoped ID, pero hindi maipapadala nang diretso ang DM dito hangga't hindi pa nakapagpadala ng mensahe ang tao sa account, kaya ang private reply ang paraan para maabot sila sa DM.
Paano ipinapasa ng easyCoexistence ang comment?
Habang dumarating, kapag nakatakda na ang endpoint para sa account gamit ang set_social_webhook_destination mula sa Claude o ChatGPT, o gamit ang PUT /channels/:id/webhook sa Partner API. Sina-subscribe ng easyCoexistence ang bawat naka-connect na account sa mga field na nagdadala ng comments, mentions at DMs nito, sinusuri ang signature ng Meta sa bawat delivery, sinasagot agad ang Meta, at nagpo-POST ng bawat entry para sa account na iyon sa inyong HTTPS URL sa loob ng envelope:
- platform at
external_id: instagram, at ang Instagram ID ng account, katumbas ng entry.id. account_id: ang ID ng koneksyon sa easyCoexistence, ang ibinabalik nglist_social_accountsat ginagamit ng mga MCP tool.- entry: ang entry ng Meta para sa account, walang binago, kaya ang batched delivery ay nagiging isang POST bawat entry. Hindi naipapasa ang object field ng Meta at ang X-Hub-Signature-256.
- Delivery: isang attempt, naghihintay nang hanggang 8 segundo, walang sinusundang redirect, sa HTTPS address na nagreresolba sa public IP. Walang kopyang itinatago at walang retry.
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": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}Ano ang ginagawa ng comment-to-DM rules sa parehong event?
Binabasa ng mga ito ang event kasabay ng forward. Tumutugma ang rule kapag ang comment ay naglalaman ng isa sa mga keyword nito, anuman ang malaki o maliit na letra, sa isang napiling post o sa lahat ng post, at ipinapadala sa author ang DM ng rule bilang pribadong reply nito, kasama ang pampublikong reply kung mayroon ang rule. Nilalaktawan ang mga comment ng account mismo, kumukuha ang mga automation na nagsisimula sa comment ng mga comment na hindi sinagot ng anumang rule, at ang comment na sinagot ng rule ay umaabot pa rin sa inyong endpoint. Ang pampublikong reply ng rule ay maaaring bumalik bilang bagong comments event mula sa account mismo.
Mga karaniwang pagkakamali
- Paghahanap ng comment_id. Sa Instagram Login, nasa value.id ang ID ng comment; ang comment_id ay nabibilang sa payload ng ibang login setup ng Meta.
- Pagsagot sa sariling comment ng account. Bumabalik ang mga reply nito bilang comments event na may from.id na katumbas ng entry.id, at ang automation na sumasagot sa mga ito ay napupunta sa pakikipag-usap sa sarili.
- Pagbasa sa entry.time bilang oras ng comment. Itinatala nito kung kailan ipinadala ng Meta ang notification; ang sariling timestamp field ng comment ang nagsasabi kung kailan ito isinulat.
- Paghihintay ng Live comment sa comments field. Dumarating ang mga ito sa live_comments, na may sariling subscription, at tumatahimik kapag natapos ang broadcast.
Ang comment-to-DM rules at automation ay sumasagot sa mga comment buong araw. US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang mga koneksyon, kasama ang 3 araw na free trial.
Mga madalas itanong
Kasama ba sa Instagram comments webhook ang mga reply sa comment?
Oo. Dumarating ang reply bilang sariling comments event, na may parent_id na may ID ng comment na sinasagot nito.
Nagpapaputok ba ang Instagram comments webhook sa comment sa Reels?
Oo. Ang comment sa Reel ay dumarating sa comments field gaya ng sa post, at sinasabi ng media.media_product_type kung alin ang Reel at alin ang post.
Bakit hindi nagpapaputok ang inyong Instagram comments webhook?
Kadalasan, hindi Live ang app o walang Advanced Access, hindi naka-subscribe ang account sa pamamagitan ng /subscribed_apps, private account ang may-ari ng media, o nasa Live ang comment, na gumagamit ng live_comments.
Kasama ba sa comments webhook ang username ng nag-comment?
Oo. Dala ng value.from ang username ng tao kasama ang kanyang Instagram-scoped ID, kaya walang kailangang dagdag na tawag para ipakita kung sino ang nag-comment.
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