Skip to content

WhatsApp-Nachrichten- und Bildformate

Hier finden Sie die Anforderungen an Nachrichtenstruktur, Komponenten und Medien-Assets für die Erstellung von WhatsApp-Nachrichten und -Templates.

Es gibt zwei Arten von WhatsApp-Nachrichten in Braze: Template-Nachrichten und Antwortnachrichten.

Nachrichtentyp Verwendung Meta-Genehmigung
Template-Nachrichten Vom Unternehmen initiierte Kontaktaufnahme; kann jederzeit gesendet werden Erforderlich; Templates müssen bei Meta eingereicht und vor dem Versand genehmigt werden.
Antwortnachrichten Antworten auf von Nutzer:innen initiierte Nachrichten; nur innerhalb des 24-Stunden-Konversationsfensters Nicht erforderlich

Template-Nachrichten müssen zur Genehmigung bei Meta eingereicht werden, was bis zu 24 Stunden dauern kann. Nach der Genehmigung können sie jederzeit gesendet werden. Antwortnachrichten (in der Meta-Dokumentation als „Session Messages“ bezeichnet) können nur gesendet werden, solange ein aktives Konversationsfenster geöffnet ist – innerhalb von 24 Stunden nach der letzten eingehenden Nachricht der Nutzer:innen.

Template-Nachrichten

WhatsApp-Template-Nachrichten sind vorab genehmigte Nachrichtenformate, die für vom Unternehmen initiierte Kontaktaufnahmen verwendet werden. In Braze werden sie aus Komponenten erstellt, die Sie vor der Einreichung bei Meta definieren. Alle Template-Nachrichten sind kategoriebasiert: Marketing, Utility oder Authentifizierung.

Marketing-Templates

Marketing-Templates sind der am häufigsten in Braze verwendete Typ. Sie bestehen aus bis zu vier Komponenten:

Komponente Erforderlich Hinweise
Header Nein Unterstützt Text, Bild, Video, Dokument oder Standort. Siehe Medienspezifikationen für Dateityp-, Größen- und Dimensionsanforderungen.
Body Ja Der Hauptnachrichteninhalt
Footer Nein Ergänzender Text, der unterhalb des Body angezeigt wird
Buttons Nein Bis zu 10 Buttons (alle Button-Typen werden unterstützt)

Zeichenlänge

Komponente Maximale Zeichenlänge
Body 1.024 Zeichen
Footer 60 Zeichen
Button-Beschriftung (URL, Telefon, Schnellantwort) 25 Zeichen
Telefonnummer (im Telefon-Button) 20 Zeichen
Template-Name 512 Zeichen (nur Kleinbuchstaben, alphanumerisch und Unterstriche)

Button-Typen

Button-Typ Verhalten Hinweise
Schnellantwort Sendet den Button-Beschriftungstext als Antwort in der Konversation  
URL Öffnet eine URL im Standardbrowser der Nutzer:innen; unterstützt 1 Variable, die am Ende der URL angehängt wird (max. 2.000 Zeichen) URLs mit Sonderzeichen (wie &, %, <, >) können zu Sendefehlern führen. Verwenden Sie den Liquid-Filter url_param_escape oder url_escape, um URLs mit Sonderzeichen korrekt zu kodieren.
Telefonnummer Initiiert einen Anruf an die angegebene Telefonnummer  
Gutscheincode kopieren Kopiert einen Gutscheincode in die Zwischenablage der Nutzer:innen Erfordert immer eine Meta-Genehmigung

Parameterformatierung

Template-Variablen können entweder benannte Parameter (wie {{first_name}}) oder positionelle Parameter (wie {{1}}) verwenden. In Braze können Variablen durch Liquid oder Klartext ersetzt werden. Geben Sie immer Standardwerte für Liquid-Variablen an; Nachrichten mit fehlenden Variablenwerten werden nicht gesendet.

Templates für zeitlich begrenzte Angebote

Templates für zeitlich begrenzte Angebote zeigen ein zeitkritisches Werbeangebot mit einem optionalen Countdown an, wenn das Angebot sich dem Ablauf nähert. Verwenden Sie dieses Layout für zeitlich begrenzte Aktionen, wie saisonale Verkäufe oder auf ein Nutzer:innen-Attribut personalisierte Angebote.

Komponente Erforderlich Hinweise
Header Nein Wählen Sie Keine oder fügen Sie Medien hinzu (Bild oder Video). Siehe Medienspezifikationen für Dateityp-, Größen- und Dimensionsanforderungen.
Angebotsdetails Ja Angebotstitel, Angebotscode und ein optionales Ablaufdatum.
Body Ja Der Hauptnachrichteninhalt. Unterstützt Liquid.
Footer Nein Ergänzender Text, der nach dem Body angezeigt wird.
Buttons Ja Angebotscode kopieren wird automatisch eingefügt. Sie können einen Website besuchen-Button hinzufügen; andere Button-Typen werden für diesen Template-Typ nicht unterstützt.

Angebotsdetails

Feld Erforderlich Hinweise
Titel Ja Eine kurze Zeile, die das Angebot beschreibt.
Code Ja Der Angebotscode, den Empfänger:innen kopieren. Dieser befüllt automatisch den Button Angebotscode kopieren.
Ablaufdatum Nein Legen Sie ein festes Datum und eine Uhrzeit fest (z. B. ein Enddatum für einen Sommerschlussverkauf) oder personalisieren Sie es basierend auf einem Nutzer:innen-Attribut (z. B. dem Geburtstag jeder Nutzer:in).

Wenn Sie ein Ablaufdatum festlegen, sehen Empfänger:innen einen Countdown in der Nachricht, der sich aktualisiert, wenn das Angebot sich dem Ende nähert. Beispielsweise könnte die Nachricht zunächst das Enddatum anzeigen und dann zu etwas wie „Noch 5 Tage“ wechseln, wenn das Enddatum näher rückt. Wenn Sie kein Ablaufdatum festlegen, wird das Angebot ohne Countdown angezeigt. Braze verhindert den Versand von Nachrichten, wenn das Ablaufdatum in der Vergangenheit liegt (z. B. wenn das Ablaufdatum der 1. November 2026 ist, die Sendezeit aber der 15. November 2026).

Button-Typen

Button-Typ Hinweise
Angebotscode kopieren Wird automatisch eingefügt. Der Button-Text lautet „Copy offer code“ und kann nicht bearbeitet werden.
Website besuchen Der einzige weitere Button, den Sie hinzufügen können. Maximal 1.

Karussell-Templates zeigen einen Nachrichtentext gefolgt von 2–10 horizontal scrollbaren Produktkarten an, die jeweils ein eigenes Medien-Asset und Buttons haben. Sie sind nur für Marketing-Template-Nachrichten verfügbar.

Nachricht auf oberster Ebene

Komponente Erforderlich Maximale Eigenschaften Hinweise
Body-Text Ja 1.024 Zeichen Unterstützt Variablen
Karten Ja 2–10 Karten Die Kartenanzahl wird bei der Template-Erstellung festgelegt. Ein genehmigtes Karussell-Template kann nur mit der exakten Anzahl von Karten gesendet werden, die bei der Erstellung definiert wurde.

Spezifikationen pro Karte

Komponente Erforderlich Hinweise
Header (Bild oder Video) Ja Alle Karten müssen dasselbe Format verwenden (alle Bilder oder alle Videos). Dies schließt dieselbe Komponentenstruktur ein; Sie können keine Karten mit und ohne Body-Text oder Buttons mischen.

Header-Assets der Karten werden automatisch auf ein Breitformat zugeschnitten, basierend auf dem Gerät der Nutzer:innen.
Body-Text Nein Wenn eine Karte Body-Text enthält, müssen alle Karten Body-Text enthalten
Buttons Nein Maximal 2 Buttons pro Karte

Zeichenlängen pro Karte

Komponente Maximale Zeichenlänge Hinweise
Karten-Body-Text 160 Zeichen  
Button-Beschriftung 25 Zeichen  
Telefonnummer (im Telefon-Button) 20 Zeichen  
URL (im URL-Button) 2.000 Zeichen; unterstützt 1 Variable, die am Ende angehängt wird URL-Buttons öffnen sich im Standardbrowser der Nutzer:innen, außerhalb von WhatsApp. Ab diesem Punkt werden keine Bestell- oder Conversion-Webhooks ausgelöst.

Antwortnachrichten

Antwortnachrichten (von Meta auch „Session Messages“ genannt) können nur innerhalb des 24-Stunden-Konversationsfensters gesendet werden. Dieses wird geöffnet und zurückgesetzt, wenn Nutzer:innen Ihrem Unternehmen eine Nachricht senden.

Antwortnachrichten, die direkt im Braze-Campaign- oder Canvas-Editor verfasst werden, erfordern keine Meta-Genehmigung.

Braze unterstützt sieben Antwortnachrichten-Layouts:

Nachrichten-Layout Beschreibung
Text Reiner Body-Text
Medien Nachricht mit einem Bild-, Video-, Audio- oder Dokumentanhang
Schnellantwort Nachricht mit bis zu 3 antippbaren Antwort-Buttons
Call-to-Action (CTA)-Button Nachricht mit einem URL-Button oder Telefonnummer-Button
Listennachricht Nachricht mit einer strukturierten, scrollbaren Liste auswählbarer Optionen
Flow-Nachricht Nachricht, die Nutzer:innen auffordert, ein Formular oder eine interaktive Aufgabe in WhatsApp auszufüllen, wobei die Ausgabe an Braze zurückgegeben wird
Meta-Produktnachricht Nachricht, die ein einzelnes Produkt, mehrere Produkte oder einen gesamten Katalog aus einem verbundenen Meta-Katalog hervorhebt

Listennachricht-Komponenten

Komponente Maximale Eigenschaften
Body-Text 4.096 Zeichen
Button-Beschriftung (zum Öffnen der Liste) 20 Zeichen
Anzahl der Abschnitte Bis zu 10
Anzahl der Zeilen pro Abschnitt Bis zu 10
Abschnittstitel 24 Zeichen
Zeilentitel 24 Zeichen
Zeilenbeschreibung 72 Zeichen

Schnellantwort-Komponenten

Komponente Maximale Eigenschaften
Button Bis zu 3
Button-Beschriftung 20 Zeichen pro Button

Medienspezifikationen

Die folgenden Spezifikationen gelten für alle Medien in WhatsApp-Template-Headern, Antwortnachrichten oder eigenständigen Mediennachrichten.

Bilder

Diese Spezifikationen gelten für Template-Header, Antwort-Mediennachrichten und Bildnachrichten.

Eigenschaft Spezifikationen Anmerkungen
Unterstützte Formate JPEG, PNG Meta unterstützt offiziell nur JPEG und PNG für Bildnachrichten. WebP wird nur für Sticker unterstützt (nicht für Standard-Bildnachrichten).
Maximale Dateigröße 5 MB  
Farbmodus 8-Bit, RGB oder RGBA  
Beschriftung (nur Bildnachrichten) Optional; maximal 1.024 Zeichen  
Empfohlene Abmessungen 1.125 × 600 px Wir empfehlen JPEG- oder PNG-Bilder mit einer Größe von 1.125 × 600 px (1,91:1) für eine konsistente Darstellung auf allen Geräten und die Einhaltung der Meta-Anforderungen.
Empfohlenes Seitenverhältnis 1,91:1 (breit) Quadratische (1:1) und breite (16:9) Formate werden akzeptiert, aber Bilder können je nach Gerät der Nutzer:innen beschnitten oder vergrößert werden.

Bei Karussell-Karten werden Header-Bilder von WhatsApp automatisch auf ein breites Verhältnis zugeschnitten, es sei denn, es gibt keinen Textkörper – in diesem Fall wird das Bild quadratisch dargestellt.

Video

Die folgenden Spezifikationen gelten für Template-Header, Antwort-Mediennachrichten, Videonachrichten und Karussell-Karten-Header.

Eigenschaft Spezifikationen
Unterstützte Formate MP4, 3GPP
Dateigröße Maximal 16 MB
Video-Codec Nur H.264
Audio-Codec Nur AAC
Audio-Streams Einzelner Audio-Stream oder kein Audio-Stream
Beschriftung (nur Videonachrichten) Optional; maximal 1.024 Zeichen
Empfohlenes Seitenverhältnis 1,91:1 (breit)

Android-Kompatibilität

Das H.264-Profil „High“ mit B-Frames wird auf Android-WhatsApp-Clients nicht unterstützt. Verwenden Sie das H.264-Profil „Main“ ohne B-Frames oder das Profil „Baseline“ für die breiteste Kompatibilität. Wenn Sie mit ffmpeg neu kodieren, verwenden Sie das Flag -movflags faststart, um moov-Boxen vor mdat-Boxen zu platzieren.

Audio

Die folgenden Spezifikationen gelten für Antwort-Mediennachrichten und Audio-Nachrichten und basieren auf dem Audio-Typ: Sprachnachricht oder einfache Audio-Nachricht.

Sprachnachricht

Eine Sprachnachricht funktioniert wie eine aufgenommene Sprachnotiz mit Wiedergabesteuerung und Transkriptionsunterstützung.

Eigenschaft Spezifikationen
Erforderliches Format Nur OGG
Erforderlicher Codec Nur OPUS (Mono-Eingang)
Dateigröße Maximal 16 MB
Wiedergabe-Symbol Dieses Symbol wird nur angezeigt, wenn die Datei 512 KB oder kleiner ist; größere Dateien zeigen ein Download-Symbol an
Transkription Wird automatisch angezeigt, wenn Nutzer:innen WhatsApp-Sprachtranskripte aktiviert haben

Einfache Audio-Nachricht

Die folgenden Spezifikationen gelten für das Teilen von Standard-Audio-Dateien (Musikclips, Audio-Werbung und Sounddateien).

Format Erweiterung Maximale Dateigröße Hinweise
AAC .aac 16 MB  
AMR .amr 16 MB  
MP3 .mp3 16 MB  
MP4 Audio .m4a 16 MB  
OGG (OPUS-Codec) .ogg 16 MB OGG-Dateien müssen den OPUS-Codec verwenden. Einfaches audio/ogg ohne OPUS wird nicht unterstützt.

OGG/OPUS-Dateien, die als einfache Audio-Nachrichten gesendet werden, zeigen ein Mikrofon-Symbol (wie bei Sprachnachrichten) anstelle eines Musik-Symbols an.

Hinweise

  • Keine Untertitelunterstützung für Audio-Nachrichten.
  • Ein häufiger Fehler sind nicht übereinstimmende MIME-Typen. Überprüfen Sie, ob der MIME-Typ Ihrer Datei mit der Erweiterung übereinstimmt, bevor Sie sie senden.

Dokumente

Die folgenden Spezifikationen gelten für Template-Header (Dokumentformat), Antwort-Mediennachrichten und Dokumentnachrichten.

Dokumenttyp Dateitypen Maximale Dateigröße
PDF PDF 100 MB
Microsoft Word DOC, DOCX 100 MB
Microsoft Excel XLS, XLSX 100 MB
Microsoft PowerPoint PPT, PPTX 100 MB
Klartext TXT 100 MB

Hinweise

  • Untertitel sind optional und können maximal 1.024 Zeichen lang sein.
  • Der Dateiname ist optional. WhatsApp verwendet die Dateierweiterung, um zu bestimmen, welches Dokumentsymbol in der Konversation angezeigt wird.
  • Nur die aufgeführten Formate werden offiziell unterstützt. Andere Dateitypen können gesendet werden, es wird jedoch nicht garantiert, dass sie in WhatsApp korrekt dargestellt werden.

Kurzreferenz: WhatsApp-Medienspezifikationen

Medientyp Dateitypen Maximale Dateigröße Untertitelverfügbarkeit
Bild JPEG, PNG 5 MB Ja (maximal 1.024 Zeichen)
Video MP4, 3GPP 16 MB Ja (maximal 1.024 Zeichen)
Audio (Sprache) OGG (OPUS) 16 MB Nein
Audio (einfach) AAC, AMR, MP3, M4A, OGG 16 MB Nein
Dokument PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT 100 MB Ja (maximal 1.024 Zeichen)
New Stuff!