WhatsApp-Nachricht formatieren: fett, kursiv und Listen
Viele Integrationen senden WhatsApp-Nachrichten als einen einzigen Klartextblock: keine Hervorhebung, keine Struktur, nur eine Textwand. Dabei unterstützt WhatsApp selbst einen kleinen Satz an Formatierungszeichen, dieselben, die die App verwendet, wenn ein Kunde sie eintippt. Sie funktionieren identisch, wenn dein Backend sie über die API erzeugt. Unten steht, was möglich ist und wie du es über POST /v1/messages von TextMeFlow anwendest.
Die vier Zeichen, die WhatsApp erkennt
Die Darstellung von WhatsApp sucht im Nachrichtentext nach diesen Markierungen und wandelt sie clientseitig um:
*fett*→ fett_kursiv_→ kursiv~durchgestrichen~→durchgestrichen```monospace```→monospace
Das ist der vollständige Satz. Keine Überschriften, keine Farben, keine Kombinationen (*_fett kursiv_* funktioniert nicht auf jeder WhatsApp-Plattform zuverlässig) und keine Tabellen. Sieh es als leichte Hervorhebung, nicht als Layoutsystem.
Formatierung über die API senden
Die Formatierung steckt einfach im Feld text, es gibt keinen separaten Parameter. Du setzt die Zeichen schlicht um den Text:
curl -X POST https://api.textmeflow.eu/v1/messages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+32470000000",
"text": "Dein Termin ist bestätigt für *Donnerstag, 14:00 Uhr*.\n\n_Bitte sei 10 Minuten vorher da._"
}'
Damit das korrekt dargestellt wird, müssen zwei Dinge stimmen:
- Zeilenumbrüche als
\n. Ein echter Zeilenumbruch in deinem Quellcode muss in JSON als\ngeschrieben werden. Die meisten JSON-Encoder (json_encodein PHP,json.dumpsin Python,JSON.stringifyin Node) erledigen das automatisch, wenn du das Payload als natives Objekt aufbaust, statt einen handgeschriebenen String einzufügen. - Keine URL-Kodierung der Formatierungszeichen.
*und_sind innerhalb eines JSON-Strings gültig und brauchen keine Sonderbehandlung. Sie müssen einfach wörtlich im Feldtextstehen.
Falls du den Basisaufruf noch nicht eingerichtet hast: Die Anleitung für PHP, Python und Node.js deckt den HTTP-Aufruf in allen drei Sprachen ab. Die Formatierung kommt als einfache Ergänzung obendrauf, nicht als eigener Codepfad.
Listen und mehrzeilige Nachrichten aufbauen
Es gibt keine native Aufzählungssyntax, aber \n-Zeilenumbrüche in Kombination mit einem Bindestrich oder einer Zahl werden in der WhatsApp-Oberfläche sauber dargestellt:
{
"to": "+32470000000",
"text": "*Bestellung #4821 — abholbereit*\n\n- 2x Kaffeebohnen (1 kg)\n- 1x Keramikfilter\n- 1x Reinigungsset\n\nAbholstelle schließt um 18:00 Uhr."
}
Das ergibt eine fette Titelzeile gefolgt von einer übersichtlichen Liste: kein HTML, kein Anhang nötig. Für alles, was strukturierter ist als eine kurze Liste (eine detaillierte Rechnung, ein mehrseitiges Dokument), ist ein Anhang die bessere Wahl, als Klartext zu erzwingen. Dafür siehe die Anleitung zum Senden von PDFs und Fotos über die API.
Wofür Formatierung gedacht ist und wofür nicht
Formatierung bringt am meisten bei dem Detail, nach dem ein Empfänger schnell sucht, nicht dadurch, dass du die ganze Nachricht fett setzt:
- Fett für die eine Information, die jemand sucht: ein Datum, eine Bestellnummer, ein offener Betrag.
- Kursiv für eine Nebenbemerkung oder Anweisung, die nicht mit dem Hauptsatz konkurrieren soll.
- Halte den Rest der Nachricht kurz und schlicht lesbar. Übermäßige Formatierung (jedes zweite Wort fett) wirkt wie Spam und untergräbt gerade den Zweck.
Gut zu wissen: WhatsApp erkennt URLs und Telefonnummern im Klartext automatisch und macht sie ohne jede Formatierung von deiner Seite anklickbar. Dafür musst du nichts tun.
Teste, bevor du live gehst
Die Formatierung wird auf den mobilen, Desktop- und Web-Clients von WhatsApp unterschiedlich dargestellt, und ein vereinzeltes * oder _ in dynamischem Inhalt (zum Beispiel ein Kundenname mit Unterstrich) zerstört stillschweigend die Formatierung der restlichen Nachricht, ohne Fehlermeldung. Bevor du eine Vorlage mit variablen Feldern in Produktion nimmst: Sende ein paar Testnachrichten mit realistischen Werten an deine eigene Nummer, auch mit Randfällen wie Namen mit _ oder *, und prüfe, wie sie tatsächlich dargestellt werden. Die API-Referenz enthält die vollständige Feldliste, falls du das in ein Vorlagensystem mit Variablenersetzung einbaust.
Jetzt starten
Formatierung funktioniert in jedem Tarif, auch im kostenlosen. Erstelle ein kostenloses Konto und sende bis zu 50 Nachrichten pro Monat, um zu testen, wie fette Bestellnummern, kursive Hinweise und einfache Listen in deinem eigenen Workflow dargestellt werden, bevor du auf einen kostenpflichtigen Tarif wechselst.
Selbst WhatsApp-Nachrichten per API senden?
Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.
Für immer gratis