Send Stories
WhatsApp Stories (statuses) are available through the Whapi API. This article covers how to publish, view, and manage them.
How to publish a Story
Use the Create & publish story method.
You must choose one of two mutually exclusive types:
Media story — provide a
mediafield (URL, base64, or file ID) with an optionalcaption.Text story — provide
caption(the text),background_color,caption_color, and optionallyfont_type. Nomediafield.
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.
How to send a Story to all contacts at once
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.
How to check Story views
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.
How to delete a Story
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