Medan webhook Instagram: senarai lengkap
Bagi akaun profesional pada Instagram Login, jadual medan webhook Meta menyenaraikan comments, live_comments, messages, message_echoes, message_reactions, messaging_postbacks, messaging_referral, messaging_seen, messaging_optins, messaging_handover dan standby, dengan mentions dihantar di dalam comments; contohnya turut menyertakan message_edit. Setiap satu memerlukan instagram_business_basic serta instagram_business_manage_comments atau, bagi kebanyakan medan pemesejan, instagram_business_manage_messages. story_insights tidak ditawarkan dengan Instagram Login.
easyCoexistence melanggan setiap akaun Instagram yang disambungkan kepada comments, messages dan mentions, dan memajukan peristiwa tersebut ke endpoint HTTPS anda sebaik sahaja tiba, ditandatangani dengan rahsia akaun itu.
Medan yang aplikasi Instagram baharu dalam App Dashboard mula langgan secara automatik, termasuk comments, messages dan message_reactions.
Medan dipilih untuk aplikasi, bukan bagi setiap akaun: sesebuah akaun menerima medan yang dipilih oleh aplikasi.
Tahap akses yang disenaraikan panduan persediaan Meta untuk webhook Instagram Login, dan yang diwajibkan bagi pemberitahuan comments dan live_comments.
Ditanda tidak tersedia untuk Instagram Login dalam jadual medan Meta, yang menawarkannya dengan Facebook Login dan Unified Login.
Bila Meta memperkenalkan webhook message_edit untuk Business Login for Instagram dan Facebook Login for Business.
Medan webhook yang manakah ditawarkan oleh Instagram Login?
Berikut, daripada jadual medan Meta, dengan perkara yang memicu setiap medan diambil daripada contoh dan rujukan webhook. Setiap medan turut memerlukan instagram_business_basic di samping kebenaran yang ditunjukkan, dan Meta mewajibkan Advanced Access bagi pemberitahuan comments dan live_comments.
Medan manakah tidak tersedia dengan Instagram Login?
Tiga baris dalam jadual medan Meta tidak membawa kebenaran Instagram Login, jadi aplikasi pada Instagram Login tidak menerimanya, dan satu medan lagi hanya wujud di luar Instagram Login:
story_insights: metrik Story apabila ia tamat tempoh, dengan Facebook Login atau Unified Login daninstagram_manage_insights. Rujukan metrik media Meta menyatakan webhook insights tidak disokong dengan Instagram Login.messaging_policy_enforcementdanresponse_feedback: hanya dalam lajur bagi Instagram Messaging API Meta.- mentions sebagai medan tersendiri: Facebook Login dan Unified Login menyenaraikannya, dengan
instagram_manage_comments, manakala Instagram Login menggabungkan mentions ke dalam comments.
Bagaimana cara melanggan medan?
Di dua tempat. Dalam App Dashboard, di bawah tetapan webhook produk Instagram, simpan URL panggil balik dan token pengesahan, yang mencetuskan permintaan pengesahan Meta, kemudian pilih medan; produk Instagram baharu mula melanggan lapan daripadanya. Kemudian langgan setiap akaun dengan POST /<IG_ID>/subscribed_apps pada graph.instagram.com, dengan subscribed_fields ditetapkan kepada medan yang dipilih dalam dashboard, dipisahkan dengan koma.
POST https://graph.instagram.com/<IG_ID>/subscribed_apps
?subscribed_fields=comments,messages,message_reactions
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{ "success": true }Bolehkah setiap akaun mendapat medan yang berbeza?
Tidak. Panduan persediaan Meta menyatakan medan tidak boleh dipilih bagi setiap akaun pengguna aplikasi: sesebuah akaun menerima medan yang dipilih untuk aplikasi. subscribed_fields pada langganan akaun bertujuan menyenaraikan medan dashboard, jadi pengendali patut menjangka sebarang medan yang dipilih aplikasi dan membuat keputusan berdasarkan apa yang dibawa oleh setiap peristiwa, bukan apa yang diminta untuk satu akaun.
Bagaimana medan dibezakan dalam pemberitahuan?
Melalui bentuk entri. Medan komen tiba dalam tatasusunan changes, dan setiap perubahan menamakan medannya. Medan pemesejan tiba dalam tatasusunan messaging tanpa nama medan, dan kunci di sebelah sender, recipient dan timestamp membezakannya:
- changes[].field: comments atau
live_comments, dengan komen dalam value. - message: messages, termasuk gema mesej akaun itu sendiri, yang membawa
is_echobernilai true. - reaksi:
message_reactions. postback:messaging_postbacks. baca:messaging_seen. edit mesej:message_edit. - referral di sebelah sender:
messaging_referral. Referral di dalam message tergolong dalam messages, daripada urutan baharu atau iklan Click-to-Direct. pass_thread_control,take_thread_controlataurequest_thread_control:messaging_handover, seperti yang disenaraikan oleh rujukan webhook Meta.
Medan manakah yang easyCoexistence langgan?
comments, messages dan mentions, senarai yang dilanggan oleh setiap akaun Instagram yang disambungkan. Dengan Instagram Login, mentions datang di dalam comments, jadi langganan merangkumi comments dan DM, dengan gema, balasan Story, sebutan Story dan lampiran antara DM. Medan lain dalam jadual dihantar oleh Meta kepada aplikasi yang melanggannya dan bukan sebahagian daripada langganan sambungan. Setelah endpoint ditetapkan dengan set_social_webhook_destination atau Partner API, easyCoexistence menyemak tandatangan Meta, menjawab Meta serta-merta dan POST setiap entri bagi akaun itu kepada endpoint tersebut:
- platform dan
external_id: instagram, dan ID Instagram akaun, sama dengan entry.id. account_id: ID sambungan dalam easyCoexistence, yang digunakan oleh alat MCP.- entry: entri Meta bagi akaun itu, tidak diubah. Medan object Meta dan header X-Hub-Signature-256 tidak diteruskan.
- X-EC-Signature: t=<unix>,v1=<hex>, HMAC-SHA256 bagi cap masa, noktah dan badan mentah, dikunci dengan rahsia akaun itu sendiri.
- Penghantaran: satu cubaan sehingga 8 saat, tanpa mengikut ubah hala, tanpa simpanan salinan dan tanpa cubaan semula.
Kesilapan biasa
- Menunggu medan mentions dengan Instagram Login. Meta menggabungkan mentions ke dalam pemberitahuan comments, jadi pengendali yang dikunci pada medan mentions tidak pernah berjalan.
- Menganggap akaun hanya menerima medan yang dinyatakan oleh langganannya sendiri. Meta menghantar medan yang dipilih untuk aplikasi, jadi cabangkan berdasarkan apa yang dibawa setiap peristiwa.
- Menganggap message.referral dan referral peringkat atas sebagai satu peristiwa. Yang pertama terletak pada messages; yang kedua ialah messaging_referral, bagi pautan ig.me yang dibuka dalam perbualan sedia ada.
- Menunggu story_insights dengan Instagram Login. Meta menandanya tidak tersedia di situ, jadi baca metrik Story daripada endpoint insights selagi Story masih aktif.
Acara tidak disimpan secara lalai; akaun yang automasinya dihidupkan menyimpan DM dan komennya selama 7 hari. Tetapkan endpoint dengan set_social_webhook_destination daripada Claude atau ChatGPT, atau dengan Partner API. US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma selama 3 hari.
Soalan lazim
Adakah Instagram Login mempunyai medan webhook mentions?
Tidak sebagai medan berasingan. Meta menyertakan mentions dalam pemberitahuan comments bagi Instagram Login; mentions ialah medan tersendiri dengan Facebook Login dan Unified Login.
Adakah story_insights tersedia dengan Instagram Login?
Tidak. Jadual medan Meta menandanya tidak tersedia bagi Instagram Login, dan rujukan metrik media Meta menyatakan webhook insights tidak disokong di situ.
Kebenaran apakah yang diperlukan oleh webhook mesej Instagram?
instagram_business_basic dan instagram_business_manage_messages, dengan Advanced Access, seperti yang disenaraikan panduan persediaan Meta bagi webhook Instagram Login.
Bilakah Meta menambah webhook message_edit untuk Instagram?
Pada 10 September 2025, untuk Business Login for Instagram dan Facebook Login for Business. Suntingan tiba dalam tatasusunan messaging di bawah kunci message_edit.
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