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

# Send audio

> Send audio and voice messages via SDK or API

## Voice message (voice note)

Voice messages display with a voice icon, automatic download, and optional transcription. Must be .ogg files with OPUS codec.

<CodeGroup>
  ```typescript TypeScript SDK icon="square-js" theme={null}
  import { WhatsAppClient } from '@kapso/whatsapp-cloud-api';

  const client = new WhatsAppClient({
    baseUrl: 'https://api.kapso.ai/meta/whatsapp',
    kapsoApiKey: process.env.KAPSO_API_KEY!
  });

  await client.messages.sendAudio({
    phoneNumberId: '647015955153740',
    to: '15551234567',
    audio: {
      id: '1013859600285441',
      voice: true
    }
  });
  ```

  ```bash REST API icon="code" theme={null}
  curl -X POST 'https://api.kapso.ai/meta/whatsapp/v24.0/647015955153740/messages' \
    -H 'X-API-Key: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "messaging_product": "whatsapp",
      "to": "15551234567",
      "type": "audio",
      "audio": {
        "id": "1013859600285441",
        "voice": true
      }
    }'
  ```
</CodeGroup>

## Basic audio message

Basic audio displays with a download icon and music icon. Supports AAC, AMR, MP3, MP4, and OGG formats (max 16MB).

<CodeGroup>
  ```typescript TypeScript SDK icon="square-js" theme={null}
  import { WhatsAppClient } from '@kapso/whatsapp-cloud-api';

  const client = new WhatsAppClient({
    baseUrl: 'https://api.kapso.ai/meta/whatsapp',
    kapsoApiKey: process.env.KAPSO_API_KEY!
  });

  await client.messages.sendAudio({
    phoneNumberId: '647015955153740',
    to: '15551234567',
    audio: {
      link: 'https://example.com/ringtone.mp3'
    }
  });
  ```

  ```bash REST API icon="code" theme={null}
  curl -X POST 'https://api.kapso.ai/meta/whatsapp/v24.0/647015955153740/messages' \
    -H 'X-API-Key: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d '{
      "messaging_product": "whatsapp",
      "to": "15551234567",
      "type": "audio",
      "audio": {
        "link": "https://example.com/ringtone.mp3"
      }
    }'
  ```
</CodeGroup>