Peristiwa webhook Instagram: komen, sebutan dan DM
Peristiwa webhook Instagram melaporkan aktiviti pada akaun profesional semasa ia berlaku: komen baharu, @sebutan dan DM. Meta menghantar setiap satu sebagai JSON (POST) ke endpoint HTTPS aplikasi yang disambungkan dan mencuba semula penghantaran yang gagal ke endpoint itu sehingga 36 jam. easyCoexistence memajukan setiap peristiwa kepada endpoint anda sekali sahaja, ditandatangani mengikut akaun, tanpa cuba semula. Dengan Instagram Login, sebutan tiba dalam pemberitahuan komen.
Tempoh Meta terus mencuba semula penghantaran yang gagal ke endpoint aplikasi sebelum ia digugurkan.
Kebanyakan kemas kini digabungkan oleh Meta menjadi satu penghantaran webhook, walaupun Meta tidak menjamin penggabungan.
Bendera yang Meta tetapkan pada peristiwa mesej yang dihantar oleh akaun itu sendiri.
Hanya media pada akaun awam mencetuskan pemberitahuan komen dan sebutan.
Apakah peristiwa yang ada?
Bagi akaun profesional yang disambungkan dengan Instagram Login, tiga jenis aktiviti tiba sebagai peristiwa:
- Komen: komen baharu pada media akaun, dengan ID komen, ID dalam skop Instagram dan nama pengguna pengarang, teks, serta ID dan jenis media.
- Sebutan: dengan Instagram Login, ia datang dalam pemberitahuan komen dan bukan sebagai medan tersendiri.
- Mesej: DM kepada akaun, dengan pengirim, penerima, cap masa dan mesej itu sendiri, termasuk teks, lampiran dan balasan Story.
Bagaimana peristiwa sampai ke endpoint anda?
Meta menghantar webhook Instagram kepada aplikasi yang disambungkan oleh akaun itu. easyCoexistence menerimanya dan memajukan setiap satu ke endpoint HTTPS yang anda tetapkan untuk akaun itu, sebaik sahaja tiba, ditandatangani dengan rahsia khas untuk akaun itu.
Tetapkan endpoint dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API melalui PUT /channels/:id/webhook. Rahsia tandatangan dipaparkan sekali sahaja, menetapkan semula endpoint akan mengeluarkan rahsia baharu, dan menghantar null sebagai URL akan mematikan pemajuan.
Seperti apa rupa satu penghantaran?
POST dengan badan JSON yang mengandungi platform, account_id yang diberikan oleh list_social_accounts bagi sambungan itu, external_id akaun Instagram, dan entry: entri webhook Meta bagi peristiwa itu, tanpa perubahan. DM tiba dengan cara yang sama, tetapi dengan tatasusunan messaging dan bukan changes. Komen baharu kelihatan seperti ini:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}Bagaimana anda mengesahkan penghantaran?
Setiap penghantaran membawa header X-EC-Signature dalam bentuk t=<unix>,v1=<hex>, dengan v1 ialah HMAC-SHA256 bagi cap masa, titik dan badan permintaan mentah, dikunci dengan rahsia tandatangan akaun. Kira ia ke atas badan mentah tepat seperti yang diterima, bandingkan dalam masa tetap, dan tolak cap masa yang lebih lama daripada 5 minit.
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}Adakah penghantaran dicuba semula?
Tidak oleh easyCoexistence: pemajuan menghantar setiap peristiwa sekali sahaja, dalam memori, dan tidak menyimpan salinan untuk dicuba semula. Balas dengan 2xx dengan segera dan lakukan kerja kemudian, dan simpan apa sahaja yang anda perlukan sebaik ia tiba, kerana Meta juga tidak menyimpan sejarah pemberitahuan lepas yang boleh ditanya.
Meta sendiri mencuba semula penghantaran yang gagal ke aplikasi sehingga 36 jam, jadi peristiwa yang sama kadangkala boleh sampai dua kali: nyahduplikasi berdasarkan ID komen atau mid mesej.
Apa lagi yang perlu disemak oleh pengendali?
Beberapa butiran dalam payload Meta yang sering menyusahkan pengendali pertama:
is_echo: peristiwa mesej denganis_echobernilai true dihantar oleh akaun itu sendiri, jadi ia tidak perlu dibalas.- Balasan Story: DM yang menjawab Story membawa
reply_todengan ID dan URL Story itu. - Sebutan Story: tiba sebagai mesej yang jenis lampirannya
story_mention. - time: bila Meta menghantar pemberitahuan, bukan bila komen atau mesej dibuat; cap masa mesej terdapat dalam entri messaging-nya.
- ID album: peristiwa komen tidak menyertakannya; cari album dengan ID komen.
Kesilapan biasa
- Melakukan kerja sebelum membalas. Pemajuan tidak mencuba semula, jadi pulangkan 2xx serta-merta dan proses peristiwa kemudian.
- Mengesahkan tandatangan pada JSON yang telah diurai. Kira HMAC ke atas badan mentah tepat seperti yang tiba.
- Membalas gema. Peristiwa mesej dengan is_echo bernilai true ialah mesej yang dihantar oleh akaun itu, dan membalasnya memulakan gelung.
- Mengabaikan nyahduplikasi. Meta boleh menghantar semula peristiwa yang sama selepas kegagalan, jadi kunci pada ID komen atau mid mesej.
easyCoexistence memajukan komen, sebutan dan DM akaun Instagram ke endpoint HTTPS anda sebaik ia tiba, ditandatangani dengan rahsia untuk akaun itu dan tanpa salinan disimpan semasa pemajuan. Hidupkan dengan set_social_webhook_destination dari Claude atau ChatGPT, atau dengan Partner API. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan percubaan percuma 3 hari.
Soalan lazim
Apa maksud medan time dalam webhook Instagram?
Bila Meta menghantar pemberitahuan, bukan bila komen atau mesej dibuat. Cap masa DM terdapat dalam entri messaging-nya.
Adakah Meta mencuba semula penghantaran webhook Instagram yang gagal?
Ya. Meta mencuba semula penghantaran yang gagal ke aplikasi sehingga 36 jam, jadi peristiwa yang sama kadangkala boleh tiba dua kali: nyahduplikasi berdasarkan ID komen atau mid mesej. easyCoexistence memajukan setiap peristiwa ke endpoint anda sekali sahaja, jadi balas dengan 2xx dengan segera.
Berapa banyak kemas kini boleh ada dalam satu penghantaran webhook Instagram?
Sehingga 1,000 apabila Meta menggabungkannya, walaupun Meta tidak menjamin penggabungan. Gelung ke atas keseluruhan tatasusunan entry dan bukan hanya item pertama.
Adakah sebutan mempunyai peristiwa sendiri?
Tidak dengan Instagram Login. Meta menyertakan sebutan dalam pemberitahuan komen, jadi ia tiba melalui laluan yang sama dengan komen.
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