Zum Hauptinhalt springen
Eine WhatsApp-Vorlage kann in ihrer Kopfzeile ein Medium enthalten: ein Bild, ein Video oder ein Dokument. Wenn sie gut verwendet wird, verdoppelt sie die Öffnungs- und Engagement-Raten einer ansonsten reinen Textnachricht. Bei falscher Verwendung - falsches Format, fehlerhafte URL, nicht passender MIME-Typ - schlägt der Versand fehl oder die Vorlage wirkt amateurhaft. Diese Seite ist die praktische Referenz dafür, was funktioniert, was nicht funktioniert und wie Sie die Medien mit Flowella ausloten können.

​
Unterstützte Formate und Grenzen

Dies sind die Formate und Größenbeschränkungen, die Meta für Medien in Kopfzeilen von Vorlagen (und an anderen Stellen in WhatsApp Business Platform-Nachrichten) durchsetzt.

​
Bilder

FormatErweiterungMIME-TypMaximale Größe
JPEG.jpeg / .jpgimage/jpeg5 MB
PNG.pngimage/png5 MB
Die Bilder müssen 8-bit, RGB oder RGBA sein. WebP wird nicht in Kopfzeilen von Vorlagen akzeptiert (es ist nur in Aufkleber-Nachrichten gültig, die ein separater Nachrichtentyp sind). Empfohlene Abmessungen: Seitenverhältnis 1,91:1, mindestens 800×418 px. Auch quadratische (1:1) Bilder werden akzeptabel wiedergegeben. Andere Seitenverhältnisse werden vom WhatsApp-Client im Letterbox-Format dargestellt.

​
Videos

FormatErweiterungMIME-TypMaximale Größe
3GPP.3gpvideo/3gpp16 MB
MP4.mp4video/mp416 MB
Die Videos müssen den H.264 Videocodec und den AAC Audiocodec verwenden, mit einem einzelnen Audiostream oder ohne Audio.
Videos, die mit dem H.264-Profil “Hoch” und B-Frames kodiert sind, werden von Android WhatsApp-Clients nicht unterstützt. Kodieren Sie (oder kodieren Sie erneut) mit dem H.264 “Main”-Profil ohne B-Frames oder dem “Baseline”-Profil, und platzieren Sie moov-Boxen vor mdat-Boxen, um eine breitere Kompatibilität zu erreichen.Wenn Sie ffmpeg verwenden, übernimmt das -movflags faststart-Flag die moov/mdat-Reihenfolge.

​
Dokumente

FormatErweiterungMIME-TypMaximale Größe
PDF.pdfapplication/pdf100 MB
Microsoft Word.doc / .docxapplication/msword / application/vnd.openxmlformats-officedocument.wordprocessingml.document100 MB
Microsoft Excel.xls / .xlsxapplication/vnd.ms-excel / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet100 MB
Microsoft PowerPoint.ppt / .pptxapplication/vnd.ms-powerpoint / application/vnd.openxmlformats-officedocument.presentationml.presentation100 MB
Klartext.txttext/plain100 MB
PDFs werden auf allen Geräten am zuverlässigsten wiedergegeben. Office-Dokumente funktionieren, erfordern aber, dass der Empfänger eine kompatible App installiert hat; auf einem nicht geschäftlich genutzten Handy öffnen sie sich in der Regel als Vorschaubilder.

​
Was nicht funktioniert

Sie können kein YouTube- oder Vimeo-Video in einen Vorlagenheader einbetten. Der Header muss eine MP4- oder 3GPP-Datei sein, die Meta abrufen und hosten kann.Wenn Sie ein YouTube-Video senden möchten, haben Sie zwei Möglichkeiten:
  1. Fügen Sie den YouTube-Link in den Textkörper oder eine URL-Schaltfläche ein. Wenn Sie darauf tippen, öffnet sich die YouTube-App oder der Browser. Die in WhatsApp angezeigte Videovorschau ist eine statische Miniaturansicht.
  2. Laden Sie das Video herunter und laden Sie es als MP4 erneut hoch. Vorbehaltlich Ihrer Rechte zur Weiterverbreitung des Inhalts, was in der Regel bedeutet, dass es sich um Ihr eigenes Video handeln muss.
Letzteres ist der Weg, um eine tatsächliche Videovorschau im Gespräch zu erhalten.
Animierte GIFs (.gif) sind nicht in der unterstützten Liste enthalten. WhatsApp konvertiert sie serverseitig, wenn sie in der Verbraucher-App Peer-to-Peer geteilt werden, aber die Business Platform tut dies nicht. Kodieren Sie das GIF erneut als MP4 (das die mobilen Clients von WhatsApp mit automatischer Wiedergabe und ohne Ton abspielen, genauso wie sie ein GIF anzeigen).
WebP-Bilder sind nur für Aufkleber gültig, nicht für Kopfzeilen von Vorlagen. Konvertieren Sie sie in JPEG oder PNG, bevor Sie sie als Kopfzeilenbild verwenden.
iPhones speichern Fotos standardmäßig im HEIC-Format, das nicht in der Liste der unterstützten Formate enthalten ist. Ändern Sie entweder die iPhone-Einstellung so, dass die Fotos im JPEG-Format gespeichert werden, oder konvertieren Sie HEIC vor dem Hochladen in JPEG.
Ein 6 MB großes Bild, ein 18 MB großes Video oder ein 110 MB großes PDF wird abgelehnt. Komprimieren Sie vor dem Hochladen. Bei Bildern komprimiert der WhatsApp-Client auch bei der Anzeige neu, so dass ein 4 MB großes Foto auf einem Telefonbildschirm nicht wesentlich besser aussieht als ein 1 MB großes.

​
Zwei Möglichkeiten, Medien an eine Vorlage anzuhängen

Meta unterstützt zwei Muster, um Medien in eine Vorlage zu bringen:

​
Muster 1: Medien-Handle (empfohlen)

Laden Sie die Datei über die Medien-API von Meta hoch, erhalten Sie ein Medien-Handle zurück und referenzieren Sie das Handle, wenn Sie die Vorlage senden. Wird standardmäßig von Flowella verwendet. Vorteile:
  • Meta hostet die Datei, so dass es beim Senden nicht zu Fehlern bei den URLs kommt.
  • Schnellere Zustellung, da Meta die Datei nicht von einer externen URL abrufen muss.
  • Funktioniert bei den oben genannten Größenbeschränkungen.
Das Handle ist 30 Tage lang gültig. Wenn Ihre Vorlage wiederholt mit denselben Medien verschickt wird, aktualisiert Flowella das Handle automatisch, bevor es abläuft.

​
Muster 2: Öffentliche HTTPS-URL

Geben Sie eine URL zu einer öffentlich zugänglichen Datei an. Meta holt sie zum Zeitpunkt des Versands ab. Dies ist nützlich, wenn:
  • Die Medien ändern sich pro Empfänger (ein personalisiertes PDF, ein Versandetikett pro Bestellung).
  • Die Medien werden spontan erstellt und Sie möchten sie nicht pro Sendung hochladen.
Vorbehalte:
  • Die URL muss öffentlich erreichbar sein (keine Authentifizierung) und HTTPS mit einem gültigen Zertifikat verwenden.
  • Wenn die URL einen Fehler zurückgibt oder langsam ist, schlägt das Senden fehl.
  • Meta speichert die abgerufene Datei eine Zeit lang im Cache. Eine Aktualisierung der Datei an der URL führt nicht unbedingt zu einer Aktualisierung der gesendeten Daten.

​
Wie Flowella den Medien-Upload behandelt

Für die meisten Anwendungsfälle verwaltet Flowella das Medien-Handle für Sie:
1

Fügen Sie beim Erstellen der Vorlage eine Header-Mediendatei hinzu

Wählen Sie unter Vorlagen → Erstellen als Kopftyp Bild, Video oder Dokument und ziehen Sie dann die Datei in den Upload-Bereich.
2

Flowella validiert die Datei

Format, Größe und MIME-Typ werden vor dem Absenden geprüft. Wenn die Datei nicht unterstützt wird, erhalten Sie sofort eine Fehlermeldung und müssen nicht warten, bis Meta die Vorlage ablehnt.
3

Flowella lädt zu Meta hoch und speichert das Handle

Die Datei wird über die Medien-API von Meta hochgeladen. Das zurückgegebene Handle wird in der Vorlage gespeichert.
4

Die Vorlage enthält den Griff

Wenn die Vorlage zur Genehmigung eingereicht wird, sieht Meta die tatsächlichen Medien (keine URL), so dass der Überprüfungsprozess das Bildmaterial im Rahmen der Genehmigung bewerten kann.
5

Sendet die Wiederverwendung des gleichen Handles

Solange sich die Kopfzeilenmedien der Vorlage nicht ändern, wird für jede Sendung dasselbe Handle verwendet. Die Handles werden vor Ablauf der Gültigkeit automatisch erneuert.
Für Medien pro Empfänger (personalisierte PDFs, Versandetiketten) verwenden Sie die Option Öffentliche URL in der Vorlagenerstellung und übergeben die URL als Variable, wenn Sie den Versand über einen Workflow oder die API auslösen. Siehe Workflow-Aktionen.

​
Entwerfen für das WhatsApp Ansichtsfenster

Ein paar Design-Hinweise, die nicht in der Spezifikation von Meta enthalten sind, aber in der Praxis wichtig sind:
  • Text auf Bildern. Halten Sie ihn groß und kontrastreich. WhatsApp zeigt das Bild ungefähr in der Breite eines mobilen Bildschirms an, so dass alles, was kleiner als 14 px ist, unlesbar wird.
  • Sicherer Bereich. WhatsApp kann zuschneiden oder Letterboxen erstellen; halten Sie kritische Inhalte in der Mitte von 80% des Bildes.
  • Markenkonsistenz. Das Header-Bild, der WhatsApp-Anzeigename und das Profilfoto liegen alle dicht 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 Rahmen oder einem Firmenlogo-Splash; beginnen Sie mit einem aussagekräftigen Bild.
  • Dateiname des Dokuments. Wenn Sie ein PDF oder ein anderes Dokument versenden, ist der Dateiname für den Empfänger sichtbar. Verwenden Sie einen klaren, beschreibenden Namen wie Acme-Order-12345-Receipt.pdf, nicht attachment.pdf.

​
Häufige Fehler und Korrekturen

Der tatsächliche MIME-Typ der Datei stimmt nicht mit dem deklarierten Typ überein. Das passiert oft, wenn ein vom iPhone exportiertes “JPEG” in Wirklichkeit HEIC ist oder wenn ein Tool ein .docx in .pdf umbenennt, ohne es zu konvertieren.Abhilfe: Überprüfen 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 Audiocodec ist ein anderer als AAC oder es gibt mehrere Audioströme.Abhilfe: Kodieren Sie neu mit ffmpeg -i input.mp4 -c:v libx264 -profile:v main -c:a aac -movflags faststart output.mp4.
Kodiert mit H.264 High-Profil und B-Frames. Kodieren Sie erneut mit Main oder Baseline Profil.
Meta kann die URL nicht erreichen. Häufige Ursachen: Die URL erfordert eine Authentifizierung, das Zertifikat ist ungültig, der Server antwortet nur langsam (Timeout) oder die URL gibt eine Weiterleitung statt der Datei zurück.Lösung: Testen Sie die URL mit curl -I, um sicherzustellen, dass 200 mit dem richtigen Inhaltstyp zurückgegeben wird und dass das Zertifikat gültig ist. Versuchen Sie es dann erneut.
Die Quelle ist niedrig aufgelöst oder wurde hochskaliert. WhatsApp führt keine erneute Schärfung durch; das, was Sie hochladen, wird auch angezeigt.Abhilfe: Laden Sie mindestens 800 px an der langen Kante hoch, um ein Bild im Verhältnis 1,91:1 zu erhalten, und skalieren Sie eine kleine Quelle nicht hoch.

​
Verwandte Anleitungen

  • Vorlagenreferenz - die vollständige Vorlagenstruktur, in die sich dieses Medium einfügt
  • Vorlagen - Schritt-für-Schritt-Vorlagenerstellung in Flowella
  • Workflow-Aktionen - Weitergabe von Medien-URLs pro Empfänger durch HubSpot-Workflows