--- title: "WhatsApp-API-Medien: Dateitypen und Größenlimits im Überblick" description: "Größenlimits und Dateitypen der WhatsApp-API für Bilder, Video, Audio, Dokumente und Sticker, dazu Upload oder Link, Media-IDs und Bildunterschriften." canonical: "https://omnichannels.ai/de/blog/whatsapp-media-messages-file-types-size-limits/" language: "de" updated: "2026-11-07" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "whatsapp" primaryQuery: "whatsapp api media file size limit" keywords: ["WhatsApp API Dateigröße Limit", "WhatsApp API unterstützte Dateiformate", "WhatsApp Cloud API Medien", "WhatsApp Video maximale Größe", "WhatsApp Dokument Größenlimit", "WhatsApp Sticker Größe", "WhatsApp Media-ID Ablauf", "WhatsApp Vorlage Header Bild", "Fehler 131053 WhatsApp"] published: "2026-11-07" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 9 answer: "Metas Dokumentation nennt zum Redaktionszeitpunkt diese Höchstgrößen für Medien der WhatsApp Cloud API: Bilder 5 MB (JPEG, PNG, statisches WebP), Video 16 MB (MP4 oder 3GPP mit H.264 und AAC), Audio 16 MB, Dokumente 100 MB, animierte Sticker 500 KB und statische Sticker 100 KB. Laden Sie die Datei hoch und senden Sie die Media-ID statt eines Links, und prüfen Sie, ob der MIME-Typ zur Datei passt." takeaways: ["Laut Metas Dokumentation gelten zum Redaktionszeitpunkt diese Größenlimits: 5 MB für Bilder, 16 MB für Video und Audio, 100 MB für Dokumente und 500 KB (animiert) bzw. 100 KB (statisch) für Sticker.", "Video muss H.264 mit AAC-Audio sein, Bilder müssen 8-Bit-RGB oder -RGBA sein; eine Datei innerhalb des Größenlimits kann trotzdem wegen Codec oder Farbformat abgelehnt werden.", "Meta empfiehlt, hochgeladene Medien aus Performance-Gründen per ID statt per Link zu senden.", "Media-IDs aus einem Upload laufen nach 30 Tagen ab, IDs aus eingehenden Webhooks nach 7 Tagen. Laden Sie Kundendateien daher zeitnah herunter.", "Bildunterschriften bei Bild, Video und Dokument sind auf 1.024 Zeichen begrenzt; Fehler 131053 deutet meist auf einen MIME-Typ hin, der nicht zur Datei passt."] faq: - q: "Welches Dateigrößenlimit gilt in der WhatsApp-API?" a: "Das hängt vom Typ ab. Metas Dokumentation nennt 5 MB für Bilder, 16 MB für Video und Audio, 100 MB für Dokumente sowie 500 KB für animierte und 100 KB für statische Sticker. Die Obergrenze der Cloud API für Medien liegt bei 100 MB. Limits können sich ändern, prüfen Sie sie daher in Metas aktueller Medien-Referenz, bevor Sie Validierungsregeln bauen." - q: "Welche Dateitypen unterstützt die WhatsApp Business API?" a: "Bilder: JPEG, PNG und statisches WebP. Video: MP4 und 3GPP mit H.264-Video und AAC-Audio. Audio: AAC, AMR, MP3, M4A und Opus-codiertes OGG. Dokumente: TXT, XLS, XLSX, DOC, DOCX, PPT, PPTX und PDF. Sticker: nur WebP. Alles außerhalb dieser Listen wird abgelehnt, konvertieren Sie also vor dem Senden." - q: "Soll ich Medien per Link oder per Media-ID senden?" a: "Metas Dokumentation empfiehlt aus Performance-Gründen eine hochgeladene Media-ID. Ein Link muss auf eine Datei auf einem öffentlichen Server zeigen, die Plattform muss sie also beim Senden abrufen. Eine ID verweist auf eine Datei, die bereits bei Meta liegt. IDs aus einem Upload sind 30 Tage gültig, danach müssen Sie erneut hochladen." - q: "Wie lange ist eine WhatsApp-Media-ID gültig?" a: "Meta nennt 30 Tage für IDs, die Sie beim Hochladen erhalten, und 7 Tage für Media-IDs aus eingehenden Webhooks. Hochgeladene Dateien bleiben 30 Tage erhalten, sofern Sie sie nicht früher löschen. Die Download-URL einer Media-ID läuft nach 5 Minuten ab, fordern Sie daher bei Bedarf eine neue URL an." - q: "Kann ich einem WhatsApp-Bild oder -Video eine Bildunterschrift hinzufügen?" a: "Ja. Metas Nachrichten-Referenz nennt für Bild-, Video- und Dokumentnachrichten eine optionale Bildunterschrift von bis zu 1.024 Zeichen. Audio- und Sticker-Nachrichten haben keine. Brauchen Sie Text zu einem Sticker oder einer Sprachnachricht, senden Sie danach eine separate Textnachricht." - q: "Was bedeutet der WhatsApp-Fehler 131053?" a: "Meta beschreibt ihn so, dass die in der Nachricht verwendete Mediendatei nicht hochgeladen werden konnte. Meist passt der MIME-Typ nicht zur Dateiendung, oder der Typ wird nicht unterstützt. Prüfen Sie die Fehlerdetails im zugehörigen Webhook, gleichen Sie das Format mit Metas unterstützten Medientypen ab und codieren Sie die Datei bei Bedarf neu." sources: - title: "Media — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media" - title: "Image messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/image-messages" - title: "Video messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/video-messages" - title: "Document messages — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/document-messages" - title: "Error codes — WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes" --- # WhatsApp-API-Medien: Dateitypen und Größenlimits im Überblick Canonical: https://omnichannels.ai/de/blog/whatsapp-media-messages-file-types-size-limits/ Language: de Publisher: OmniChannels.ai by BroadNet Technologies Dieser Leitfaden richtet sich an Entwickler und Marketer, die Bilder, Videos, Audiodateien, Dokumente oder Sticker über die WhatsApp Business API senden und fehlgeschlagene Sendungen vermeiden wollen. Er listet die von Meta dokumentierten Dateitypen und Größenlimits auf, erklärt Upload versus Link, Media-IDs, Bildunterschriften und Vorlagen-Header und zeigt, wie Sie Dateien verarbeiten, die Kunden Ihnen schicken. Alle folgenden Zahlen sind Metas dokumentierte Werte zum Redaktionszeitpunkt (7. November 2026). Meta kann sie ändern, behandeln Sie daher die [Medien-Referenz](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media) als maßgebliche Quelle. ## Welche Größenlimits gelten für Medien in der WhatsApp-API? Jeder Medientyp hat eine eigene Obergrenze, und die Obergrenze der Cloud API für jedes Medium liegt bei 100 MB. Dokumente haben den meisten Spielraum, Sticker den geringsten. | Medientyp | Maximale Größe | Hinweise | |---|---|---| | Bild | 5 MB | Nur 8-Bit-RGB oder -RGBA | | Video | 16 MB | H.264-Video, AAC-Audio | | Audio | 16 MB | Mehrere Formate, siehe unten | | Dokument | 100 MB | Office-, PDF- und Textdateien | | Sticker (animiert) | 500 KB | Nur WebP | | Sticker (statisch) | 100 KB | Nur WebP | Eine Datei kann das Größenlimit einhalten und trotzdem am Format scheitern. Die nächsten Abschnitte listen die akzeptierten Formate je Typ auf. ## Welche Bild- und Sticker-Formate werden unterstützt? Bilder können JPEG, PNG oder statisches WebP sein, bis 5 MB, und müssen 8-Bit-RGB oder -RGBA verwenden. Sticker müssen WebP sein. | Typ | Endung | MIME-Typ | |---|---|---| | JPEG | .jpeg | `image/jpeg` | | PNG | .png | `image/png` | | Statisches WebP | .webp | `image/webp` | Meta dokumentiert drei weitere Regeln für Bilder. Ein statisches WebP, das in einer Bildnachricht gesendet wird, wird in JPEG umcodiert. Animierte WebP-Dateien, nicht decodierbare WebP-Dateien und Bilder mit mehr als 4.096 Pixeln an einer Kante werden abgelehnt. Für Sticker verwenden Sie WebP mit `image/webp`: bis 500 KB bei animierten und 100 KB bei statischen. Sind Ihre Markenmotive große PNGs aus einem Design-Tool, exportieren Sie ein JPEG in Web-Größe, statt das Original zu senden. ## Welche Video- und Audioformate werden unterstützt? Video ist MP4 oder 3GPP bis 16 MB. Audio kann AAC, AMR, MP3, M4A oder Opus-codiertes OGG sein, ebenfalls bis 16 MB. | Typ | Endung | MIME-Typ | |---|---|---| | MP4-Video | .mp4 | `video/mp4` | | 3GPP-Video | .3gp | `video/3gpp` | | AAC-Audio | .aac | `audio/aac` | | AMR-Audio | .amr | `audio/amr` | | MP3-Audio | .mp3 | `audio/mpeg` | | MP4-Audio | .m4a | `audio/mp4` | | OGG-Audio | .ogg | `audio/ogg` | Bei Video verlangt Meta den H.264-Codec und AAC-Audio, mit einem einzelnen Audiostream oder keinem. Meta rät außerdem vom H.264-Profil „High" mit B-Frames ab, weil WhatsApp-Clients unter Android es nicht unterstützen; verwenden Sie „Main" ohne B-Frames oder „Baseline". Legen Sie die `moov`-Boxen vor die `mdat`-Boxen, was mit ffmpeg die Option `-movflags faststart` bedeutet. Bei OGG wird nur der Opus-Codec unterstützt, der Basistyp `audio/ogg` nicht, und die Eingabe muss mono sein. ## Welche Dokumentformate werden unterstützt? Dokumente können PDF, Word, Excel, PowerPoint oder Nur-Text sein, bis 100 MB. | Typ | Endung | MIME-Typ | |---|---|---| | PDF | .pdf | `application/pdf` | | Word | .doc, .docx | `application/msword`, `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | | Excel | .xls, .xlsx | `application/vnd.ms-excel`, `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | | PowerPoint | .ppt, .pptx | `application/vnd.ms-powerpoint`, `application/vnd.openxmlformats-officedocument.presentationml.presentation` | | Text | .txt | `text/plain` | Dokumentnachrichten nehmen einen optionalen Dateinamen mit Endung entgegen, und der WhatsApp-Client wählt das Dateisymbol anhand dieser Endung. Wählen Sie einen lesbaren Namen wie `invoice-2026-1042.pdf`, denn der Kunde sieht ihn. ## Soll ich Medien hochladen oder einen Link senden? Meta empfiehlt, die Datei hochzuladen und ihre Media-ID zu senden. Alternativ können Sie einen Link auf eine Datei auf einem öffentlichen Server senden, aber Metas Referenzen zu Bild, Video und Dokument raten aus Performance-Gründen zur hochgeladenen ID, und seine Hinweise zum Durchsatz sagen dasselbe für höhere Volumina. | | Media-ID | Link | |---|---|---| | Funktionsweise | Erst hochladen, dann die zurückgegebene ID verwenden | Auf eine öffentliche URL verweisen; die Datei wird beim Senden abgerufen | | Metas Empfehlung | Empfohlen | Unterstützt, nicht empfohlen | | Gültigkeit | 30 Tage ab Upload | Solange Ihr Server die Datei ausliefert | | Fehlerbild | Abgelaufene oder ungültige ID | Nicht erreichbare, langsame oder falsch typisierte URL | Mit Metas eigenem Endpunkt ist ein Upload ein `POST` an `//media` mit der Datei, ihrem MIME-Typ und `messaging_product=whatsapp`, und die Antwort lautet `{"id": ""}`. Hochgeladene Dateien werden verschlüsselt und 30 Tage aufbewahrt, sofern Sie sie nicht vorher löschen. Am WhatsApp-Endpunkt von OmniChannels.ai nimmt eine Medien-Nachricht entweder `mediaUrl` (eine öffentliche HTTPS-URL) oder `mediaFile` (eine Datei, die Sie mit der Anfrage hochladen), mit der Bildunterschrift in `content`. Siehe die [WhatsApp-API-Dokumentation](/developers/whatsapp/). Fragen Sie unser Team, wie Ihr Konto Medienspeicherung und Wiederverwendung bei großen Sendungen handhabt. ## Wie lange sind Media-IDs gültig? Meta nennt 30 Tage für eine ID aus einem Upload und 7 Tage für eine ID aus einem eingehenden Webhook. Die für eine ID zurückgegebene Download-URL läuft nach 5 Minuten ab. Praktische Folgen: - Cachen Sie eine Media-ID nicht monatelang. Bewahren Sie Ihre Originaldatei auf und laden Sie erneut hoch, wenn eine ID abgelehnt wird. - Laden Sie eingehende Dateien herunter, sobald das Ereignis eintrifft, und behalten Sie eine eigene Kopie. - Speichern Sie nie eine abgerufene Download-URL; fordern Sie bei Bedarf eine neue an. ## Kann ich Medien-Nachrichten Bildunterschriften hinzufügen? Ja. Bild-, Video- und Dokumentnachrichten nehmen laut Metas Nachrichten-Referenzen eine optionale Bildunterschrift von bis zu 1.024 Zeichen entgegen. Bildunterschriften sind reiner Text neben der Datei. Audio- und Sticker-Nachrichten haben in diesem Modell keine Bildunterschrift. Brauchen Sie Worte zu einer Sprachnachricht, senden Sie daneben eine kurze Textnachricht. Innerhalb des [Kundenservice-Fensters](/de/blog/whatsapp-24-hour-customer-service-window/) sind Bildunterschriften frei formulierbar; außerhalb muss das Medium in einer freigegebenen Vorlage mitgesendet werden. ## Wie funktionieren Medien in Nachrichtenvorlagen? Eine Vorlage kann ein Bild, Video oder Dokument im Header haben, und dieser Header wird beim Erstellen der Vorlage festgelegt. Beim Einreichen einer Vorlage zur Freigabe geben Sie eine Beispieldatei an, und beim Senden können Sie die tatsächliche Datei liefern. In unserer API kann `headerFormat` beim Erstellen `IMAGE`, `VIDEO` oder `DOCUMENT` sein, `headerFile` trägt das Beispiel, und `mediaUrl` überschreibt beim Senden das Header-Medium. Die Anforderungen an Beispieldateien finden Sie in Metas Vorlagen-Dokumentation. Siehe [Vorlagenkategorien und Freigabe](/de/blog/whatsapp-template-categories-approval/) und [Vorlagenbeispiele](/de/blog/whatsapp-message-template-examples/). ## Wie lade ich Medien herunter, die ein Kunde sendet? Eingehende Medien kommen als Webhook mit einer Media-ID an; Sie lösen sie in eine URL auf und laden sie mit Autorisierung herunter. 1. Lesen Sie die Media-ID aus dem Ereignis der eingehenden Nachricht. 2. Fordern Sie die Medien-URL für diese ID an. Metas Antwort enthält `url`, `mime_type`, `sha256` und `file_size`. 3. Senden Sie ein `GET` an diese URL mit dem Header `Authorization: Bearer `. Ohne Token schlägt die Anfrage fehl. 4. Prüfen Sie den Header `Content-Type` und den Wert `sha256` und speichern Sie dann die Datei. 5. Bei einem `404` fordern Sie eine neue URL an und wiederholen; schlägt das ebenfalls fehl, erneuern Sie das Zugriffstoken. Metas maximale Größe eingehender Medien in der Cloud API beträgt 100 MB. Eine größere Datei löst einen Webhook mit dem Fehlercode `131052` aus; bitten Sie den Kunden, eine kleinere Datei zu senden oder anders zu teilen. Prüfen Sie jede Datei auf Schadsoftware, bevor Sie sie intern öffnen. Siehe den [Webhook-Leitfaden](/de/blog/whatsapp-webhooks-guide/), und klären Sie mit Ihrem Onboarding-Ingenieur, wie eingehende Medien in Ihrem Konto zugestellt werden. ## Praxisbeispiel: eine Zahnklinik versendet Befunde „Nile Smile Clinic" (fiktiv) in Kairo versendet Terminkarten und Röntgenberichte. 1. Terminkarten sind 300 KB große PNG-Bilder mit einer zweizeiligen Bildunterschrift. Weit unter 5 MB. 2. Behandlungsberichte sind PDFs von 2 bis 8 MB mit dem Namen `report-2026-0381.pdf`, gesendet als Dokumente. 3. Ein 25 MB großes Klinik-Rundgangsvideo ist für Video zu groß. Das Team codiert es als H.264/AAC-MP4 unter 16 MB mit `faststart` neu. 4. Patienten senden Fotos von Rezepten. Das Postfach lädt jede Datei sofort herunter, weil die eingehende ID nach 7 Tagen abläuft. 5. Eine Sprachbegrüßung wird als mono Opus-OGG exportiert, da andere OGG-Varianten abgelehnt werden. ## Welche typischen Fehler gibt es? - **Nur nach der Größe urteilen.** Ein 3-MB-Bild im falschen Farbformat oder ein Video mit falschem Codec scheitert trotzdem. - **MIME-Abweichung.** Eine `.jpg`-Datei, die als `application/octet-stream` ausgeliefert wird, ist eine klassische Ursache für Fehler 131053. - **Link auf eine langsame oder private URL,** etwa einen abgelaufenen signierten Link oder eine Seite hinter einem Login. - **Sich auf eine alte Media-ID verlassen.** IDs laufen nach 30 Tagen ab. - **Ablauf eingehender IDs ignorieren.** Kundendateien müssen innerhalb von 7 Tagen gesichert werden. - **Animiertes WebP als Bild.** Es wird abgelehnt; verwenden Sie einen Sticker oder ein Video. - **Limits ändern sich.** Prüfen Sie Metas Referenz erneut, bevor Sie Validierungen fest verdrahten. ## So hilft OmniChannels.ai OmniChannels.ai sendet WhatsApp-Nachrichten mit Bild, Video, Audio, Dokument und Sticker über eine API, wahlweise mit öffentlichem Link oder hochgeladener Datei und mit Bildunterschrift, und zeigt Medien und Anhänge im gemeinsamen Postfach. BroadNet ist ein offizieller Meta Business Solution Provider, sodass Vorlagen mit Bild-, Video- oder Dokument-Header erstellt und mit ihrem Freigabestatus verfolgt werden können. Lesen Sie die [WhatsApp-API-Dokumentation](/developers/whatsapp/) und [Fehler und Limits](/developers/errors-and-limits/) oder sehen Sie sich den [WhatsApp-Kanal](/de/channels/whatsapp-business-api/) an.