· 2 min · TextMeFlow Team

Personnaliser les messages WhatsApp par destinataire (API)

Avec l'API officielle WhatsApp Business, vous devez faire valider vos messages à l'avance par Meta sous forme de « template », avec des espaces réservés fixes comme {{1}} et {{2}}. Cela prend des jours, et chaque modification du texte implique d'attendre une nouvelle validation.

TextMeFlow fonctionne autrement : vous envoyez du texte brut à POST /v1/messages. Il n'y a ni enregistrement de template, ni délai d'approbation, ni format d'espace réservé imposé. L'inconvénient, c'est que la personnalisation est de votre responsabilité ; l'avantage, c'est que vous avez une liberté totale sur chaque phrase, par destinataire, sans attendre personne. Cet article montre comment le construire en pratique.

Pourquoi la personnalisation, c'est plus que remplir un prénom

Un texte identique envoyé à des dizaines de contacts dans un même lot est exactement le schéma qui fait monter le score de risque interne de TextMeFlow : l'unicité du contenu est l'un des signaux pris en compte, avec le nombre de destinataires uniques et le taux de rebond des dernières 24 heures (voir /fr/docs/anti-spam). Un rappel mot pour mot identique pour tout le monde ressemble à un envoi de masse. Le même rappel avec un prénom, une date et un petit détail en plus ressemble à un message personnel, et dans la pratique cela évite bon nombre de questions au support et de désinscriptions.

L'approche : construire le texte avant d'envoyer

L'API n'ayant pas de syntaxe d'espaces réservés, vous assemblez simplement la chaîne vous-même dans votre code, pour chaque ligne de votre base de données ou de votre CSV, et vous envoyez chaque message séparément à l'API.

<?php

$apiKey = getenv('TEXTMEFLOW_API_KEY');

$afspraken = [
    ['naam' => 'Sofie', 'telefoon' => '+32472932208', 'datum' => 'jeudi à 14h', 'dienst' => 'entretien'],
    ['naam' => 'Karim', 'telefoon' => '+32498112233', 'datum' => 'vendredi à 9h30', 'dienst' => 'changement de pneus'],
];

foreach ($afspraken as $a) {
    $tekst = sprintf(
        "Bonjour %s, votre rendez-vous pour %s est prévu %s. Répondez STOP pour vous désinscrire.",
        $a['naam'],
        $a['dienst'],
        $a['datum']
    );

    $response = file_get_contents('https://api.textmeflow.eu/v1/messages', false, stream_context_create([
        'http' => [
            'method'  => 'POST',
            'header'  => "Authorization: Bearer {$apiKey}\r\nContent-Type: application/json\r\n",
            'content' => json_encode(['to' => $a['telefoon'], 'text' => $tekst]),
        ],
    ]));

    // Respectez la limite de débit : 1 message par seconde maximum par numéro.
    usleep(1_100_000);
}

L'approche sprintf est volontairement simple : inutile d'ajouter une bibliothèque de templates pour quelques variables. À plus grand volume (des centaines de lignes), une courte pause entre les appels, comme le usleep ci-dessus, suffit pour rester sous la limite de 1 message par seconde par numéro. Au-delà, l'API répond par 429 Too Many Requests ; interceptez cette réponse et réessayez avec un court délai croissant plutôt que de laisser tout le lot planter.

Variez plus que le seul prénom

Quelques façons de personnaliser davantage sans ajouter de complexité :

  • Du contexte tiré de votre propre système : montant, numéro de commande, plaque d'immatriculation, numéro de chambre : tout ce que vous avez déjà dans votre base de données a sa place dans le texte, pas seulement le prénom.
  • Une formulation liée au moment : « demain matin » plutôt qu'un format de date fixe donne un ton plus personnel et évite que 200 messages soient littéralement identiques.
  • De courtes variations dans la construction des phrases : alternez « votre rendez-vous est prévu » avec « nous vous attendons » pour une partie du lot. De petites variations suffisent à réduire le risque lié à l'unicité du contenu.

Les médias en font partie aussi

La personnalisation ne s'arrête pas au texte. Le champ media_url de /v1/messages accepte un lien vers un fichier de 100 Mo maximum : un PDF de facture au bon montant, une photo de la bonne chambre, un QR code généré sur mesure. Générez ce fichier pour chaque destinataire avant l'envoi et transmettez l'URL avec le texte.

Ce qu'il ne faut pas faire

N'envoyez pas un texte identique à une liste de numéros achetés ou sans opt-in : c'est de toute façon interdit, et la personnalisation n'y change rien. Et n'utilisez pas le drapeau urgent de /v1/messages pour contourner systématiquement les heures calmes ; ce drapeau est prévu pour les exceptions, pas comme habitude. La façon d'étaler davantage les envois en masse pour rester sous le radar de la détection de diffusion est détaillée dans notre article sur les rappels en masse.

Vous trouverez les schémas complets de requête et de réponse, codes d'erreur compris, dans la référence de l'API.

Commencez aujourd'hui

Inutile d'attendre une validation de Meta pour tester. Créez un compte gratuit, récupérez votre clé API et envoyez votre premier message personnalisé en quelques minutes.

Démarrer gratuitement : 50 messages/mois

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