# WhatsApp-videoberichten

Een videobericht bevat een openbare URL die WhatsApp ophaalt op het moment van verzending, met een optioneel bijschrift eronder.

## Een video versturen

Stel `video.url` in:

**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](/nl-nl/documentatie/guides/whatsapp/message-types/video.ts.md) · [Python](/nl-nl/documentatie/guides/whatsapp/message-types/video.py.md) · [Go](/nl-nl/documentatie/guides/whatsapp/message-types/video.go.md) · [PHP](/nl-nl/documentatie/guides/whatsapp/message-types/video.php.md) · [CLI](/nl-nl/documentatie/guides/whatsapp/message-types/video.cli.md) · [MCP](/nl-nl/documentatie/guides/whatsapp/message-types/video.mcp.md) · [cURL](/nl-nl/documentatie/guides/whatsapp/message-types/video.curl.md)

De volledige structuur voegt een optionele `caption` toe:

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

`video` heeft geen `filename`-veld. `from` is vereist bij elk servicebericht: een nummer dat je werkruimte bezit, niet een door Bird beheerd nummer.

## Limieten

| Veld            | Limiet                                                      | Afgedwongen door                     |
| --------------- | ----------------------------------------------------------- | ------------------------------------ |
| Bestandsgrootte | 16 MB                                                       | alleen WhatsApp, bij ophalen (async) |
| Formaat         | MP4-container, H.264-video, AAC-audio                       | alleen WhatsApp, bij ophalen (async) |
| `caption`       | maximaal 1024 tekens                                        | Bird, bij acceptatie (`422`)         |
| `url`           | absoluut, `https`, heeft een host, geen ongecodeerde spatie | Bird, bij acceptatie (`422`)         |

Bird controleert de vorm van de URL en de lengte van het bijschrift voordat er iets in de wachtrij wordt geplaatst. Het controleert niet de werkelijke bestandsgrootte, container of codec; dat kan alleen de eigen ophaalactie van WhatsApp op het moment van verzending. Zie in de hub [media versturen via URL](/docs/guides/whatsapp/message-types#sending-media-by-url) en [wanneer media mislukt](/docs/guides/whatsapp/message-types#when-media-fails).

## Een inkomende video lezen

Een inkomende video bevat hetzelfde `video`-object, plus een `id` en `mime_type` die Bird heeft vastgesteld door het bestand op te halen. Beide ontbreken bij het teruglezen van een uitgaand bericht, omdat Bird het verzonden bestand nooit zelf heeft opgehaald. Zie [WhatsApp-video ontvangen](/docs/guides/whatsapp/receiving-whatsapp/video) voor de volledige inkomende leesactie, de `whatsapp.received`-payload en waar je op moet letten.

## Limieten en faalscenario's

- **Het klantenservicevenster moet open zijn.** Video is een servicebericht, alleen afleverbaar binnen een open venster; zie in de hub [klantenservicevenster](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird weigert `http`; WhatsApp zelf zou het wel ophalen.** Zie in de hub [media versturen via URL](/docs/guides/whatsapp/message-types#sending-media-by-url) voor de volledige vormcontrole.
- **Een geweigerde ophaalactie wordt toch in rekening gebracht.** Zie in de hub [wanneer media mislukt](/docs/guides/whatsapp/message-types#when-media-fails) voor `media_rejected` en het feit dat er bij falen kosten in rekening worden gebracht. De eigen weigeringstekst van video van WhatsApp is niet onafhankelijk gemeten zoals die van afbeeldingen, dus beschouw de mapping als afgeleid door symmetrie in plaats van bevestigd per oorzaak.
- **WhatsApp cachet een opgehaalde URL ongeveer 10 minuten.** Als je dezelfde URL binnen dat venster opnieuw verstuurt, wordt het eerste ophaalresultaat hergebruikt; varieer de URL om een nieuw ophaalverzoek af te dwingen.
- **Een geanimeerde GIF is geen apart type.** WhatsApp heeft geen `gif`-berichttype; een geanimeerde GIF die je verstuurt komt bij de ontvanger aan, en zou bij een inkomend bericht ook bij jou aankomen, als een gewone `video` met een MP4-MIME-type.

## Vervolgstappen

- [WhatsApp-serviceberichten](/docs/guides/whatsapp/message-types): het klantenservicevenster en het model dat elk servicebericht deelt
- [Afbeeldingen](/docs/guides/whatsapp/message-types/images): dezelfde structuur voor een foto of afbeelding
- [Audio](/docs/guides/whatsapp/message-types/audio): voor een spraakbericht of audioclip
- [WhatsApp-berichten versturen](/docs/guides/whatsapp/sending-whatsapp): de request-envelope, het `202`-model en veilig opnieuw proberen

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