{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
"mimetype": "audio/ogg"
},
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA..."
}
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Status
Send Voice Status
Send voice/audio status (story) on WhatsApp
POST
/
api
/
{session}
/
status
/
voice
{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
"mimetype": "audio/ogg"
},
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA..."
}
}
{
"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
string
required
Unique authenticated session ID
Request Body
object
required
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"]{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
"mimetype": "audio/ogg"
},
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA..."
}
}
Response
boolean
required
Indicates if the status was sent successfully
string
Sent status message ID
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Status Codes
200- Status sent successfully400- Invalid parameters401- Unauthorized500- 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"
}
}'
const session = 'my-session';
// Read audio and convert to base64
const fs = require('fs');
const audioBuffer = fs.readFileSync('path/to/audio.ogg');
const base64Audio = audioBuffer.toString('base64');
const response = await fetch(`https://api.wappfy.com.br/api/${session}/status/voice`, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
audio: {
content: base64Audio,
mimetype: 'audio/ogg'
},
participants: ['5511999999999@s.whatsapp.net']
})
});
const data = await response.json();
console.log(data);
import requests
import base64
session = 'my-session'
# Read audio and convert to base64
with open('path/to/audio.ogg', 'rb') as audio_file:
base64_audio = base64.b64encode(audio_file.read()).decode('utf-8')
payload = {
'audio': {
'content': base64_audio,
'mimetype': 'audio/ogg'
},
'participants': ['5511999999999@s.whatsapp.net']
}
response = requests.post(
f'https://api.wappfy.com.br/api/{session}/status/voice',
json=payload
)
data = response.json()
print(data)
Notes
- Status are temporary content (Stories) that disappear after 24 hours
- If the
participantsparameter 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
Your Wappfy API key (get it at dash.wappfy.com.br)
Path Parameters
Session name (instanceName)
Body
application/json
Response
201 - undefined
