# Odbieranie dźwięku WhatsApp

Dźwięk wysłany przez kontakt dociera jako wiadomość przychodząca z gałęzią `audio`. Gałąź obejmuje zarówno notatkę głosową nagraną w czacie, jak i załączony plik audio, a `voice` pozwala je odróżnić.

## Co zawiera przychodzący dźwięk

```json
{
  "id": "wam_01kyb3q8ndvt6r2h5k9wxc4pfa",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "audio": {
    "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyb3q8ndvt6r2h5k9wxc4pfa/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
    "mime_type": "audio/ogg; codecs=opus",
    "voice": true
  },
  "created_at": "2026-08-25T09:07:32Z"
}
```

| Pole        | Co zawiera                                                                             |
| ----------- | -------------------------------------------------------------------------------------- |
| `id`        | Zapisany plik, do przekazania jako `media_id` przy pobieraniu bajtów                   |
| `url`       | URL Bird, pobierany z użyciem klucza API                                               |
| `mime_type` | Typ mediów zgłoszony przez WhatsApp, np. `audio/ogg; codecs=opus` dla notatki głosowej |
| `voice`     | `true` dla notatki głosowej nagranej w czacie, a nie załączonego pliku audio           |

`caption` nie istnieje w tej gałęzi w żadnym kierunku, więc wiadomość audio nigdy nie zawiera tekstu. Kontakt, który chce dodać słowa, wysyła osobną [wiadomość tekstową](/docs/guides/whatsapp/receiving-whatsapp/plain-text).

Notatka głosowa pobiera się automatycznie w kliencie WhatsApp i może tam zostać transkrybowana dla odbiorcy. Bird przekazuje dźwięk dalej, ale go nie transkrybuje, więc transkrypcja, którą kontakt widzi we własnej aplikacji, nie jest częścią wiadomości, którą odczytujesz.

## Pobieranie bajtów

Przekaż identyfikator wiadomości i `id` mediów do metody media kanału. Sekcja huba [pobieranie mediów przychodzących](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) zawiera to wywołanie w każdym języku wraz z regułami przekierowań i nagłówków, które stosuje.

`mime_type` określa kontener i kodek, a notatka głosowa to Opus w kontenerze Ogg, a nie MP3 czy AAC, jakie najpewniej ma załącznik. Odczytuj typ z pola, a nie z rozszerzenia pliku w `url`, które go nie zawiera, i sprawdź go przed przekazaniem bajtów do usługi transkrypcji obsługującej tylko wybrane formaty. Wiadomość i jej media wygasają razem, 30 dni po odebraniu wiadomości; sekcja huba [pobieranie mediów przychodzących](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) opisuje to okno czasowe i co zwracają odczyty po jego upływie.

## Ładunek webhooka

`whatsapp.received` zawiera gałąź `audio` w kopercie zdarzenia, wraz z flagą `voice`:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:07:32.451Z",
  "data": {
    "whatsapp_id": "wam_01kyb3q8ndvt6r2h5k9wxc4pfa",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "audio": {
      "id": "waf_01kyb2m4xq7whs0d8n3prv6tez",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyb3q8ndvt6r2h5k9wxc4pfa/media/waf_01kyb2m4xq7whs0d8n3prv6tez",
      "mime_type": "audio/ogg; codecs=opus",
      "voice": true
    },
    "tags": null,
    "metadata": null
  }
}
```

Zautomatyzowany przepływ odpowiadający na notatki głosowe odczytuje `voice` w tym miejscu, zanim cokolwiek pobierze: kolejka wsparcia, która transkrybuje nagrania, ale przekazuje dalej załączone pliki muzyczne, może rozgałęziać się wyłącznie na podstawie tej flagi.

## Na co uważać

- **Traktuj `voice` jako flagę oznaczającą notatkę głosową.** Wszystko inne, w tym brak pola, to zwykły załącznik audio.
- **Czas trwania nie jest raportowany.** Gałąź nie zawiera długości, więc odczytaj ją z pliku po pobraniu, jeśli kolejka tego potrzebuje.

## Następne kroki

- [Jak działa odbieranie](/docs/guides/whatsapp/receiving-whatsapp): koperta wiadomości przychodzącej, pobieranie mediów i webhook `whatsapp.received`
- [Wiadomości audio WhatsApp](/docs/guides/whatsapp/message-types/audio): strona wysyłania tej samej gałęzi
- [Odbieranie wideo](/docs/guides/whatsapp/receiving-whatsapp/video): klipy z podpisem, na który gałąź audio nie ma miejsca
- [Zdarzenia WhatsApp](/docs/guides/whatsapp/events): pełna lista zdarzeń, przez API lub webhooki

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)