Back to Changelog
v2026.11.08

Media on Incoming Direct Messages

Inbound DMs now carry the media and links your contacts share, with a consistent way to tell what kind of content you're looking at:

  • See what contacts send and share in DMs: Incoming messages from Instagram, Facebook and X now include an attachments list with the media or content a contact sent, each item carrying a type, a url, a title, and an mediaId. This arrives on the message.received webhook, on your own app's sent-message echoes, and on message objects returned from the conversations endpoint. Previously this information was discarded, so mediaUrls was always empty even when a contact sent a photo, video, voice note, or shared post.
  • One consistent type across every network: Attachments now use a single normalized type (image, video, audio, file, link, or unknown) so you can render media the same way regardless of which network it came from, instead of handling each network's own naming. The network's original value is still available in platformType if you need it, which also lets you tell a contact's own video apart from a shared reel, since both normalize to video.
  • Shared reels, posts, and stories are marked as links, not playable media: Instagram and Facebook deliver shared reels, posts, forwarded stories, and link previews as a page link rather than the actual video or image file. These now come through as type: link instead of being mistaken for downloadable media, so a shared reel never gets pointed at a video player expecting a file it won't receive, and only real files show up in mediaUrls.