# WhatsApp-Videonachrichten

Eine Videonachricht enthält eine öffentliche URL, die WhatsApp beim Senden abruft, mit einer optionalen Beschriftung darunter.

## Video senden

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

Die vollständige Struktur ergänzt ein optionales `caption`:

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

`video` hat kein `filename`-Feld. `from` ist bei jeder Service-Nachricht erforderlich: eine Nummer, die Ihr Workspace besitzt, keine von Bird verwaltete.

## Limits

| Feld       | Grenzwert                                                | Geprüft von                      |
| ---------- | -------------------------------------------------------- | -------------------------------- |
| Dateigröße | 16 MB                                                    | nur WhatsApp, beim Abruf (async) |
| Format     | MP4-Container, H.264-Video, AAC-Audio                    | nur WhatsApp, beim Abruf (async) |
| `caption`  | bis zu 1024 Zeichen                                      | Bird, bei Annahme (`422`)        |
| `url`      | absolut, `https`, hat einen Host, kein rohes Leerzeichen | Bird, bei Annahme (`422`)        |

Bird prüft die URL-Struktur und die Länge der Beschriftung, bevor etwas eingereiht wird. Dateigröße, Container und Codec werden nicht geprüft; das kann nur der eigene Abruf von WhatsApp beim Senden. Siehe im Hub [Medien per URL senden](/docs/guides/whatsapp/message-types#sending-media-by-url) und [Wenn Medien fehlschlagen](/docs/guides/whatsapp/message-types#when-media-fails).

## Ein eingehendes Video lesen

Ein eingehendes Video enthält dasselbe `video`-Objekt, zusätzlich ein `id` und `mime_type`, die Bird beim Abruf der Datei ermittelt hat. Beide fehlen bei einem ausgehenden Rücklesen, da Bird die gesendete Datei nie selbst abgerufen hat. Siehe [WhatsApp-Video empfangen](/docs/guides/whatsapp/receiving-whatsapp/video) für den vollständigen eingehenden Lesevorgang, die `whatsapp.received`-Payload und worauf Sie achten sollten.

## Limits und Fehlerfälle

- **Das Kundenservice-Fenster muss offen sein.** Video ist eine Service-Nachricht und kann nur innerhalb eines offenen Fensters zugestellt werden; siehe im Hub [Kundenservice-Fenster](/docs/guides/whatsapp/message-types#the-customer-service-window).
- **Bird lehnt `http` ab; WhatsApp selbst würde es abrufen.** Siehe im Hub [Medien per URL senden](/docs/guides/whatsapp/message-types#sending-media-by-url) für die vollständige Strukturprüfung.
- **Ein abgelehnter Abruf wird trotzdem berechnet.** Siehe im Hub [Wenn Medien fehlschlagen](/docs/guides/whatsapp/message-types#when-media-fails) für `media_rejected` und die Tatsache, dass bei Fehlschlag trotzdem Kosten anfallen. Der Ablehnungstext von WhatsApp für Video wurde nicht unabhängig gemessen wie der für Bilder; betrachten Sie die Zuordnung daher als per Analogie abgeleitet, nicht als pro Ursache bestätigt.
- **WhatsApp speichert eine abgerufene URL etwa 10 Minuten im Cache.** Wird dieselbe URL innerhalb dieses Zeitfensters erneut gesendet, wird der erste Abruf wiederverwendet; ändern Sie die URL, um einen neuen Abruf zu erzwingen.
- **Ein animiertes GIF ist kein eigener Typ.** WhatsApp hat keinen `gif`-Nachrichtentyp; ein animiertes GIF, das Sie senden, kommt beim Empfänger an und würde auch bei Ihnen eingehend als gewöhnliches `video` mit einem MP4-MIME-Typ ankommen.

## Nächste Schritte

- [WhatsApp-Service-Nachrichten](/docs/guides/whatsapp/message-types): das Kundenservice-Fenster und das Modell, das alle Service-Nachrichten teilen
- [Bilder](/docs/guides/whatsapp/message-types/images): dieselbe Struktur für ein Foto oder eine Grafik
- [Audio](/docs/guides/whatsapp/message-types/audio): für eine Sprachnachricht oder einen Audioclip
- [WhatsApp-Nachrichten senden](/docs/guides/whatsapp/sending-whatsapp): der Request-Envelope, das `202`-Modell und sicheres erneutes Versuchen

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