Sebutan dan balasan Story Instagram dalam webhook
Instagram menghantar sebutan dan balasan Story sebagai DM pada medan webhook messages. Sebutan tiba sebagai mesej yang attachments-nya mengandungi satu item jenis story_mention, dengan URL CDN Story dalam payload.url. Balasan membawa teks orang itu dan reply_to.story, yang mengandungi url dan id Story tersebut, serta link_sticker_url bagi Story yang mempunyai pelekat pautan.
easyCoexistence melanggan setiap akaun Instagram bersambung kepada messages, supaya sebutan Story dan balasan Story sampai ke endpoint HTTPS anda bersama DM lain apabila tiba, ditandatangani dengan rahsia akaun itu dan tanpa salinan disimpan.
Jenis atribut bagi peristiwa mesej yang Meta hantar apabila seseorang menyebut akaun itu dalam Story mereka.
Medan yang Meta tambah pada reply_to.story pada 12 Disember 2025, mengandungi URL pelekat pautan Story yang dibalas.
Tempoh Story kekal; sebaik sahaja tamat tempoh atau dipadam, URL sebutannya berhenti dipaparkan.
Akaun yang sebutan Story mereka tiba; sebutan daripada akaun persendirian hanya tiba jika ia mengikuti akaun profesional.
Balasan Story yang tidak disokong webhook, menurut panduan Instagram Messaging Meta.
Bagaimana sebutan Story tiba?
Sebagai DM. Apabila seseorang menyebut akaun profesional dalam Story mereka, Instagram meletakkan mesej yang merujuk Story itu dalam peti masuk akaun, dan Meta menghantar peristiwa messages untuknya. sender.id ialah ID berskop Instagram orang itu, dan message.attachments mengandungi satu item jenis story_mention yang payload.url-nya ialah URL CDN Story itu. Sampel Meta tidak menunjukkan teks, jadi bacalah atribut itu:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{
"type": "story_mention",
"payload": { "url": "<CDN_URL>" }
}
]
}
}
]
}
]
}Bagaimana balasan Story tiba?
Juga sebagai DM, dengan mesej orang itu dan objek reply_to yang menunjuk kepada Story akaun itu. reply_to.story membawa url CDN Story dan id-nya. Rujukan webhook Meta turut menyenaraikan link_sticker_url di situ, yang ditambah pada Disember 2025 bagi balasan kepada Story yang mempunyai pelekat pautan, dan yang Meta cadangkan untuk menghala automasi mengikut pautan. Balasan sebaris kepada mesej terdahulu pula menggunakan reply_to.mid.
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL>",
"id": "<STORY_ID>"
}
}
}Apa maksud setiap medan?
Medan yang Meta dokumenkan untuk dua peristiwa ini, dari luar ke dalam:
- entry[].id dan recipient.id: akaun profesional. sender.id: ID berskop Instagram orang itu, ID tempat balasan dihantar.
- timestamp: bila mesej dihantar, dalam milisaat dalam sampel Meta; entry[].time ialah bila Meta menghantar pemberitahuan.
- message.mid: ID mesej, untuk menapis cubaan semula yang berulang dan untuk membalas dengan
reply_to.mid. - attachments[].type
story_mentiondan payload.url: sebutan, dan URL CDN Story yang membuatnya. reply_to.story.url danreply_to.story.id: Story akaun yang dibalas orang itu.reply_to.story.link_sticker_url: URL pada pelekat pautan Story itu.- message.text: perkataan balasan, disertakan apabila mesej mengandungi teks.
Berapa lama URL Story berfungsi?
Selagi Story itu wujud. Story hilang selepas 24 jam atau apabila pengarangnya memadamkannya, dan panduan sebutan Story Meta menyatakan URL itu kemudian berhenti dipaparkan; ikhtisarnya menambah bahawa URL CDN Instagram mengambil kira privasi dan memulangkan kosong bagi kandungan yang dipadam atau tamat tempoh. Panduan yang sama membenarkan URL CDN disimpan tetapi bukan media: aplikasi tidak boleh menyimpan atau menyimpan dalam cache kandungan Story pada pelayannya, dan hendaklah memaparkan pemegang tempat sebaik sahaja Story itu hilang.
Bilakah kedua-dua peristiwa tidak tercetus?
Panduan Meta menamakan kes ini, di mana pengendali yang menunggu peristiwa Story tidak menerima apa-apa:
- Sebutan Story oleh akaun persendirian yang tidak mengikuti akaun profesional.
- Tag pada siaran biasa: Meta menyatakan hanya sebutan Story yang mencetuskan webhook messages, bukan penandaan pada siaran.
- Balasan Story dengan GIF atau pelekat, yang tidak disokong webhook.
- Story melalui API sebutan: GET /<
IG_ID>/tags dan POST /<IG_ID>/mentions tidak menyokongnya, maka DM ialah cara sebutan Story tiba.
Adakah sebutan dan balasan Story membuka tetingkap mesej?
Balasan ialah mesej daripada orang itu, dan Meta menyenaraikan sebutan Story antara saluran tempat seseorang memulakan perbualan. Tetingkap yang dibuka oleh tindakan mereka kekal 24 jam bagi kebanyakan tindakan, jadi akaun itu boleh membalas dengan POST /<IG_ID>/messages dan recipient.id ditetapkan kepada sender.id peristiwa itu semasa tetingkap masih terbuka. Balasan akaun itu kembali pada messages sebagai echo, dengan is_echo ditetapkan kepada true.
Bagaimana easyCoexistence menghantarnya?
Pada medan messages, yang setiap akaun bersambung dilanggan, supaya sebutan Story dan balasan Story sampai ke endpoint anda bersama DM lain akaun itu: setiap entri berada dalam sampul yang mengandungi platform, account_id, external_id dan entry, ditandatangani dalam X-EC-Signature dengan rahsia akaun itu, dihantar sekali dan tanpa salinan disimpan. send_social_dm membalas orang itu dengan sender.id peristiwa sebagai recipient_id, dalam tetingkap 24 jam.
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": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "story_mention", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
}Kesilapan biasa
- Menyimpan media Story. Panduan sebutan Story Meta membenarkan URL CDN disimpan, bukan kandungannya, yang tidak boleh disimpan atau disimpan dalam cache pada pelayan anda.
- Hanya membaca message.text. Sebutan Story membawa atribut jenis story_mention dan, dalam sampel Meta, tiada teks, jadi pengendali yang hanya membaca teks melihat mesej kosong.
- Memaparkan URL Story beberapa hari kemudian. Ia berhenti berfungsi selepas Story tamat tempoh selepas 24 jam atau dipadam, jadi paparkan pemegang tempat dari saat itu.
- Mencari sebutan Story pada medan comments atau API sebutan. Meta menghantarnya sebagai DM pada messages.
send_social_dm membalas orang itu dalam tetingkap 24 jam, daripada Claude, ChatGPT atau kod anda sendiri. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari.
Soalan lazim
Adakah peristiwa sebutan Story Instagram mengandungi teks?
Tidak dalam sampel Meta. Sebutan Story membawa atribut jenis story_mention dengan URL CDN Story, jadi pengendali yang hanya membaca message.text melihat mesej kosong.
Apakah link_sticker_url dalam balasan Story Instagram?
URL pada pelekat pautan Story yang dibalas orang itu, dalam reply_to.story.link_sticker_url. Meta menambahnya pada 12 Disember 2025 dan mencadangkannya untuk menghala automasi mengikut pautan.
Adakah balasan Story dengan GIF atau pelekat mencetuskan webhook?
Tidak. Panduan Instagram Messaging Meta menyatakan webhook tidak menyokong balasan Story yang dibuat dengan GIF atau pelekat.
Adakah akaun persendirian mencetuskan webhook sebutan Story?
Hanya apabila akaun persendirian itu mengikuti akaun profesional. Sebutan daripada akaun awam tiba sebaik sahaja ia berlaku.
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