WhatsApp-berichten opmaken via de API — vetgedrukt, cursief en lijsten

Veel integraties sturen WhatsApp-berichten als één platte tekstblok: geen nadruk, geen structuur, gewoon een muur van tekst. Terwijl WhatsApp zelf een klein setje opmaaktekens ondersteunt — dezelfde die de app gebruikt als een klant ze intypt. Ze werken identiek wanneer je backend ze genereert via de API. Hieronder wat er kan, en hoe je het toepast via TextMeFlow's POST /v1/messages.

De vier tekens die WhatsApp herkent

WhatsApp's weergave zoekt naar deze markeringen in de berichttekst en zet ze client-side om:

• *vet* → vet
• _cursief_ → cursief
• ~doorstreept~ → doorstreept
• ```monospace``` → monospace

Dat is de volledige set. Geen kopjes, geen kleuren, geen combinaties (*_vet cursief_* werkt niet betrouwbaar op elk WhatsApp-platform) en geen tabellen. Zie het als lichte nadruk, geen layoutsysteem.

Opmaak versturen via de API

De opmaak zit gewoon in het text-veld — er is geen apart parameter voor. Je zet de tekens gewoon tussen de tekst:

curl -X POST https://api.textmeflow.eu/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+32470000000",
    "text": "Je afspraak is bevestigd voor *donderdag 14u00*.\n\n_Gelieve 10 minuten op voorhand aanwezig te zijn._"
  }'

Twee dingen moeten kloppen om dit correct te laten renderen:

1. Regeleinden als \n. Een letterlijke nieuwe lijn in je broncode moet in JSON als \n worden geschreven. De meeste JSON-encoders (json_encode in PHP, json.dumps in Python, JSON.stringify in Node) doen dit automatisch als je het payload als een native object opbouwt, en niet als handgeschreven string plakt.
2. Geen URL-encoding op de opmaaktekens. * en _ zijn geldig binnen een JSON-string en hebben geen speciale behandeling nodig — ze moeten gewoon letterlijk in het text-veld staan.

Als je de basisaanroep nog niet hebt staan, dekt de handleiding voor PHP, Python en Node.js de HTTP-call in alle drie de talen af — opmaak is daarbovenop een eenvoudige toevoeging, geen apart code-pad.

Lijsten en meerdere regels opbouwen

Er is geen native bullet-syntax, maar \n-regeleinden gecombineerd met een streepje of cijfer tonen netjes in de WhatsApp-interface:

{
  "to": "+32470000000",
  "text": "*Bestelling #4821 — klaar om af te halen*\n\n- 2x Koffiebonen (1kg)\n- 1x Keramisch filter\n- 1x Reinigingsset\n\nAfhaalpunt sluit om 18u00."
}

Dat geeft een vetgedrukte titelregel gevolgd door een duidelijke lijst — geen HTML, geen bijlage nodig. Voor iets dat structureler is dan een korte lijst (een gedetailleerde factuur, een document van meerdere pagina's), is een bijlage een betere keuze dan platte tekst forceren — zie de gids voor het versturen van PDF's en foto's via de API daarvoor.

Waarvoor opmaak wél en niet dient

Opmaak levert het meest op bij het detail waar een ontvanger snel naar zoekt, niet door het hele bericht vet te maken:

• Vet voor het ene feit dat iemand zoekt: een datum, een bestelnummer, een openstaand bedrag.
• Cursief voor een bijkomende opmerking of instructie die niet moet concurreren met de hoofdzin.
• Houd de rest van het bericht kort en gewoon leesbaar. Overmatige opmaak (elk ander woord vet maken) leest als spam en ondermijnt net het doel.

Ook handig om te weten: WhatsApp herkent URL's en telefoonnummers automatisch in platte tekst en maakt ze klikbaar zonder enige opmaak van jouw kant — je moet daar zelf niets voor doen.

Test voordat je live gaat

Opmaak rendert verschillend op WhatsApp's mobiele, desktop- en weblienten, en een los * of _ teken in dynamische content (bijvoorbeeld een klantnaam met een underscore erin) breekt de opmaak van de rest van het bericht stilletjes, zonder foutmelding. Voordat je een template met variabele velden in productie zet: stuur een paar testberichten naar je eigen nummer met realistische waarden — inclusief randgevallen zoals namen met _ of * — en controleer hoe ze effectief renderen. De API-referentie heeft de volledige veldenlijst als je dit inbouwt in een templatesysteem met variabele substitutie.

Aan de slag

Opmaak werkt op elk plan, ook het gratis plan. Maak een gratis account aan en verstuur tot 50 berichten per maand om te testen hoe vetgedrukte bestelnummers, cursieve notities en eenvoudige lijstjes renderen in jouw eigen workflow, voordat je overstapt naar een betaald plan.