· 5 min · TextMeFlow Team

Sécuriser sa clé API WhatsApp : prévenir les fuites et réagir

Votre clé API est la seule clé dont quelqu'un a besoin pour envoyer des messages au nom de votre numéro WhatsApp. Pas de mot de passe, pas de seconde vérification : celui qui possède la clé peut appeler l'API comme s'il était votre entreprise. Pourtant, beaucoup d'équipes traitent cette clé avec négligence : codée en dur dans un script, partagée via Slack, ou utilisée sans changement pendant des années par tous ceux qui y ont eu accès un jour. Cet article passe en revue ce que vous pouvez faire concrètement autrement.

Ce que la clé permet réellement

Chaque appel à l'API TextMeFlow — qu'il s'agisse de l'API REST moderne /v1/* ou de la route /send.php compatible TextMeBot — s'identifie avec cette même clé, sous la forme d'un en-tête Authorization: Bearer <votre_clé_api> ou d'un paramètre ?apikey=. Il n'existe pas de variante en lecture seule : celui qui a la clé peut envoyer des messages, point final. Une clé qui fuit n'est donc pas seulement un risque pour la vie privée, mais aussi un risque opérationnel : quelqu'un qui détourne la clé pour envoyer massivement des messages non sollicités place votre numéro en plein dans le viseur du pipeline anti-spam — et, au pire, vers un bannissement par Meta, avec vos clients comme dégâts collatéraux.

Où la clé peut et ne peut pas se trouver

La règle d'or est simple : la clé ne va jamais dans le contrôle de version. Concrètement :

  • Placez-la dans un fichier .env ou dans le gestionnaire de secrets de votre plateforme d'hébergement (Railway, Fly.io, un .env sur le serveur qui n'est pas dans git), jamais codée en dur dans un fichier .js, .php ou .py que vous commitez.
  • Ajoutez .env à votre .gitignore avant de créer le premier fichier, pas après — une clé qui a un jour été commitée reste dans l'historique git, même après une suppression ultérieure.
  • Ne partagez jamais une clé par chat, e-mail ou document partagé. Utilisez la fonction de secrets de l'outil de votre équipe (secrets GitHub Actions, variables d'environnement Vercel, 1Password) plutôt qu'un copier-coller.
  • Si vous travaillez avec un freelance ou une agence qui a besoin d'un accès temporaire, donnez cet accès via un environnement que vous pourrez révoquer ensuite (un coffre de secrets partagé), et non en envoyant la clé elle-même.

Si vous débutez avec l'API : le flux d'authentification complet est décrit dans /fr/docs/api et les étapes pour créer une première clé dans /fr/docs/getting-started.

Les webhooks, c'est une autre histoire

Notez la distinction : votre clé API envoie des messages, mais les webhooks entrants (statuts de messages, réponses des clients) ne sont pas protégés par cette clé. Ils sont signés par HMAC — TextMeFlow signe chaque payload de webhook avec son propre secret, afin que votre point de terminaison puisse vérifier que la requête vient bien de TextMeFlow et non de quelqu'un qui aurait deviné l'URL de votre webhook. C'est un secret distinct, avec un rôle différent de celui de votre clé API, et il mérite son propre stockage soigné. La façon de vérifier cette signature est détaillée dans Vérifier les signatures de webhook.

Quand effectuer une rotation

Il y a quelques moments où il ne faut pas attendre que quelque chose tourne mal :

  • Un employé ou un freelance qui avait accès s'en va. Si la clé a un jour été partagée avec quelqu'un qui quitte l'entreprise, c'est le moment de la remplacer — pas « un jour ce trimestre ».
  • Vous trouvez par hasard la clé dans un fichier commité, un dépôt public ou un fichier de log. À partir de là, considérez-la comme compromise, même si vous n'êtes pas sûr que quelqu'un l'ait déjà utilisée.
  • Vous voyez partir des messages que vous n'avez pas initiés. C'est le signe le plus clair d'un abus et il appelle une action immédiate.

Si vous soupçonnez une fuite, contactez le support TextMeFlow pour que la clé existante soit invalidée et que vous en receviez une nouvelle. Mettez ensuite à jour chaque endroit où l'ancienne clé se trouvait — scripts, automatisations, secrets CI/CD — car un endroit oublié avec l'ancienne clé signifie simplement une panne silencieuse en production dès que cette clé cesse de fonctionner.

Une clé, plusieurs intégrations

La plupart des équipes utilisent la même clé dans plusieurs outils : un flux n8n, un script backend, une automatisation Airtable. Ce n'est pas un problème en soi, mais cela rend la rotation plus pénible — il faut tout mettre à jour. Tenez donc une liste des endroits où la clé est utilisée (une ligne dans un document wiki interne suffit) pour que la rotation ne devienne pas une enquête. Pour les équipes qui travaillent sur plusieurs numéros, un appareil distinct par équipe ou par agence est disponible à partir de l'offre Business, ce qui simplifie la rotation et la gestion des accès par numéro par rapport à un fonctionnement entièrement basé sur une seule clé partagée.

Pas encore de compte ? Créez un compte TextMeFlow gratuit et commencez avec une clé que vous stockez correctement dès le premier jour — c'est plus simple que de faire le ménage après coup.

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