> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # Medien in WhatsApp-Vorlagen-Headern: Bilder und Videos > Welche Medienformate und -größen WhatsApp in Vorlagen-Headern akzeptiert, warum YouTube-Links nicht eingebettet werden und wie Medien über Flowella hochgeladen und referenziert werden. Eine WhatsApp-Vorlage kann ein Medium in ihrem Header tragen: ein Bild, ein Video oder ein Dokument. Gut eingesetzt, verdoppelt es die Öffnungs- und Engagement-Raten einer ansonsten reinen Textnachricht. Schlecht eingesetzt — falsches Format, defekte URL, nicht übereinstimmender MIME-Typ — führt es dazu, dass die Sendung fehlschlägt oder die Vorlage amateurhaft aussieht. Diese Seite ist die praktische Referenz für das, was funktioniert, was nicht, und wie Sie die Medien durch Flowella führen. ## Unterstützte Formate und Limits Dies sind die Formate und Größenlimits, die Meta bei Medien in Vorlagen-Headern (und anderswo in WhatsApp Business Platform-Nachrichten) durchsetzt. ### Bilder | Format | Erweiterung | MIME-Typ | Maximale Größe | | - | - | - | - | | JPEG | `.jpeg` / `.jpg` | `image/jpeg` | 5 MB | | PNG | `.png` | `image/png` | 5 MB | Bilder müssen **8-Bit, RGB oder RGBA** sein. WebP wird in Vorlagen-Headern **nicht** akzeptiert (es ist nur in Sticker-Nachrichten gültig, die ein separater Nachrichtentyp sind). **Empfohlene Abmessungen:** Seitenverhältnis 1,91:1, mindestens 800×418 px. Quadratische (1:1) Bilder werden ebenfalls akzeptabel gerendert. Andere Seitenverhältnisse werden vom WhatsApp-Client mit Balken versehen. ### Videos | Format | Erweiterung | MIME-Typ | Maximale Größe | | - | - | - | - | | 3GPP | `.3gp` | `video/3gpp` | 16 MB | | MP4 | `.mp4` | `video/mp4` | 16 MB | Videos müssen den **H.264-Video-Codec** und den **AAC-Audio-Codec** verwenden, mit einem **einzelnen Audiostream oder ohne Audio**. Videos, die mit dem H.264-Profil **„High" und B-Frames** codiert sind, werden von Android-WhatsApp-Clients nicht unterstützt. Codieren (oder re-codieren) Sie mit dem H.264-Profil **„Main" ohne B-Frames** oder dem Profil **„Baseline"** und platzieren Sie `moov`-Boxen vor `mdat`-Boxen für breitere Kompatibilität. Bei ffmpeg übernimmt das Flag `-movflags faststart` die `moov`/`mdat`-Anordnung. ### Dokumente | Format | Erweiterung | MIME-Typ | Maximale Größe | | - | - | - | - | | PDF | `.pdf` | `application/pdf` | 100 MB | | Microsoft Word | `.doc` / `.docx` | `application/msword` / `application/vnd.openxmlformats-officedocument.wordprocessingml.document` | 100 MB | | Microsoft Excel | `.xls` / `.xlsx` | `application/vnd.ms-excel` / `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` | 100 MB | | Microsoft PowerPoint | `.ppt` / `.pptx` | `application/vnd.ms-powerpoint` / `application/vnd.openxmlformats-officedocument.presentationml.presentation` | 100 MB | | Klartext | `.txt` | `text/plain` | 100 MB | PDFs werden geräteübergreifend am zuverlässigsten gerendert. Office-Dokumente funktionieren, erfordern aber, dass der Empfänger eine kompatible App installiert hat; auf einem Nicht-Business-Mobilgerät werden sie in der Regel als Vorschauen geöffnet. ## Was nicht funktioniert Sie können kein YouTube- oder Vimeo-Video in einen Vorlagen-Header einbetten. Der Header muss eine MP4- oder 3GPP-Datei sein, die Meta abrufen und hosten kann. Wenn Sie ein YouTube-Video senden möchten, gibt es zwei Optionen: 1. **Legen Sie den YouTube-Link in den Body oder einen URL-Button.** Ein Tap darauf öffnet die YouTube-App oder den Browser. Die in WhatsApp angezeigte Videovorschau ist ein statisches Miniaturbild. 2. **Laden Sie das Video herunter und laden Sie es als MP4 erneut hoch.** Vorbehaltlich Ihrer Rechte, den Inhalt weiterzuverteilen, was in der Regel bedeutet, dass es Ihr eigenes Video sein muss. Letzteres ist der Weg, um eine tatsächliche In-Konversations-Videovorschau zu erhalten. Animierte GIFs (`.gif`) sind nicht in der unterstützten Liste. WhatsApp konvertiert sie serverseitig, wenn sie peer-to-peer in der Consumer-App geteilt werden, aber die Business Platform tut dies nicht. Codieren Sie das GIF als MP4 neu (das die mobilen Clients von WhatsApp mit Auto-Play und ohne Ton wiedergeben, so wie sie ein GIF anzeigen). WebP-Bilder sind nur für Sticker-Nachrichten gültig, nicht für Vorlagen-Header. Konvertieren Sie sie vor der Verwendung als Header-Bild zu JPEG oder PNG. iPhones speichern Fotos standardmäßig im HEIC-Format, das nicht auf der unterstützten Liste steht. Ändern Sie entweder die iPhone-Einstellung, um in JPEG aufzunehmen, oder konvertieren Sie HEIC vor dem Upload zu JPEG. Ein 6-MB-Bild, ein 18-MB-Video oder eine 110-MB-PDF wird abgelehnt. Komprimieren Sie vor dem Upload. Für Bilder komprimiert der WhatsApp-Client bei der Anzeige auch erneut, sodass ein 4-MB-Foto auf einem Telefonbildschirm nicht wesentlich besser aussehen wird als ein 1-MB-Foto. ## Zwei Möglichkeiten, Medien an eine Vorlage anzuhängen Meta unterstützt zwei Muster, um Medien in eine Vorlage zu bekommen: ### Muster 1: Medien-Handle (empfohlen) Laden Sie die Datei über Metas Medien-API hoch, erhalten Sie ein **Medien-Handle** zurück und referenzieren Sie das Handle, wenn Sie die Vorlage senden. Standardmäßig von Flowella verwendet. Vorteile: * Meta hostet die Datei, sodass es zur Sendezeit keine Fehler durch defekte URLs gibt. * Schnellere Zustellung, weil Meta nicht von einer externen URL abrufen muss. * Funktioniert für die vollen oben aufgeführten Größenlimits. Das Handle ist 30 Tage gültig. Wenn Ihre Vorlage wiederholt mit denselben Medien ausgeht, aktualisiert Flowella das Handle automatisch vor Ablauf. Für DOCUMENT-Header verwendet Flowella auch nach Möglichkeit kürzlich hochgeladene Dokumentmedien erneut, sodass Wiederholungssendungen derselben Vorlage die Datei nicht erneut hochladen müssen. Wenn Meta eine wiederverwendete ID ablehnt, greift Flowella auf erneutes Hochladen zurück. ### Muster 2: Öffentliche HTTPS-URL Geben Sie eine URL zu einer öffentlich zugänglichen Datei an. Meta ruft sie zur Sendezeit ab. Dies ist nützlich, wenn: * Die Medien pro Empfänger variieren (eine personalisierte PDF, ein Versandetikett pro Bestellung). * Die Medien on-the-fly generiert werden und Sie nicht pro Sendung hochladen möchten. Vorbehalte: * Die URL muss **öffentlich erreichbar** (keine Authentifizierung) sein und **HTTPS mit einem gültigen Zertifikat** verwenden. * Wenn die URL einen Fehler zurückgibt oder langsam ist, schlägt die Sendung fehl. * Meta cached die abgerufene Datei eine Weile; das Aktualisieren der Datei an der URL aktualisiert nicht notwendigerweise, was gesendet wird. ## Wie Flowella den Medien-Upload handhabt Für die meisten Anwendungsfälle verwaltet Flowella das Medien-Handle für Sie: Wählen Sie in **Vorlagen → Erstellen** **Bild**, **Video** oder **Dokument** als Header-Typ und **ziehen Sie die Datei auf die gestrichelte Upload-Zone** oder klicken Sie darauf, um zu durchsuchen. Drag-and-Drop funktioniert für alle drei Header-Typen und verwendet denselben Upload-Pfad wie das Klicken. Für **Dokument**-Header zeigt der Editor auch ein Feld **Dokument-Dateiname**, das standardmäßig aus der hochgeladenen Datei stammt — bearbeiten Sie es, um den Namen zu steuern, den Empfänger auf der WhatsApp-Dokumentblase sehen. Format, Größe und MIME-Typ werden vor der Übermittlung überprüft. Wenn Sie eine nicht unterstützte Datei ablegen oder auswählen, teilt Ihnen ein Toast sofort mit, was falsch ist (falscher Typ oder über dem Größenlimit), anstatt zu warten, bis Meta die Vorlage ablehnt. Die Datei wird über Metas Medien-API hochgeladen. Das zurückgegebene Handle wird gegen die Vorlage gespeichert. Wenn die Vorlage zur Genehmigung eingereicht wird, sieht Meta die tatsächlichen Medien (keine URL), sodass der Überprüfungsprozess die Bilder als Teil der Genehmigung bewerten kann. Bis sich die Header-Medien der Vorlage ändern, verwendet jede Sendung dasselbe Handle. Handles werden vor Ablauf automatisch aktualisiert. Für DOCUMENT-Header wird der von Ihnen im Editor festgelegte **Dokument-Dateiname** mit dem Entwurf persistiert, durch Metas Genehmigung und Veröffentlichung getragen und bei jeder Sendung verwendet — HubSpot-Workflow-Sendungen, Testsendungen, Massensendungen und Posteingangs-Sendungen zeigen alle Ihren Dateinamen anstelle des internen Namens der Vorlage. Wenn Sie **Vorlagen → Duplizieren** verwenden, kopiert Flowella die Header-Datei und den **Dokument-Dateinamen** in den neuen Entwurf. Wenn die Kopie fehlschlägt, zeigt der Editor eine Warnung und blockiert die Veröffentlichung, bis Sie die Datei erneut hochladen. Für Medien pro Empfänger (personalisierte PDFs, Versandetiketten) verwenden Sie die Option **Öffentliche URL** im Vorlagen-Builder und übergeben die URL als Variable, wenn Sie die Sendung von einem Workflow oder der API auslösen. Siehe [Workflow-Aktionen](/de/hubspot/workflow-actions). ## Design für den WhatsApp-Viewport Einige Designhinweise, die nicht in Metas Spezifikation erscheinen, aber in der Praxis wichtig sind: * **Text auf Bildern.** Halten Sie ihn groß und kontrastreich. WhatsApp zeigt das Bild in etwa der Breite eines Mobilbildschirms an, sodass alles kleiner als etwa 14 px unleserlich gerendert wird. * **Sicherer Bereich.** WhatsApp kann zuschneiden oder mit Balken versehen; halten Sie kritische Inhalte im mittleren 80 % des Bildes. * **Markenkonsistenz.** Das Header-Bild und der WhatsApp-Anzeigename und das Profilbild stehen nahe beieinander — halten Sie sie visuell konsistent. * **Erster Frame eines Videos.** WhatsApp verwendet den ersten Frame als Standbildvorschau, bevor das Video abgespielt wird. Beginnen Sie nicht mit einem schwarzen Frame oder einem Corporate-Logo-Splash; starten Sie mit einem aussagekräftigen Bild. * **Dokument-Dateiname.** Beim Senden einer PDF oder eines anderen Dokuments ist der **Dateiname** für den Empfänger auf der WhatsApp-Dokumentblase sichtbar. Der Vorlagen-Editor stellt ein Feld **Dokument-Dateiname** unter dem DOCUMENT-Header-Upload zur Verfügung; es wird standardmäßig aus dem Namen der hochgeladenen Datei gefüllt und ist das, was Empfänger tatsächlich sehen, wenn die Vorlage gesendet wird. Verwenden Sie einen klaren, beschreibenden Namen wie `Acme-Bestellung-12345-Beleg.pdf`, nicht `anhang.pdf` oder den Meta-CDN-Objektnamen. ## Häufige Fehler und Korrekturen Der tatsächliche MIME-Typ der Datei entspricht nicht dem deklarierten. Passiert oft, wenn ein vom iPhone exportiertes „JPEG" tatsächlich HEIC ist oder wenn ein Tool ein `.docx` in `.pdf` umbenennt, ohne zu konvertieren. Korrektur: Untersuchen Sie die Datei (unter macOS/Linux: `file -I yourfile.png`) und exportieren Sie sie entweder im richtigen Format erneut oder ändern Sie die Erweiterung entsprechend. Der Audio-Codec ist etwas anderes als AAC oder es gibt mehrere Audiostreams. Korrektur: Codieren Sie erneut mit `ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4`. Codiert mit H.264 High-Profil und B-Frames. Codieren Sie mit Main- oder Baseline-Profil neu. Meta kann die URL nicht erreichen. Häufige Ursachen: Die URL erfordert Authentifizierung, das Zertifikat ist ungültig, der Server ist langsam bei der Antwort (Timeout) oder die URL gibt eine Umleitung anstelle der Datei zurück. Korrektur: Testen Sie die URL mit `curl -I`, um zu bestätigen, dass sie 200 mit dem richtigen Inhaltstyp zurückgibt und das Zertifikat validiert. Dann erneut versuchen. Die Quelle ist niedrig aufgelöst oder wurde hochskaliert. WhatsApp verarbeitet nicht neu für Schärfe; was Sie hochladen, wird angezeigt. Korrektur: Laden Sie mindestens 800 px an der langen Kante für ein 1,91:1-Bild hoch und skalieren Sie eine kleine Quelle nicht hoch. ## Verwandte Anleitungen * [Vorlagen-Referenz](/de/app/template-reference) — die vollständige Vorlagenstruktur, in die diese Medien passen * [Vorlagen](/de/app/templates) — Schritt-für-Schritt-Vorlagenerstellung in Flowella * [Workflow-Aktionen](/de/hubspot/workflow-actions) — Weitergabe von Medien-URLs pro Empfänger durch HubSpot-Workflows This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.