Mettre en forme un message WhatsApp : gras, italique, listes
Beaucoup d'intégrations envoient les messages WhatsApp comme un seul bloc de texte brut : aucune mise en valeur, aucune structure, juste un pavé. Pourtant, WhatsApp prend lui-même en charge un petit jeu de caractères de mise en forme, les mêmes que ceux que l'application utilise quand un client les saisit. Ils fonctionnent à l'identique lorsque votre backend les génère via l'API. Voici ce qui est possible et comment l'appliquer via POST /v1/messages de TextMeFlow.
Les quatre caractères que WhatsApp reconnaît
L'affichage de WhatsApp recherche ces marqueurs dans le texte du message et les convertit côté client :
*gras*→ gras_italique_→ italique~barré~→barré```monospace```→monospace
C'est l'ensemble complet. Pas de titres, pas de couleurs, pas de combinaisons (*_gras italique_* ne fonctionne pas de façon fiable sur toutes les plateformes WhatsApp) et pas de tableaux. Voyez-y une mise en valeur légère, pas un système de mise en page.
Envoyer une mise en forme via l'API
La mise en forme se trouve simplement dans le champ text, il n'existe pas de paramètre distinct. Il suffit de placer les caractères autour du texte :
curl -X POST https://api.textmeflow.eu/v1/messages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+32470000000",
"text": "Votre rendez-vous est confirmé pour *jeudi 14 h 00*.\n\n_Merci d’arriver 10 minutes avant._"
}'
Deux conditions doivent être réunies pour que l'affichage soit correct :
- Sauts de ligne sous forme de
\n. Un vrai retour à la ligne dans votre code source doit être écrit\nen JSON. La plupart des encodeurs JSON (json_encodeen PHP,json.dumpsen Python,JSON.stringifyen Node) le font automatiquement si vous construisez le payload comme un objet natif au lieu de coller une chaîne écrite à la main. - Pas d'encodage URL sur les caractères de mise en forme.
*et_sont valides dans une chaîne JSON et n'exigent aucun traitement particulier : ils doivent simplement figurer tels quels dans le champtext.
Si vous n'avez pas encore l'appel de base en place, le guide pour PHP, Python et Node.js couvre l'appel HTTP dans les trois langages. La mise en forme s'y ajoute simplement, ce n'est pas un chemin de code distinct.
Construire des listes et des messages sur plusieurs lignes
Il n'existe pas de syntaxe native pour les puces, mais des sauts de ligne \n combinés à un tiret ou à un chiffre s'affichent proprement dans l'interface WhatsApp :
{
"to": "+32470000000",
"text": "*Commande n°4821 — prête à retirer*\n\n- 2x Café en grains (1 kg)\n- 1x Filtre en céramique\n- 1x Kit de nettoyage\n\nLe point de retrait ferme à 18 h 00."
}
Vous obtenez une ligne de titre en gras suivie d'une liste claire : pas de HTML, pas de pièce jointe nécessaire. Pour tout ce qui est plus structuré qu'une courte liste (une facture détaillée, un document de plusieurs pages), une pièce jointe vaut mieux que de forcer le texte brut. Voir le guide pour envoyer PDF et photos via l'API.
À quoi sert la mise en forme, et à quoi elle ne sert pas
La mise en forme rapporte le plus sur le détail que le destinataire cherche du regard, pas en mettant tout le message en gras :
- Gras pour le seul fait que l'on cherche : une date, un numéro de commande, un montant dû.
- Italique pour une remarque ou une consigne secondaire qui ne doit pas concurrencer la phrase principale.
- Gardez le reste du message court et simplement lisible. Une mise en forme excessive (un mot sur deux en gras) fait penser à du spam et va à l'encontre du but.
Bon à savoir aussi : WhatsApp reconnaît automatiquement les URL et les numéros de téléphone dans le texte brut et les rend cliquables sans aucune mise en forme de votre part. Vous n'avez rien à faire pour cela.
Testez avant la mise en production
La mise en forme s'affiche différemment sur les clients WhatsApp mobile, bureau et web, et un * ou un _ isolé dans un contenu dynamique (par exemple un nom de client contenant un tiret bas) casse silencieusement la mise en forme du reste du message, sans aucune erreur. Avant de mettre en production un modèle comportant des champs variables, envoyez quelques messages de test à votre propre numéro avec des valeurs réalistes, y compris des cas limites comme des noms contenant _ ou *, et vérifiez leur rendu réel. La référence de l'API contient la liste complète des champs si vous intégrez cela dans un système de modèles avec substitution de variables.
Pour commencer
La mise en forme fonctionne sur tous les forfaits, y compris le forfait gratuit. Créez un compte gratuit et envoyez jusqu'à 50 messages par mois pour tester le rendu de numéros de commande en gras, de notes en italique et de listes simples dans votre propre flux de travail, avant de passer à un forfait payant.
Envie d'envoyer des messages WhatsApp via API ?
Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.
Gratuit pour toujours