WhatsApp-Formatierung per API: fett, kursiv, Listen
Die meisten API-Integrationen senden WhatsApp-Nachrichten als einen flachen String, und das Ergebnis wirkt wie eine Textwand: keine Betonung, keine Struktur, keine visuelle Hierarchie. WhatsApp unterstützt tatsächlich eine kleine Menge an Formatierungszeichen, dieselben, die die App selbst verwendet, und sie funktionieren identisch, ob ein Mensch sie tippt oder dein Backend sie erzeugt. Hier steht, was verfügbar ist und wie du es über den Endpunkt POST /v1/messages von TextMeFlow nutzt.
Die vier Zeichen, die WhatsApp versteht
Der Renderer von WhatsApp sucht diese Markierungen im Nachrichtentext und wandelt sie clientseitig um:
*fett*→ fett_kursiv_→ kursiv~durchgestrichen~→durchgestrichen```monospace```→monospace
Das ist der gesamte Umfang. Es gibt keine Überschriften-Syntax, keinen farbigen Text, keine verschachtelte Formatierung (*_fett kursiv_* funktioniert nicht zuverlässig in allen WhatsApp-Clients) und keine Tabellen. Sieh es als leichte Betonung, nicht als Layout-System.
Senden über die API
Die Formatierung steckt komplett im Feld text: Es gibt keinen separaten Parameter dafür. Du nimmst die Markierungszeichen einfach in den String auf:
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 komm 10 Minuten früher._"
}'
Zwei Dinge sind wichtig, damit diese Anfrage korrekt dargestellt wird:
- Escape den Backslash richtig. In JSON muss ein echter Zeilenumbruch im Body als
\ngeschrieben werden, nicht als tatsächlicher Zeilenumbruch in deinem Quell-String. Die meisten JSON-Encoder (json_encodein PHP,json.dumpsin Python,JSON.stringifyin Node) erledigen das automatisch, wenn du den Payload als natives Objekt aufbaust, statt einen rohen JSON-String von Hand zusammenzusetzen. - Kodiere die Markdown-Zeichen nicht als URL.
*und_sind in einem JSON-String gültig und brauchen keine Sonderbehandlung: Sorge nur dafür, dass sie unverändert im Feldtextlanden.
Falls du die Basisanfrage noch nicht aufgesetzt hast: Der Versandleitfaden für PHP/Python/Node.js behandelt den HTTP-Aufruf in allen drei Sprachen. Formatierung lässt sich in jedes dieser Beispiele einfach einfügen und ist kein anderer Codepfad.
Listen und mehrzeilige Nachrichten
Eine native Aufzählungssyntax gibt es nicht, aber \n-Zeilenumbrüche mit einem vorangestellten Strich oder einer Zahl lesen sich in der WhatsApp-Oberfläche sauber:
{
"to": "+32470000000",
"text": "*Bestellung #4821 — abholbereit*\n\n- 2x Espressobohnen (1 kg)\n- 1x Keramikfilter\n- 1x Reinigungsset\n\nDie Abholstelle schließt um 18:00 Uhr."
}
Das wird als fette Kopfzeile mit einer sauberen Liste darunter dargestellt: kein HTML, keine Anhänge nötig. Für alles, was strukturierter ist als eine kurze Liste (eine detaillierte Rechnung, ein mehrseitiges Dokument), ist ein Dateianhang besser, als es in Klartext zu pressen. Dazu gibt es den Leitfaden zum Senden von PDFs und Fotos über die API.
Wofür Formatierung gut ist (und wofür nicht)
Formatierung lohnt sich bei den Details, die ein Empfänger schnell erfassen soll, nicht dafür, die ganze Nachricht fett zu setzen:
- Setze die eine Angabe fett, nach der jemand sucht: ein Datum, eine Bestellnummer, einen fälligen Betrag.
- Nutze kursiv für einen Nebenhinweis oder eine Anweisung, die nicht mit der Hauptzeile konkurrieren soll.
- Halte den Rest der Nachricht in schlichten, kurzen Sätzen. Übertriebene Formatierung (jedes zweite Wort fett) wirkt wie Spam und verfehlt den Zweck.
Gut zu wissen: WhatsApp erkennt URLs und Telefonnummern im Klartext automatisch und macht sie antippbar, ganz ohne Markup von deiner Seite. Du musst nichts Besonderes tun, damit ein Link klickbar ist, füge ihn einfach als normalen Text ein.
Vor dem Livegang testen
Formatierung wird in 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 die Formatierung für den Rest der Nachricht stillschweigend, statt einen Fehler zu werfen. Bevor du eine Vorlage in Produktion nimmst, sende ein paar Testnachrichten an deine eigene Nummer mit realistischen dynamischen Werten, auch mit Grenzfä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.
Probiere es aus
Formatierung funktioniert in jedem Tarif, auch im kostenlosen: Registriere dich kostenlos und sende bis zu 50 Nachrichten pro Monat, um zu sehen, wie fette Bestellnummern, kursive Hinweise und einfache Listen in deinem eigenen Workflow aussehen, bevor du dich auf etwas Kostenpflichtiges festlegst.
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