· 5 min · TextMeFlow Team

Mise en forme WhatsApp par API : gras, italique, listes

La plupart des intégrations d'API envoient les messages WhatsApp sous forme d'une seule chaîne plate, et le résultat ressemble à un mur de texte : aucune emphase, aucune structure, aucune hiérarchie visuelle. WhatsApp prend pourtant en charge un petit jeu de caractères de mise en forme, ceux que l'application utilise elle-même, et ils fonctionnent à l'identique qu'un humain les tape ou que votre backend les génère. Voici ce qui est disponible et comment l'utiliser via le endpoint POST /v1/messages de TextMeFlow.

Les quatre caractères que WhatsApp comprend

Le moteur de rendu de WhatsApp repère ces marqueurs dans le corps du message et les convertit côté client :

  • *gras* → gras
  • _italique_ → italique
  • ~barré~ → barré
  • ```monospace``` → monospace

C'est tout l'ensemble. Il n'y a pas de syntaxe de titre, pas de texte coloré, pas de mise en forme imbriquée (*_gras italique_* ne fonctionne pas de façon fiable selon les clients WhatsApp) et pas de tableaux. Considérez-le comme une emphase légère, pas comme un système de mise en page.

L'envoyer via l'API

La mise en forme se trouve entièrement dans le champ text : il n'y a pas de paramètre distinct. Vous incluez simplement les caractères de marquage dans la chaîne :

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, 14h00*.\n\n_Merci d’arriver 10 minutes en avance._"
  }'

Deux points comptent pour que cette requête s'affiche correctement :

  1. Échappez correctement la barre oblique inverse. En JSON, un saut de ligne littéral dans le corps doit s'écrire \n, et non comme un vrai retour à la ligne dans votre chaîne source. La plupart des encodeurs JSON (json_encode en PHP, json.dumps en Python, JSON.stringify en Node) s'en chargent automatiquement si vous construisez le payload comme un objet natif plutôt qu'en concaténant à la main une chaîne JSON brute.
  2. N'encodez pas les caractères markdown comme dans une URL. * et _ sont valides dans une chaîne JSON et n'exigent aucun traitement particulier : veillez simplement à ce qu'ils arrivent tels quels dans le champ text.

Si vous n'avez pas encore mis en place la requête de base, le guide d'envoi en PHP/Python/Node.js couvre l'appel HTTP dans les trois langages. La mise en forme s'ajoute telle quelle à chacun de ces exemples, ce n'est pas un chemin de code différent.

Créer 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 en début de ligne se lisent très bien dans l'interface WhatsApp :

{
  "to": "+32470000000",
  "text": "*Commande n° 4821 — prête à retirer*\n\n- 2x Grains d’espresso (1 kg)\n- 1x Filtre en céramique\n- 1x Kit de nettoyage\n\nLe point de retrait ferme à 18h00."
}

Cela s'affiche comme 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 convient mieux que d'essayer de tout faire tenir en texte brut ; voyez le guide pour envoyer des PDF et des photos via l'API.

À quoi sert la mise en forme (et à quoi elle ne sert pas)

La mise en forme est utile pour les détails qu'un destinataire doit repérer rapidement, pas pour mettre tout le message en gras :

  • Mettez en gras le seul fait que l'on cherche : une date, un numéro de commande, un montant dû.
  • Utilisez l'italique pour une remarque ou une consigne secondaire qui ne doit pas concurrencer la ligne principale.
  • Gardez le reste du message en phrases simples et courtes. Une mise en forme excessive (un mot sur deux en gras) fait penser à du spam et va à l'encontre du but recherché.

À savoir aussi : WhatsApp détecte automatiquement les URL et les numéros de téléphone dans le texte brut et les rend cliquables sans aucun balisage de votre part. Pas besoin de faire quoi que ce soit de particulier pour qu'un lien soit cliquable, incluez-le simplement comme du texte normal.

Testez avant de publier

La mise en forme s'affiche différemment selon les clients mobile, bureau et web de WhatsApp, 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 au lieu de générer une erreur. Avant de mettre un modèle en production, envoyez quelques messages de test à votre propre numéro avec des valeurs dynamiques 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 donne la liste complète des champs si vous l'intégrez dans un système de modèles avec substitution de variables.

Essayez

La mise en forme fonctionne sur tous les forfaits, y compris le gratuit : inscrivez-vous gratuitement et envoyez jusqu'à 50 messages par mois pour voir comment des numéros de commande en gras, des remarques en italique et de simples listes s'affichent dans votre propre workflow avant de vous engager sur quoi que ce soit de 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