Skip to main content
POST
/
api
/
{session}
/
status
/
voice
{
  "audio": {
    "content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
    "mimetype": "audio/ogg"
  },
  "participants": [
    "[email protected]",
    "[email protected]"
  ]
}

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

​
Description

This endpoint allows you to send a voice/audio status (story) on WhatsApp. You can define which contacts will be able to view the voice status.

​
URL Parameters

​
session
string
required
Unique authenticated session ID

​
Request Body

​
audio
object
required
Object containing audio data
​
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: ["[email protected]"]
{
  "audio": {
    "content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
    "mimetype": "audio/ogg"
  },
  "participants": [
    "[email protected]",
    "[email protected]"
  ]
}

​
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/voice \
  -H "Content-Type: application/json" \
  -d '{
    "audio": {
      "content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
      "mimetype": "audio/ogg"
    }
  }'

​
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
  • Audio must be encoded in base64
  • Supported audio formats: OGG (Opus), MP3, AAC, WAV
  • For better compatibility, it is recommended to use OGG format with Opus codec
  • Voice status are automatically played when viewed

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
​
file
object
required
​
backgroundColor
string
default:#38b42f
required
​
id
string

Pre-generated status message id

Example:

"BBBBBBBBBBBBBBBBB"

​
contacts
string[]

Contact list to send the status to.

Example:

null

Response

201 - undefined