Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(message): say only a cold send holds the cold-reachout count

Yudhi Armyndharis957b960b72dd
diff --git a/docs/06-api-specification.md b/docs/06-api-specification.md
index 50b9ae09d..f73ba7c68 100644
--- a/docs/06-api-specification.md
+++ b/docs/06-api-specification.md
@@ -1637,7 +1637,8 @@ A chat send (not an edit) also counts toward both caps before its row lands, so
together pass them. A single send, which writes its row before WhatsApp is asked, is held for 10 seconds
from its admission. A bulk item or product send is held while it is in flight (at most 5 minutes) and
for 10 seconds after. A held send also stays held for as long as any send admitted after it is still
-held. A send that fails before WhatsApp may have taken it hands its place back at once. A daily or
+held; for the cold-reachout cap, only a later cold send keeps an earlier one held. A send that fails
+before WhatsApp may have taken it hands its place back at once. A daily or
cold-reachout refusal can therefore come while the stored count is still under the cap; when only such
held sends push it over, including for the group participant adds below, its `retryAfterSeconds` is 10
or less instead of the time to the next UTC day; while a held send is still in flight or holding, a