> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar Áudio

> Envia um áudio ou mensagem de voz

Envia um áudio para um contato ou grupo. Por padrão, envia como mensagem de voz (PTT - Push To Talk).

## Request Body

<ParamField body="sessionId" type="string" required>
  ID da sessão que enviará a mensagem.
</ParamField>

<ParamField body="to" type="string" required>
  Destinatário (número com DDI ou JID).
</ParamField>

<ParamField body="audio" type="string" required>
  URL do áudio ou conteúdo em base64.

  **Formatos suportados:** OGG/Opus (recomendado), MP3, M4A, WAV

  **Tamanho máximo:** 16 MB
</ParamField>

<ParamField body="ptt" default="true" type="boolean">
  Se `true`, envia como mensagem de voz (bolinha azul). Se `false`, envia como arquivo de áudio.
</ParamField>

<ParamField body="quoted" type="object">
  Responder a uma mensagem específica.
</ParamField>

<RequestExample>
  ```bash cURL (Mensagem de voz) theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "audio": "https://exemplo.com/audio.ogg",
      "ptt": true
    }'
  ```

  ```bash cURL (Arquivo de áudio) theme={"system"}
  curl -X POST "https://api.oxenty.api.br/api/messages/audio" \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "to": "5511999999999",
      "audio": "https://exemplo.com/musica.mp3",
      "ptt": false
    }'
  ```

  ```typescript TypeScript theme={"system"}
  // Mensagem de voz
  const message = await client.messages.sendAudio(sessionId, {
    to: '5511999999999',
    audio: 'https://exemplo.com/audio.ogg',
    ptt: true,
  });

  // Arquivo de áudio
  const message = await client.messages.sendAudio(sessionId, {
    to: '5511999999999',
    audio: 'https://exemplo.com/musica.mp3',
    ptt: false,
  });
  ```

  ```python Python theme={"system"}
  # Mensagem de voz
  message = client.messages.send_audio(
      session_id,
      to='5511999999999',
      audio='https://exemplo.com/audio.ogg',
      ptt=True
  )

  # Arquivo de áudio  
  message = client.messages.send_audio(
      session_id,
      to='5511999999999',
      audio='https://exemplo.com/musica.mp3',
      ptt=False
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "messageId": "3EB0ABC123DEF456789GHI",
    "status": "sent",
    "to": "5511999999999@s.whatsapp.net",
    "timestamp": "2024-01-15T10:30:00.000Z"
  }
  ```
</ResponseExample>

## Formato Recomendado

Para melhor compatibilidade com mensagens de voz (PTT), use o formato **OGG com codec Opus**:

```bash theme={"system"}
# Converter MP3 para OGG/Opus com FFmpeg
ffmpeg -i input.mp3 -c:a libopus -b:a 64k output.ogg
```

<Note>
  Áudios em outros formatos (MP3, WAV, M4A) serão automaticamente convertidos, mas podem ter pequena perda de qualidade ou aumento no tempo de envio.
</Note>

## PTT vs Arquivo de Áudio

| Característica | PTT (ptt: true)  | Arquivo (ptt: false) |
| -------------- | ---------------- | -------------------- |
| Aparência      | Bolinha azul     | Ícone de arquivo     |
| Velocidade     | 1x, 1.5x, 2x     | Player padrão        |
| Comportamento  | Toque para ouvir | Precisa baixar       |