WhatsApp Stories (statuses) are available through the Whapi API. This article covers how to publish, view, and manage them.
Use the Create & publish story method.
You must choose one of two mutually exclusive types:
Media story β provide a media field (URL, base64, or file ID) with an optional caption.
Text story β provide caption (the text), background_color, caption_color, and optionally font_type. No media field.
There are also type-specific methods:
Post text story method
Post media story method
Post audio story method
Note: Your story will only be visible to contacts who have your number saved in their address book.
Use the Create & publish story method and omit the contacts parameter. When contacts is not specified, Whapi automatically fetches your full contact list and sends the story to all of them.
If you have more than 10 000 contacts, send stories in batches by splitting the list and passing groups via the contacts parameter. This avoids timeouts and ensures reliable delivery.
To see who viewed your story, use the Get group message or story view statuses method with the MessageID of the story.
You can also track views in real time via webhooks β subscribe to the statuses.post and statuses.put events. Note that webhook-based view tracking for stories may not be fully reliable in all cases.
Deleting stories via the API is not currently supported due to technical limitations in how WhatsApp handles status deletion internally.
Stories expire automatically after 24 hours per WhatsApp's standard behavior.
Last updated
