Skip to main content
POST
/
api
/
{session}
/
status
/
voice
{
  "audio": {
    "content": "T2dnUwACAAAAAAAAAADqnjMlAAAAAOyyzPoBHgF2b3JiaXMAAAAAAUSsAAAAAAAAgLsAAAAAAAC4AU9nZ1MAAAAAAAAAAAAA...",
    "mimetype": "audio/ogg"
  },
  "participants": [
    "5511999999999@s.whatsapp.net",
    "5511888888888@s.whatsapp.net"
  ]
}

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

Documentation Index

Fetch the complete documentation index at: https://docs.wappfy.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
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

​
session
string
required
ID único da sessão autenticada

​
Corpo da Requisição

​
audio
object
required
Objeto contendo os dados do áudio
​
participants
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"
  ]
}

​
Resposta

​
success
boolean
required
Indica se o status foi enviado com sucesso
​
messageId
string
ID da mensagem de status enviada
{
    "success": true,
    "messageId": "3EB0796F91D8B2A4E053AC100F0A4D1E"
}

​
Códigos de Status

  • 200 - Status enviado com sucesso
  • 400 - Parâmetros inválidos
  • 401 - Não autorizado
  • 500 - 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"
    }
  }'

​
Notas

  • Status são conteúdos temporários (Stories) que desaparecem após 24 horas
  • Se o parâmetro participants nã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

​
apikey
string
header
required

Sua chave de API do Wappfy (obtenha em dash.wappfy.com.br)

Path Parameters

​
session
string
required

Nome da sessão (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