Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(plugins): note data.timestamp cannot order same-second messages

Yudhi Armyndharis028c4eed011f
diff --git a/docs/19-plugin-architecture.md b/docs/19-plugin-architecture.md
index d5ac318c5..96d67ee0c 100644
--- a/docs/19-plugin-architecture.md
+++ b/docs/19-plugin-architecture.md
@@ -527,7 +527,8 @@ The gateway still stores and emits each chat's messages in arrival order: the `m
the start of webhook dispatch wait for every earlier message of the same chat. A slow handler therefore
delays that chat's later messages, by at most its 5 s hook timeout (`SANDBOX_HOOK_TIMEOUT_MS`) for a
sandboxed plugin. Webhook dispatch itself is not ordered: its queue jobs and HTTP deliveries run
-concurrently, so a receiver that needs order should sort by the message's `data.timestamp`.
+concurrently, so a receiver that needs order should sort by the message's `data.timestamp`. That value is
+whole seconds from WhatsApp, so messages sent within the same second cannot be put back in order.
## 19.6 Plugin Loader