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

# Enviar Áudio

> Envia um arquivo de áudio (mp3, ogg, wav)

## Descrição

Envia um arquivo de áudio para um contato ou grupo. O arquivo deve estar hospedado em uma URL pública acessível. Suporta os formatos MP3, OGG e WAV.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "audio": "https://exemplo.com/audio.mp3",
  "delayMessage": 1000
}
```

| Campo          | Tipo   | Obrigatório | Descrição                                          |
| -------------- | ------ | ----------- | -------------------------------------------------- |
| `phone`        | string | Sim         | Número do destinatário no formato DDI+DDD+número   |
| `audio`        | string | Sim         | URL pública do arquivo de áudio (mp3, ogg, wav)    |
| `delayMessage` | number | Não         | Aguarda N milissegundos antes de enviar a mensagem |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-audio' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "audio": "https://exemplo.com/audio.mp3"
  }'
```

<Note>Para áudio de voz (PTT - Push To Talk), use o endpoint `/send-ptv` que exibe o áudio como mensagem de voz no WhatsApp.</Note>