Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Instagram story mentions at story replies sa webhook

Ipinapadala ng Instagram ang mga Story mention at Story reply bilang DM sa messages webhook field. Ang mention ay dumarating bilang mensahe na may attachments na naglalaman ng item na type story_mention, kasama ang CDN URL ng Story sa payload.url. Ang reply ay may teksto ng tao at reply_to.story na may url at id ng Story, at para sa Story na may link sticker, ang link_sticker_url.

Naka-subscribe ang easyCoexistence sa messages ng bawat naka-connect na Instagram account, kaya ang Story mention at Story reply ay dumarating sa inyong HTTPS endpoint kasama ng iba pang DM habang dumarating, nilagdaan ng secret ng account na iyon, at walang kopyang itinatago.

story_mention

Attachment type ng messages event na ipinapadala ng Meta kapag may nag-mention sa account sa kanilang Story.

link_sticker_url

Field na idinagdag ng Meta sa reply_to.story noong 12 Disyembre 2025, na naglalaman ng link sticker URL ng Story na sinagot.

24 hours

Gaano katagal tumatagal ang Story; kapag nag-expire o na-delete ito, hindi na ma-render ang mention URL nito.

Public

Mga account na dumarating ang Story mention; ang mention ng private account ay dumarating lang kung sinusundan nito ang professional account.

GIF, sticker

Mga Story reply na hindi sinusuportahan ng webhook, ayon sa Instagram Messaging guide ng Meta.

Paano dumarating ang Story mention?

Bilang DM. Kapag may nag-mention sa professional account sa kanilang Story, naglalagay ang Instagram ng mensahe na tumutukoy sa Story na iyon sa inbox ng account, at nagpapadala ang Meta ng messages event para dito. Ang sender.id ay ang Instagram-scoped ID ng tao, at ang message.attachments ay naglalaman ng isang item na type story_mention na ang payload.url ay ang CDN URL ng Story. Walang teksto sa mga sample ng Meta, kaya basahin ang attachment:

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>" }
              }
            ]
          }
        }
      ]
    }
  ]
}

Paano dumarating ang Story reply?

Bilang DM din, may mensahe ng tao at object na reply_to na tumuturo sa Story ng account. Ang reply_to.story ay naglalaman ng CDN url at id ng Story. Nakalista rin sa webhook reference ng Meta ang link_sticker_url doon, idinagdag noong Disyembre 2025 para sa mga reply sa Story na may link sticker, na iminumungkahi ng Meta na gamitin sa pag-route ng automation ayon sa link. Ang inline reply sa naunang mensahe ay gumagamit ng reply_to.mid sa halip.

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

Ano ang ibig sabihin ng bawat field?

Ang mga field na dokumentado ng Meta para sa dalawang event na ito, mula sa labas papasok:

  • entry[].id at recipient.id: ang professional account. sender.id: ang Instagram-scoped ID ng tao, ang ID kung saan napupunta ang reply.
  • timestamp: kailan ipinadala ang mensahe, sa millisecond sa mga sample ng Meta; ang entry[].time ay kung kailan ipinadala ng Meta ang notification.
  • message.mid: ang message ID, para sa pag-deduplicate ng mga retry at para sa pagsagot gamit ang reply_to.mid.
  • attachments[].type story_mention at payload.url: isang mention, at ang CDN URL ng Story na nagbigay nito.
  • reply_to.story.url at reply_to.story.id: ang Story ng account na sinagot ng tao.
  • reply_to.story.link_sticker_url: ang URL sa link sticker ng Story na iyon.
  • message.text: ang mga salita ng reply, kasama kapag may teksto ang mensahe.

Gaano katagal gumagana ang Story URL?

Hangga't tumatagal ang Story. Nawawala ang Story pagkalipas ng 24 oras o kapag na-delete ito ng author, at sinasabi ng story mention guide ng Meta na hindi na mare-render ang URL. Idinagdag ng overview nito na ang CDN URL ng Instagram ay privacy-aware at walang ibinabalik para sa deleted o expired na content. Pinapayagan din ng parehong guide na panatilihin ang CDN URL pero hindi ang media: hindi dapat i-store o i-cache ng app ang content ng Story sa kanilang server, at dapat magpakita ng placeholder kapag wala na ang Story.

Kailan walang dumarating na event?

Pinangalanan ng mga guide ng Meta ang mga kasong ito, kung saan walang natatanggap ang handler na naghihintay ng Story event:

  • Story mention ng private account na hindi sinusundan ang professional account.
  • Tag sa regular na post: sinasabi ng Meta na tanging Story mention lang ang nagti-trigger sa messages webhook, hindi ang pag-tag sa mga post.
  • Story reply na may GIF o sticker, na hindi sinusuportahan ng webhook.
  • Mga Story sa pamamagitan ng mentions API: hindi ito sinusuportahan ng GET /<IG_ID>/tags at POST /<IG_ID>/mentions, kaya ang DM ang paraan kung paano dumarating ang Story mention.

Nagbubukas ba ng messaging window ang Story mention at reply?

Ang reply ay isang mensahe mula sa tao, at nakalista ng Meta ang Story mention sa mga channel kung saan nagsisimula ng usapan ang isang tao. Ang window na nabubuksan ng kanilang aksyon ay tumatagal ng 24 oras para sa karamihan ng aksyon, kaya maaaring sumagot ang account gamit ang POST /<IG_ID>/messages at recipient.id na nakatakda sa sender.id ng event habang bukas ito. Ang sagot ng account ay bumabalik sa messages bilang echo, na may is_echo na nakatakda sa true.

Paano ito ipinapasa ng easyCoexistence?

Sa messages field, kung saan naka-subscribe ang bawat naka-connect na account, kaya ang Story mention at Story reply ay dumarating sa inyong endpoint kasama ng iba pang DM ng account: bawat entry sa loob ng envelope ng platform, account_id, external_id at entry, na nilagdaan sa X-EC-Signature gamit ang secret ng account, naipadala nang isang beses at walang kopyang itinatago. Sinasagot ng send_social_dm ang tao gamit ang sender.id ng event bilang recipient_id, sa loob ng 24-oras na window.

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>" } }
          ]
        }
      }
    ]
  }
}

Mga karaniwang pagkakamali

  • Pag-store ng media ng Story. Pinapayagan ng story mention guide ng Meta na panatilihin ang CDN URL, hindi ang content, na hindi dapat i-store o i-cache sa inyong server.
  • Pagbasa lang sa message.text. Ang Story mention ay may attachment na type story_mention at, sa mga sample ng Meta, walang teksto, kaya ang text-only handler ay nakakakita ng walang laman na mensahe.
  • Pag-render ng Story URL pagkalipas ng ilang araw. Hindi na ito gumagana kapag nag-expire ang Story pagkalipas ng 24 oras o na-delete, kaya magpakita ng placeholder mula noon.
  • Paghahanap ng Story mention sa comments field o sa mentions API. Inihahatid ito ng Meta bilang DM sa messages.
Ginagawa ito gamit ang EasyCoexistence

Sinasagot ng send_social_dm ang tao sa loob ng 24-oras na window, mula kay Claude, ChatGPT o sa sarili ninyong code. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at may free trial na 3 araw.

Mga madalas itanong

May teksto ba ang Instagram Story mention event?

Wala sa mga sample ng Meta. Ang Story mention ay may attachment na type story_mention na may CDN URL ng Story, kaya ang handler na tanging message.text lang ang binabasa ay nakakakita ng walang laman na mensahe.

Ano ang link_sticker_url sa Instagram Story reply?

Ang URL sa link sticker ng Story na sinagot ng tao, nasa reply_to.story.link_sticker_url. Idinagdag ito ng Meta noong 12 Disyembre 2025 at iminumungkahi para sa pag-route ng automation ayon sa link.

Nagti-trigger ba sa webhook ang GIF o sticker na reply sa Story?

Hindi. Sinasabi ng Instagram Messaging guide ng Meta na hindi sinusuportahan ng webhook ang Story reply na ginawa gamit ang GIF o sticker.

Nagti-trigger ba ng Story mention webhook ang mga private account?

Kapag lang sinusundan ng private account ang professional account. Ang mention mula sa public account ay dumarating habang nangyayari ito.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong