# Odbieranie wideo WhatsApp

Klip nagrany lub załączony przez kontakt dociera jako wiadomość przychodząca zawierająca `video`: tę samą referencję multimedialną, której używa każda gałąź multimediów przychodzących, oraz ewentualny podpis wpisany pod klipem.

## Co zawiera przychodzące wideo

```json
{
  "id": "wam_01kyc5r9pewu7s3j6m0xyd5qgb",
  "direction": "inbound",
  "from": { "phone_number": "+14155550100" },
  "to": { "phone_number": "+13124495569" },
  "status": "received",
  "video": {
    "id": "waf_01kyc4n5yr8xit1e9o4qsw7ufa",
    "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyc5r9pewu7s3j6m0xyd5qgb/media/waf_01kyc4n5yr8xit1e9o4qsw7ufa",
    "mime_type": "video/mp4",
    "caption": "The rattle starts around 0:12"
  },
  "created_at": "2026-08-25T09:11:48Z"
}
```

| Pole        | Co zawiera                                                             |
| ----------- | ---------------------------------------------------------------------- |
| `id`        | Zapisany plik, przekazywany 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 dla klipu, na przykład `video/mp4` |
| `caption`   | Tekst wpisany przez kontakt pod wideo; nieobecny, gdy nic nie wysłano  |

Gałąź nie zawiera czasu trwania, wymiarów ani miniatury. Odczytaj je z samego pliku po pobraniu bajtów albo z własnego potoku przetwarzania multimediów.

`id` i `mime_type` pojawiają się tylko w przychodzącym wideo, ponieważ Bird uzyskuje oba, pobierając plik. Wychodzące wideo zwraca `url`, który podałeś, bez `id`.

## Pobieranie bajtów

Przekaż identyfikator wiadomości i `id` multimediów do metody media kanału. Sekcja huba [pobieranie multimedió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.

Wideo to największy obiekt, jaki kontakt prawdopodobnie ci wyśle, a pobieranie serwuje bajty prosto z magazynu, a nie przez API, więc przesyłaj strumieniowo odpowiedź na dysk lub do własnego zasobnika zamiast buforować ją w pamięci. Wiadomość i jej multimedia wygasają razem, 30 dni po nadejściu wiadomości; sekcja huba [pobieranie multimediów przychodzących](/docs/guides/whatsapp/receiving-whatsapp#fetching-inbound-media) opisuje to okno i to, co zwracają odczyty po jego upływie.

## Payload webhooka

`whatsapp.received` zawiera gałąź `video` w kopercie zdarzenia:

```json
{
  "type": "whatsapp.received",
  "timestamp": "2026-08-25T09:11:48.204Z",
  "data": {
    "whatsapp_id": "wam_01kyc5r9pewu7s3j6m0xyd5qgb",
    "workspace_id": "ws_01ky7m235keycbnwyajabe1a6b",
    "direction": "inbound",
    "from": { "phone_number": "+14155550100" },
    "to": { "phone_number": "+13124495569" },
    "video": {
      "id": "waf_01kyc4n5yr8xit1e9o4qsw7ufa",
      "url": "https://platform.bird.com/v1/whatsapp/messages/wam_01kyc5r9pewu7s3j6m0xyd5qgb/media/waf_01kyc4n5yr8xit1e9o4qsw7ufa",
      "mime_type": "video/mp4",
      "caption": "The rattle starts around 0:12"
    },
    "tags": null,
    "metadata": null
  }
}
```

Pobieraj klip z kolejkowanego workera, a nie wewnątrz handlera webhooka: endpoint musi odpowiedzieć szybko, a multimedia pozostają dostępne przez całe okno retencji.

## Na co uważać

- **Wideo-notatka jest odczytywana jako wideo.** Okrągła wideo-notatka z WhatsApp dociera na tej gałęzi bez żadnej flagi odróżniającej ją, w przeciwieństwie do audio, gdzie notatka głosowa ustawia `voice`.
- **Jeden klip na wiadomość.** Kilka filmów dociera jako kilka wiadomości przychodzących, każda z własną referencją multimedialną.

## Następne kroki

- [Jak działa odbieranie](/docs/guides/whatsapp/receiving-whatsapp): koperta wiadomości przychodzącej, pobieranie multimediów i webhook `whatsapp.received`
- [Wiadomości wideo WhatsApp](/docs/guides/whatsapp/message-types/video): strona wysyłania tej samej gałęzi
- [Odbieranie audio](/docs/guides/whatsapp/receiving-whatsapp/audio): notatki głosowe i załączone pliki audio
- [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)