Skip to content
Kirimdev

message.sent media_url for outbound attachments

Released: June 21, 2026

Webhooks Changed

Section titled “Webhooks ”

The message.sent webhook now includes message.media_url and message.media_status for outbound media messages (image, video, audio, document, sticker), plus Meta-style nested blocks (image.link, document.filename, etc.) for integrators migrating from inbound parsers.

  • API and dashboard sends: media_url is the permanent https://media.kirimdev.com/... URL (same asset the inbox uses).
  • Public API sends now persist the outbound link on the message row at insert time so the webhook can include it (previously only passed to the worker queue).
  • Phone-app echoes: message.sent is deferred until storage upload completes (text echoes still fire immediately). Echo type is inferred from the media block (image, video, audio, document, sticker) so outbound media is not mislabeled as text. If download fails after retries, the webhook fires with media_status: "failed".

See Event catalogue → message.sent.