{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
"mimetype": "audio/ogg"
},
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA..."
}
}
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Status
Enviar Status de Voz
Enviar status de áudio/voz (story) no 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"
}
Descrição
Este endpoint permite enviar um status de áudio/voz (story) no WhatsApp. Você pode definir quais contatos poderão visualizar o status de voz.Parâmetros de URL
string
required
ID único da sessão autenticada
Corpo da Requisição
object
required
array
Array de JIDs dos contatos que poderão visualizar o status. Se não informado, o status será visível para todos os contatos.Formato do JID:
["5511999999999@s.whatsapp.net"]{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
"mimetype": "audio/ogg"
},
"participants": [
"5511999999999@s.whatsapp.net",
"5511888888888@s.whatsapp.net"
]
}
{
"audio": {
"content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA..."
}
}
Resposta
boolean
required
Indica se o status foi enviado com sucesso
string
ID da mensagem de status enviada
{
"success": true,
"messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}
Códigos de Status
200- Status enviado com sucesso400- Parâmetros inválidos401- Não autorizado500- Erro no servidor
Exemplo de Uso
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';
// Ler áudio e converter para base64
const fs = require('fs');
const audioBuffer = fs.readFileSync('caminho/para/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'
# Ler áudio e converter para base64
with open('caminho/para/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)
Notas
- Status são conteúdos temporários (Stories) que desaparecem após 24 horas
- Se o parâmetro
participantsnão for informado, o status será visível para todos os contatos - O áudio deve ser codificado em base64
- Formatos de áudio suportados: OGG (Opus), MP3, AAC, WAV
- Para melhor compatibilidade, recomenda-se usar o formato OGG com codec Opus
- Status de voz são reproduzidos automaticamente quando visualizados
Authorizations
Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)
Path Parameters
Nome da sessão (instanceName)
Body
application/json
Response
201 - undefined
