Skip to main content
POST
/
api
/
{session}
/
status
/
text
{
  "text": "Hello! This is my story of the day!",
  "backgroundColor": "#FF5733",
  "font": 1,
  "participants": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}

{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Description

This endpoint allows you to send a text status (story) on WhatsApp. You can customize the text, background color, and font, and also define which contacts will be able to view the status.

​
URL Parameters

​
session
string
required
Unique authenticated session ID

​
Request Body

​
text
string
required
Text to be displayed in the status
​
backgroundColor
string
Background color in hexadecimal format (e.g., “#FF5733”)
​
font
number
Number representing the text font
​
participants
array
Array of contact JIDs who will be able to view the status. If not specified, the status will be visible to all contacts.JID format: ["5511999999999@s.whatsapp.net"]
{
  "text": "Hello! This is my story of the day!",
  "backgroundColor": "#FF5733",
  "font": 1,
  "participants": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}

​
Response

​
success
boolean
required
Indicates if the status was sent successfully
​
messageId
string
Sent status message ID
{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Status Codes

  • 200 - Status sent successfully
  • 400 - Invalid parameters
  • 401 - Unauthorized
  • 500 - Server error

​
Usage Example

curl -X POST https://api.wappfy.com.br/api/my-session/status/text \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello! This is my story of the day!",
    "backgroundColor": "#FF5733",
    "font": 1
  }'

​
Notes

  • Status are temporary content (Stories) that disappear after 24 hours
  • If the participants parameter is not specified, the status will be visible to all contacts
  • Background color must be provided in hexadecimal format (e.g., “#FF5733”)
  • The font field accepts numbers that represent different font styles available on WhatsApp

Authorizations

​
apikey
string
header
required

Your Wappfy API key (get it at dash.wappfy.com.br)

Path Parameters

​
session
string
required

Session name (instanceName)

Body

application/json
​
text
string
default:Have a look! https://github.com/
required
​
backgroundColor
string
default:#38b42f
required
​
font
number
default:0
required
​
id
string

Pre-generated status message id

Example:

"BBBBBBBBBBBBBBBBB"

​
contacts
string[]

Contact list to send the status to.

Example:

null

​
linkPreview
boolean
default:true
​
linkPreviewHighQuality
boolean
default:false

Response

201 - undefined