Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs: describe an archived preview's cost and the dashboard's view

Yudhi Armyndharis2c46fd2cc2af
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a3f5122c5..272d7a99a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,7 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Carry `chatId` in `message.ack` and `message.failed` payloads so a webhook `chatId` or `kind` filter scopes delivery events per chat.
- Filter stored messages by time, direction, type or message reference, with stable message-time pagination; the SDKs take these filters from the next SDK release after 0.5.1.
- Scope built-in message search and group detail/settings to a chat-restricted key's allowed chats; reject plugin search for these keys.
-- Expose poll choices and selection mode in message events, stored messages, history, and dashboard chats; the SDKs type them from the next SDK release after 0.5.1.
+- Expose poll choices and selection mode in message events, stored messages and history, and poll choices in dashboard chats; the SDKs type them from the next SDK release after 0.5.1.
- Expose optional last-message types in chat lists and, from the next SDK release after 0.5.1, in the SDKs.
- Add bounded webhook failure redrive with optional payload retention; the SDKs expose it from the next SDK release after 0.5.1.
- Expose caller-supplied send idempotency keys in all five SDKs from the next SDK release after 0.5.1; the 0.5.1 JavaScript and PHP packages ignore the extra argument.
diff --git a/docs/06-api-specification.md b/docs/06-api-specification.md
index 6d1124d81..c6d3a0716 100644
--- a/docs/06-api-specification.md
+++ b/docs/06-api-specification.md
@@ -1596,8 +1596,11 @@ consequences to weigh before enabling it: with a non-zero `CHAT_MEDIA_ARCHIVE_TT
now removes the only copy, after which this route answers `404`; and a database export no longer
carries those bytes, so back up the media store alongside the database. Webhook payloads carry the
in-memory engine message rather than the row, so they are unaffected. The dashboard previews
-archived images, video and audio inline by fetching them from this route. The latest 100 inline or
-archived previews share a memory cap; older media keeps its download button.
+archived images, video and audio inline by fetching them from this route. Each preview is one request
+for the whole file, up to `CHAT_MEDIA_ARCHIVE_MAX_BYTES`, started as its bubble nears the viewport and
+paced under the per-IP rate limit; once the default 100 requests a minute are spent, a refused preview
+stays a download button. The latest 100 inline or archived previews share a memory cap; older media
+keeps its download button.
A revoked message (deleted for everyone, or through `POST /messages/delete`) has no media: its row is
cleared on revoke, and this route answers `404` for it.