Dokumentacja
Sign inGet started
Rozpocznij
Przewodniki
Referencja API
SDK
CLI
Baza wiedzy
Changelog

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

Przykład kodu
{
  "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"
}
PoleCo zawiera
idZapisany plik, do przekazania jako media_id przy pobieraniu bajtów
urlURL Bird, pobierany z użyciem klucza API
mime_typeTyp mediów zgłoszony przez WhatsApp, np. audio/ogg; codecs=opus dla notatki głosowej
voicetrue 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ą.
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 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 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:
Przykład kodu
{
  "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

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikConnecting WhatsApp to Bird: from buying a number to a live channelZrozum koncepcjęWhat is the 24-hour customer service window on WhatsApp?Użyj narzędziaWhatsApp message builderPoznaj możliwościWhatsApp
Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy