Webhook komen Instagram: payload, medan demi medan
Medan comments webhook Instagram memberitahu aplikasi apabila seseorang mengulas, atau membalas komen, pada media akaun profesional, termasuk Reels. Meta menghantar perubahan dengan medan ditetapkan kepada comments, yang membawa id dan teks komen, ID berskop Instagram dan nama pengguna pengarang dalam from, id media dan jenis produk media, serta parent_id apabila komen itu ialah balasan.
easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada komen dan memajukan peristiwa komen yang dihantar Meta untuknya ke endpoint HTTPS anda sebaik sahaja ia tiba, ditandatangani dengan rahsia akaun itu dan tanpa salinan disimpan.
Hadir apabila komen ialah balasan, dengan ID komen yang dibalas.
Ditambah pada from apabila akaun mengulas media sendiri, di sebelah ID akaun itu.
Medan berasingan bagi komen semasa siaran Live; pemberitahuannya berhenti apabila siaran tamat.
Diperlukan bagi pemberitahuan comments dan live_comments; media milik akaun persendirian tidak mencetuskan apa-apa.
Masa yang tinggal untuk menghantar seorang pengulas satu balasan peribadi, dialamatkan dengan ID komen.
Bila medan comments dicetuskan?
Apabila seseorang mengulas media yang dimiliki akaun profesional, atau menyebut akaun itu, selepas aplikasi dan akaun kedua-duanya dilanggan kepada medan itu. Setiap komen ialah satu perubahan dalam pemberitahuan, dan kes-kes ini berkongsi bentuk yang sama:
- Komen baharu pada siaran, Reel, Story atau iklan, dengan media.
media_product_typemenyatakan permukaan media itu. - Balasan di bawah komen sedia ada, yang membawa
parent_iddengan ID komen yang dibalas. - Komen yang dibuat akaun pada media sendiri, termasuk balasannya: from.id ialah ID akaun itu sendiri, dan from menambah
self_ig_scoped_id. - Sebutan @ kepada akaun: dengan Instagram Login, Meta menyertakan sebutan dalam pemberitahuan komen dan bukan medan tersendiri.
- Komen semasa siaran Live datang pada medan berasingan,
live_comments, dengan bentuk nilai yang sama, dan berhenti apabila siaran tamat.
Bagaimana rupa pemberitahuan komen?
Permintaan POST dengan JSON yang mempunyai object ditetapkan kepada instagram dan tatasusunan entry. Setiap entri ialah satu akaun profesional: ID-nya, masa Meta menghantar pemberitahuan, dan tatasusunan changes yang memegang satu perubahan bagi setiap komen. Balasan pada Reel kelihatan begini:
{
"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"
}
}
}
]
}
]
}Apa maksud setiap medan?
Medan yang dicatatkan rujukan webhook Meta untuk komen, dari luar ke dalam:
- entry[].id: ID akaun profesional,
user_idyang dikembalikan /me untuknya. Ia memberitahu anda komen itu milik akaun yang mana. - entry[].time: bila Meta menghantar pemberitahuan, sebagai cap masa Unix. Ia bukan masa komen itu ditulis.
- changes[].field: comments, atau
live_commentsbagi siaran Live. Semak medan ini sebelum membaca value. - value.id: ID komen, yang dibalas secara awam atau secara peribadi, disembunyikan atau dipadam.
- value.text: teks komen, disertakan apabila komen itu mempunyai teks.
- value.from.id dan value.from.username: ID berskop Instagram dan nama pengguna pengarang. value.from.
self_ig_scoped_idmuncul apabila akaun itu sendiri menulis komen. - value.media.id dan value.media.
media_product_type: media yang dikomen dan permukaannya; rujukan media Meta menamakan AD, FEED, STORY dan REELS. - value.
parent_id: pada balasan, ID komen yang dibalas. Komen peringkat atas tidak mempunyainya. - value.media.
ad_id,ad_titledanoriginal_media_id: disenaraikan dalam rujukan bagi komen pada iklan.
Apa yang tidak dilaporkan medan komen?
Beberapa perkara yang mungkin dijangka oleh pengendali tidak disertakan dalam peristiwa atau tidak pernah dihantar, menurut panduan persediaan dan rujukan Meta:
- Komen pada media milik akaun persendirian: Meta tidak menghantar pemberitahuan komen atau sebutan untuknya.
- ID album: peristiwa tidak menyertakannya, dan Meta menyarankan agar album dicari dengan ID komen.
- ID iklan bagi media yang digunakan dalam iklan dinamik.
- Masa komen dicipta: GET /<
COMMENT_ID>?fields=timestamp memulangkannya dalam ISO 8601. - Komen Live selepas siaran tamat, apabila pemberitahuan bagi media Live berhenti.
- Sebutan dalam Story, yang tidak disokong oleh API sebutan Meta; ia sampai ke akaun sebagai DM sebaliknya.
- Peristiwa lampau: Meta tidak menyimpan sejarah pemberitahuan untuk ditanya, jadi simpan apa yang anda perlukan semasa setiap satu tiba.
Apa yang diperlukan medan komen?
Dengan Instagram Login, kebenaran instagram_business_basic dan instagram_business_manage_comments, serta Advanced Access, yang Meta wajibkan bagi pemberitahuan comments dan live_comments. Aplikasi mesti berstatus Live dan dilanggan kepada komen dalam App Dashboard, dan setiap akaun mesti dilanggan melalui POST /<IG_ID>/subscribed_apps dengan comments antara subscribed_fields. Meta amat mengesyorkan webhook ini berbanding tinjauan berulang untuk komen, kerana ia menjimatkan had kadar.
Bagaimana membalas komen daripada peristiwa?
Dengan ID yang dibawanya. POST /<COMMENT_ID>/replies dengan message menghantar balasan awam di bawah komen, menggunakan value.id. POST /<IG_ID>/messages dengan recipient.comment_id ditetapkan kepada value.id menghantar kepada pengarang satu balasan peribadi, dalam tempoh 7 hari dari komen, atau selagi siaran berlangsung pada Live. from.id ialah ID berskop Instagram, tetapi DM yang dihantar terus kepadanya gagal sehingga orang itu pernah menghantar mesej kepada akaun, jadi balasan peribadi ialah cara untuk sampai kepada mereka melalui DM.
Bagaimana easyCoexistence memajukan komen?
Sebaik sahaja ia tiba, selepas endpoint ditetapkan untuk akaun dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan PUT /channels/:id/webhook pada Partner API. easyCoexistence melanggan setiap akaun yang disambungkan kepada medan yang membawa komen, sebutan dan DM-nya, menyemak tandatangan Meta bagi setiap penghantaran, menjawab Meta serta-merta, dan membuat POST bagi setiap entri untuk akaun itu ke URL HTTPS anda dalam sampul:
- platform dan
external_id: instagram, dan ID Instagram akaun itu, sama dengan entry.id. account_id: ID sambungan dalam easyCoexistence, yang dikembalikanlist_social_accountsdan digunakan oleh alat MCP.- entry: entri Meta bagi akaun itu, tanpa diubah, jadi penghantaran berkelompok menjadi satu POST bagi setiap entri. Medan object Meta dan X-Hub-Signature-256 tidak diteruskan.
- Penghantaran: satu cubaan, menunggu sehingga 8 saat, tanpa mengikut ubah hala, ke alamat HTTPS yang diselesaikan kepada IP awam. Tiada salinan disimpan dan tiada cubaan semula.
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" }
}
}
]
}
}Apa yang dilakukan peraturan komen-ke-DM dengan peristiwa yang sama?
Ia membacanya bersama penghantaran. Peraturan dipadankan apabila komen mengandungi salah satu kata kunci, tanpa mengira huruf besar atau kecil, pada satu siaran pilihan atau pada semua siaran, dan menghantar DM peraturan itu kepada pengarang sebagai balasan peribadi mereka, serta balasan awam jika peraturan itu mempunyainya. Komen oleh akaun itu sendiri dilangkau, automasi yang bermula pada komen mengendalikan komen yang tiada peraturan membalasnya, dan komen yang dibalas oleh peraturan tetap sampai ke endpoint anda. Balasan awam peraturan boleh kembali sebagai peristiwa comments baharu daripada akaun itu sendiri.
Kesilapan biasa
- Mencari comment_id. Di bawah Instagram Login, ID komen berada dalam value.id; comment_id tergolong dalam payload persediaan log masuk Meta yang lain.
- Membalas komen akaun sendiri. Balasannya kembali sebagai peristiwa comments dengan from.id sama dengan entry.id, dan automasi yang membalasnya akhirnya bercakap dengan dirinya sendiri.
- Membaca entry.time sebagai masa komen. Ia merekodkan bila Meta menghantar pemberitahuan; medan masa komen itu sendiri menyatakan bila ia ditulis.
- Menunggu komen Live pada medan comments. Ia tiba pada live_comments, yang memerlukan langganan sendiri dan senyap apabila siaran tamat.
Peraturan komen-ke-DM dan automasi membalas komen yang sama sepanjang masa. US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Adakah webhook komen Instagram termasuk balasan kepada komen?
Ya. Balasan tiba sebagai peristiwa comments tersendiri, dengan parent_id memegang ID komen yang dibalas.
Adakah komen Reels mencetuskan webhook komen Instagram?
Ya. Komen pada Reel tiba pada medan comments seperti komen pada siaran, dan media.media_product_type membezakan kedua-duanya.
Mengapa webhook komen Instagram saya tidak dicetuskan?
Selalunya aplikasi tidak berstatus Live atau tiada Advanced Access, akaun tidak pernah dilanggan melalui /subscribed_apps, media milik akaun persendirian, atau komen berada pada Live, yang menggunakan live_comments.
Adakah webhook komen menyertakan nama pengguna pengulas?
Ya. value.from membawa nama pengguna orang itu di sebelah ID berskop Instagram mereka, jadi tiada panggilan tambahan diperlukan untuk menunjukkan siapa yang mengulas.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada