MasukMulai uji coba gratis
easyCoexistence API resmi

Mention dan balasan Story Instagram di webhook

Instagram mengirimkan mention dan balasan Story sebagai DM pada field webhook messages. Mention masuk sebagai pesan yang lampirannya berisi satu item bertipe story_mention, dengan URL CDN Story di payload.url. Balasan membawa teks orang tersebut dan reply_to.story yang berisi url serta id Story, dan untuk Story dengan stiker tautan, juga link_sticker_url.

easyCoexistence berlangganan field messages pada setiap akun Instagram terhubung, sehingga mention Story dan balasan Story sampai ke endpoint HTTPS Anda bersama DM lainnya saat masuk, ditandatangani dengan rahasia akun tersebut dan tanpa menyimpan salinan.

story_mention

Tipe lampiran pada event messages yang dikirim Meta saat seseorang menyebut akun di Story-nya.

link_sticker_url

Field yang ditambahkan Meta ke reply_to.story pada 12 Desember 2025, berisi URL stiker tautan dari Story yang dibalas.

24 hours

Lama Story bertahan; setelah kedaluwarsa atau dihapus, URL mention-nya berhenti tampil.

Public

Akun yang mention-nya diterima; mention dari akun privat hanya masuk jika akun itu mengikuti akun profesional.

GIF, sticker

Balasan Story yang tidak didukung webhook, menurut panduan Instagram Messaging dari Meta.

Bagaimana mention Story masuk?

Sebagai DM. Saat seseorang menyebut akun profesional di Story-nya, Instagram menaruh pesan yang merujuk Story tersebut di kotak masuk akun, dan Meta mengirim event messages untuknya. sender.id adalah ID khusus Instagram milik orang tersebut, dan message.attachments berisi satu item bertipe story_mention yang payload.url-nya adalah URL CDN Story. Contoh dari Meta tidak menyertakan teks, jadi bacalah lampirannya:

A Story mention, as Meta sends it
{
  "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 masuk?

Juga sebagai DM, dengan pesan orang tersebut dan objek reply_to yang mengarah ke Story akun. reply_to.story membawa url CDN Story dan id-nya. Referensi webhook Meta juga mencantumkan link_sticker_url di sana, ditambahkan pada Desember 2025 untuk balasan ke Story dengan stiker tautan, yang disarankan Meta untuk merutekan otomatisasi berdasarkan tautan. Balasan sebaris ke pesan sebelumnya memakai reply_to.mid sebagai gantinya.

The message object of a Story reply
"message": {
  "mid": "<MESSAGE_ID>",
  "text": "<MESSAGE_TEXT>",
  "reply_to": {
    "story": {
      "url": "<CDN_URL>",
      "id": "<STORY_ID>"
    }
  }
}

Apa arti setiap field?

Field yang didokumentasikan Meta untuk dua event ini, dari luar ke dalam:

  • entry[].id dan recipient.id: akun profesional. sender.id: ID khusus Instagram milik orang tersebut, yaitu ID tujuan balasan.
  • timestamp: waktu pesan dikirim, dalam milidetik pada contoh Meta; entry[].time adalah waktu Meta mengirim notifikasi.
  • message.mid: ID pesan, untuk menghapus duplikat percobaan ulang dan untuk membalas dengan reply_to.mid.
  • attachments[].type story_mention dan payload.url: sebuah mention, dan URL CDN Story yang membuatnya.
  • reply_to.story.url dan reply_to.story.id: Story akun yang dibalas orang tersebut.
  • reply_to.story.link_sticker_url: URL pada stiker tautan Story tersebut.
  • message.text: kata-kata balasan, disertakan saat pesan berisi teks.

Berapa lama URL Story berfungsi?

Selama Story itu sendiri berlaku. Story hilang setelah 24 jam atau saat penulisnya menghapusnya, dan panduan mention Story dari Meta menyatakan URL tersebut kemudian berhenti tampil. Ikhtisar panduan itu menambahkan bahwa URL CDN Instagram sadar privasi dan tidak mengembalikan apa pun untuk konten yang dihapus atau kedaluwarsa. Panduan yang sama mengizinkan menyimpan URL CDN tetapi tidak medianya: aplikasi tidak boleh menyimpan atau menyimpan cache konten Story di server, dan sebaiknya menampilkan placeholder setelah Story hilang.

Kapan kedua event tidak terpicu?

Panduan Meta menyebut kasus berikut, di mana handler yang menunggu event Story tidak menerima apa pun:

  • Mention Story oleh akun privat yang tidak mengikuti akun profesional.
  • Tag pada postingan biasa: Meta menyatakan hanya mention Story yang memicu webhook messages, bukan tag pada postingan.
  • Balasan Story dengan GIF atau stiker, yang tidak didukung webhook.
  • Story lewat API mention: GET /<IG_ID>/tags dan POST /<IG_ID>/mentions tidak mendukungnya, sehingga DM adalah cara mention Story masuk.

Apakah mention dan balasan Story membuka jendela pesan?

Balasan adalah pesan dari orang tersebut, dan Meta mencantumkan mention Story di antara saluran tempat seseorang memulai percakapan. Jendela layanan pelanggan yang dibuka tindakan mereka berlaku 24 jam untuk sebagian besar tindakan, sehingga akun dapat membalas dengan POST /<IG_ID>/messages dan recipient.id diisi sender.id dari event selama jendela masih terbuka. Balasan akun kembali pada messages sebagai echo, dengan is_echo bernilai true.

Bagaimana easyCoexistence meneruskannya?

Pada field messages, yang diikuti setiap akun terhubung, sehingga mention Story dan balasan Story sampai ke endpoint Anda bersama DM lain milik akun tersebut. Setiap entry dibungkus amplop berisi platform, account_id, external_id, dan entry, ditandatangani di X-EC-Signature dengan rahasia akun, dikirim sekali, dan tanpa menyimpan salinan. send_social_dm membalas orang tersebut dengan sender.id event sebagai recipient_id, di dalam jendela layanan pelanggan 24 jam.

A forwarded Story mention, headers included
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>" } }
          ]
        }
      }
    ]
  }
}

Kesalahan umum

  • Menyimpan media Story. Panduan mention Story dari Meta mengizinkan menyimpan URL CDN, bukan kontennya, yang tidak boleh disimpan atau di-cache di server Anda.
  • Hanya membaca message.text. Mention Story membawa lampiran bertipe story_mention dan, pada contoh Meta, tanpa teks, sehingga handler yang hanya membaca teks melihat pesan kosong.
  • Menampilkan URL Story berhari-hari kemudian. URL berhenti bekerja setelah Story kedaluwarsa setelah 24 jam atau dihapus, jadi tampilkan placeholder sejak saat itu.
  • Mencari mention Story di field comments atau API mention. Meta mengirimkannya sebagai DM pada messages.
Melakukan ini dengan EasyCoexistence

send_social_dm membalas orang tersebut dalam jendela layanan pelanggan 24 jam, dari Claude, ChatGPT, atau kode Anda sendiri. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring penambahan koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah event mention Story Instagram menyertakan teks?

Tidak pada contoh Meta. Mention Story membawa lampiran bertipe story_mention dengan URL CDN Story, sehingga handler yang hanya membaca message.text menerima pesan kosong.

Apa itu link_sticker_url pada balasan Story Instagram?

URL pada stiker tautan dari Story yang dibalas orang tersebut, ada di reply_to.story.link_sticker_url. Meta menambahkannya pada 12 Desember 2025 dan menyarankannya untuk merutekan otomatisasi berdasarkan tautan.

Apakah balasan Story berupa GIF atau stiker memicu webhook?

Tidak. Panduan Instagram Messaging dari Meta menyatakan webhook tidak mendukung balasan Story yang dibuat dengan GIF atau stiker.

Apakah akun privat memicu webhook mention Story?

Hanya jika akun privat tersebut mengikuti akun profesional. Mention dari akun publik masuk saat terjadi.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada