# Wiadomości wideo WhatsApp

Wiadomość wideo zawiera publiczny URL, który WhatsApp pobiera w momencie wysyłki, z opcjonalnym podpisem pod spodem.

## Wyślij wideo

Ustaw `video.url`:

**TypeScript**

```typescript
const msg = await bird.whatsapp.send({
  to: "+16505551234",
  from: "+13124495648",
  video: { url: "https://cdn.example.com/unboxing.mp4" },
});
console.log(msg.id, msg.status);
```

Examples: [TypeScript](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.ts.md) · [Python](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.py.md) · [Go](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.go.md) · [PHP](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.php.md) · [CLI](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.cli.md) · [MCP](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.mcp.md) · [cURL](/pl-pl/dokumentacja/guides/whatsapp/message-types/video.curl.md)

Pełna struktura dodaje opcjonalne `caption`:

```json
{
  "to": "+16505551234",
  "from": "+13124495648",
  "video": {
    "url": "https://cdn.example.com/unboxing.mp4",
    "caption": "How to set it up"
  }
}
```

`video` nie ma pola `filename`. `from` jest wymagane w każdej wiadomości serwisowej: numer należący do Twojego obszaru roboczego, a nie zarządzany przez Bird.

## Limity

| Pole          | Ograniczenie                                       | Egzekwowane przez                     |
| ------------- | -------------------------------------------------- | ------------------------------------- |
| Rozmiar pliku | 16 MB                                              | tylko WhatsApp, przy pobraniu (async) |
| Format        | Kontener MP4, wideo H.264, audio AAC               | tylko WhatsApp, przy pobraniu (async) |
| `caption`     | do 1024 znaków                                     | Bird, przy przyjęciu (`422`)          |
| `url`         | bezwzględny, `https`, ma host, bez surowych spacji | Bird, przy przyjęciu (`422`)          |

Bird sprawdza kształt URL-a i długość podpisu, zanim cokolwiek trafi do kolejki. Nie sprawdza rzeczywistego rozmiaru pliku, kontenera ani kodeka; to może zrobić dopiero własne pobranie WhatsApp w momencie wysyłki. Zobacz w hubie [wysyłanie mediów przez URL](/docs/guides/whatsapp/message-types#sending-media-by-url) i [gdy media się nie powiodą](/docs/guides/whatsapp/message-types#when-media-fails).

## Odczyt przychodzącego wideo

Przychodzące wideo zawiera ten sam obiekt `video`, a dodatkowo `id` i `mime_type`, które Bird poznał podczas pobierania pliku. Oba są nieobecne przy odczycie wiadomości wychodzącej, ponieważ Bird nigdy nie pobierał pliku, który wysłał. Zobacz [Odbieranie wideo WhatsApp](/docs/guides/whatsapp/receiving-whatsapp/video), aby poznać pełny odczyt przychodzący, payload `whatsapp.received` i na co zwrócić uwagę.

## Limity i tryby błędów

- **Okno obsługi klienta musi być otwarte.** Wideo jest wiadomością serwisową, dostarczalną tylko w otwartym oknie; zobacz w hubie [okno obsługi klienta](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird odrzuca `http`; WhatsApp sam by go pobrał.** Zobacz w hubie [wysyłanie mediów przez URL](/docs/guides/whatsapp/message-types#sending-media-by-url), aby poznać pełną walidację kształtu.
- **Odrzucone pobranie i tak jest naliczane.** Zobacz w hubie [gdy media się nie powiodą](/docs/guides/whatsapp/message-types#when-media-fails), aby poznać `media_rejected` i fakt naliczania opłaty przy błędzie. Treść odrzucenia wideo od WhatsApp nie została niezależnie zmierzona tak jak w przypadku obrazów, więc traktuj mapowanie jako wywnioskowane przez analogię, a nie potwierdzone dla każdej przyczyny.
- **WhatsApp buforuje pobrany URL przez około 10 minut.** Ponowne wysłanie identycznego URL-a w tym oknie serwuje pierwszy fetch; zmień URL, aby wymusić nowe pobranie.
- **Animowany GIF nie jest osobnym typem.** WhatsApp nie ma typu wiadomości `gif`; animowany GIF, który wyślesz, dociera do odbiorcy i wróciłby do Ciebie jako wiadomość przychodząca, jako zwykły `video` z typem MIME MP4.

## Następne kroki

- [Wiadomości serwisowe WhatsApp](/docs/guides/whatsapp/message-types): okno obsługi klienta i model wspólny dla każdej wiadomości serwisowej
- [Obrazy](/docs/guides/whatsapp/message-types/images): ta sama struktura dla zdjęcia lub grafiki
- [Audio](/docs/guides/whatsapp/message-types/audio): dla notatki głosowej lub klipu audio
- [Wysyłanie wiadomości WhatsApp](/docs/guides/whatsapp/sending-whatsapp): koperta żądania, model `202` i bezpieczne ponawianie

## 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)