Se connecterCommencer l’essai gratuit
Meta Tech Provider

Sécurisez vos automatisations WhatsApp : clés, webhooks et signatures

Sécurisez une automatisation WhatsApp en quatre points : la clé IA, stockée chiffrée et utilisée uniquement pour les réponses IA ; le webhook appelé par une automatisation, qui doit vérifier une signature HMAC avant de faire confiance à une requête ; le transfert des messages entrants, signé avec un secret que vous pouvez renouveler ; et les personnes et assistants ayant accès, limités à ce dont ils ont besoin.

easyCoexistence chiffre vos clés IA et ne les affiche plus jamais, signe chaque requête « Appeler mon webhook » et chaque message transféré avec X-EC-Signature grâce à un secret que vous seul détenez, et refuse les adresses de webhook qui ne sont pas en HTTPS public.

AES-256-GCM

Chiffrement au repos pour les clés IA enregistrées, les secrets de signature et le token Meta du numéro.

Last 4

Seul élément visible d'une clé IA enregistrée : « se terminant par » ses quatre derniers caractères.

192 bits

Aléa dans chaque secret de signature : whsec_ suivi de 24 octets aléatoires, un par automatisation et un par numéro de transfert.

HTTPS only

Les URL de webhook et de transfert doivent être en HTTPS public ; les adresses privées et internes sont refusées à l'enregistrement et avant chaque envoi.

5 minutes

Limite suggérée sur l'ancienneté de la valeur t de la signature, pour refuser les requêtes rejouées.

Quels éléments protéger dans une configuration d'automatisation WhatsApp ?

Cinq identifiants, chacun avec son emplacement et sa propre procédure en cas de fuite. Deux appartiennent aux automatisations elles-mêmes : la clé IA et le secret de signature de l'action « Appeler mon webhook ». Le secret de transfert appartient au numéro ; le token d'accès et la connexion de votre assistant appartiennent au compte. Savoir à qui appartient chacun vous indique ce qu'il faut renouveler quand un problème survient.

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

Comment les clés IA sont-elles stockées et utilisées ?

Uniquement depuis le dashboard : le bouton « Clés IA » sur la page Automatisations, puis « Tester et enregistrer ». La clé est d'abord vérifiée auprès d'un endpoint gratuit du fournisseur, qui ne consomme aucun token ; une clé refusée par le fournisseur est écartée sans être enregistrée. Une clé valide est chiffrée au repos avec AES-256-GCM, déchiffrée uniquement pour appeler ce fournisseur lors de vos étapes IA et de vos agents, et pour transcrire les messages vocaux avec une clé OpenAI ou OpenRouter, et ensuite affichée seulement sous la forme « se terminant par 1234 ». Aucun outil MCP n'accepte ni ne renvoie une clé : elle ne transite donc jamais par une conversation avec votre assistant.

Un compte ne détient qu'une clé par fournisseur, et en enregistrer une nouvelle remplace l'ancienne. Créez une clé dédiée aux automatisations chez le fournisseur, avec une limite de dépenses lorsqu'il en propose une, afin de pouvoir la révoquer sans casser vos autres applications. Si le fournisseur la refuse un jour, les automatisations qui l'utilisent passent en « En pause » et vous recevez un seul e-mail ; enregistrer une clé valide les relance automatiquement.

Comment vérifier qu'une requête « Appeler mon webhook » est authentique ?

Vérifiez la signature avant tout autre contrôle. Chaque requête contient X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, signée avec le secret de signature de cette automatisation, que vous copiez depuis l'étape de l'éditeur après l'enregistrement. Recalculez le HMAC sur les octets bruts, comparez en temps constant, et refusez un t qui s'écarte de plus de 5 minutes de votre horloge. Le corps vous indique aussi deux éléments utiles. dry_run vaut true lorsque la requête provient de « Essayer » : ne déclenchez alors rien d'irréversible, comme la création d'une commande. run_id est unique à chaque exécution : conservez ceux que vous avez déjà traités et refusez une requête rejouée. Répondez dans les 20 secondes ; {"reply": "..."} est envoyé tel quel au client, ne transmettez donc jamais un texte client sans contrôle.

A Call my webhook request: headers and body
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>

{
  "event": "automation.step",
  "dry_run": false,
  "automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
  "run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
  "channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
  "contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
  "message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
  "history": [
    { "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
    { "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
  ]
}

// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }

Comment fonctionnent les secrets de transfert, et comment les renouveler ?

Un numéro réglé sur « Through easyCoexistence » peut transférer ses messages entrants vers votre propre système. La première fois que vous enregistrez une URL de transfert, un secret est généré et affiché une seule fois, sous « Votre secret de signature, affiché une seule fois. Copiez-le maintenant : » ; il signe chaque POST transféré avec le même schéma X-EC-Signature. Un nouveau secret depuis la page du numéro, ou set_inbound_mode avec rotate_secret à true, en génère un de remplacement, de nouveau affiché une seule fois, qui signe ensuite tout, y compris les nouvelles tentatives des envois précédents. Vous pouvez aussi saisir un secret de votre choix, d'au moins 24 caractères, qui est stocké et ne sera plus jamais affiché. Arrêter le transfert supprime le secret : enregistrer une URL plus tard repart donc d'un secret neuf.

Renouvelez après le départ d'un collaborateur ayant accès, après qu'un secret a fuité dans un dépôt, un ticket ou un journal, et lorsque vous changez d'hébergement. Le secret de « Appeler mon webhook » appartient à l'automatisation et seul le propriétaire du compte le voit. Là où l'éditeur affiche New secret, sous un déclencheur « Your system calls a URL », ce bouton le remplace et l'ancien cesse de fonctionner immédiatement ; sur une automatisation sans ce bouton, recréez l'automatisation, faites pointer votre récepteur vers le nouveau secret, puis supprimez l'ancienne automatisation.

Quelles adresses les automatisations peuvent-elles appeler ?

Uniquement des adresses HTTPS publiques. Une URL « Appeler mon webhook » ou une URL de transfert qui commence par http://, pointe vers localhost, vers une plage de réseau privé, vers un nom .internal ou .local, ou vers une adresse de métadonnées cloud, est refusée à l'enregistrement, puis vérifiée à nouveau après la résolution DNS avant chaque requête, afin qu'un nom public ne puisse pas être redirigé ensuite vers un réseau privé. Les redirections ne sont pas suivies : un 301 ou un 302 fait échouer l'étape, enregistrez donc l'adresse finale.

Ne placez pas de secrets dans l'URL elle-même. list_automations renvoie les étapes de chaque automatisation, URL de webhook comprise, à tout assistant connecté à votre compte ; un token placé dans la chaîne de requête y serait donc lisible. Laissez plutôt la signature apporter la preuve.

Comment limiter les accès au minimum ?

Donnez à chaque personne et à chaque outil uniquement l'accès dont sa tâche a besoin, et retirez ce qui n'est plus utilisé. Le côté connecteur, avec la connexion, les confirmations et les outils bloqués, est traité dans la page sur la connexion de WhatsApp à une IA en toute sécurité ; côté automatisations, ces habitudes comptent le plus :

  • Demandez get_api_credentials uniquement dans une conversation privée : le token du numéro reste alors dans cette transcription.
  • Préférez « Appeler mon webhook » ou une URL de transfert plutôt que de confier le token à un outil tiers.
  • Supprimez les automatisations abandonnées : cela retire aussi leurs secrets de signature.
  • Gardez à l'esprit que les journaux d'exécution conservent les messages et les réponses des clients pendant 30 jours, et que Conversations conserve les discussions pendant votre durée de rétention (30, 90 ou 365 jours), les deux étant lisibles dans le dashboard et via votre assistant connecté.
  • Sur un numéro réglé sur « Straight to your system », placez un long secret aléatoire dans le chemin de l'URL de callback, puisque la signature de Meta ne peut pas y être vérifiée.

Erreurs courantes

  • Vérifier la signature sur un JSON que votre framework a re-sérialisé. Beaucoup d'analyseurs modifient l'espacement, l'échappement ou l'ordre des clés ; calculez le HMAC sur les octets bruts de la requête partout où votre pile les expose.
  • Déclencher des effets de bord lors des appels de test. « Essayer » appelle votre webhook avec dry_run à true ; une commande, un remboursement ou une écriture dans le CRM réalisés à ce moment-là sont réels.
  • Coller une clé IA dans une conversation avec votre assistant pour gagner du temps. Aucun outil ne la prend en charge, et elle reste dans la transcription ; utilisez les clés IA depuis le dashboard.
  • Vérifier un transfert avec le secret de « Appeler mon webhook », ou l'inverse. Ce sont des secrets distincts : un par numéro pour les transferts, un par automatisation pour les appels webhook.
Faire cela avec EasyCoexistence

Votre numéro reste sur la Cloud API officielle de Meta via Coexistence, surveillé 24/7. De US$ 9 à US$ 0,75 par numéro et par mois, en baisse à mesure que vous ajoutez des numéros, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Le personnel ou le support d'easyCoexistence peut-il voir ma clé IA ?

La clé n'est jamais affichée après l'enregistrement : ni dans le dashboard, ni dans les résultats MCP, ni dans les faits que lit l'assistant de support. Elle n'est déchiffrée que par le système, au moment où il appelle votre fournisseur pour une réponse IA.

Qui peut lire mes journaux d'exécution d'automatisations ?

Toute personne connectée à votre compte easyCoexistence, y compris les personnes que vous y avez invitées, dans l'onglet Exécutions, et tout assistant connecté au compte, via list_automation_runs et get_automation_run. Les journaux incluent le message du client et la réponse, et sont supprimés après 30 jours.

Comment retirer une clé IA en toute sécurité ?

Désactivez d'abord les automatisations qui l'utilisent, et tout agent qui fonctionne avec elle, puis sélectionnez Supprimer sous « Clés IA » et révoquez la clé chez le fournisseur. La supprimer alors que des automatisations l'utilisent encore les met en pause à leur prochaine réponse IA et vous envoie un e-mail.

« Essayer » envoie-t-il des données client à mon webhook ?

Il envoie uniquement le texte d'exemple que vous avez saisi, avec dry_run à true et un historique vide. Les exécutions réelles envoient le message entrant et les messages récents du chat, jusqu'à 10 ; considérez donc votre endpoint comme un traitement de données client.

Poursuivre la lecture

Prêt à commencer ?

Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.

Commencer l'essai gratuit

Vérifié le