Envoyer des notifications WhatsApp depuis Trello via webhooks
Les équipes qui travaillent avec Trello ratent souvent le moment où une carte passe à « Terminé » ou « Action requise ». Une notification de tableau dans l'application Trello se noie parmi les autres, et tout le monde n'a pas Trello ouvert en permanence. WhatsApp, si — on le lit en quelques minutes. Dans cet article, vous construisez une intégration qui envoie automatiquement un message WhatsApp dès qu'une carte change de liste, sans outil d'automatisation intermédiaire.
Pourquoi passer directement par les webhooks
Trello n'a pas d'intégration WhatsApp native, et la plupart des équipes se tournent alors vers Zapier ou Make. Ça marche, mais cela coûte un abonnement de plus et une couche supplémentaire susceptible de défaillir. Le système de webhooks propre à Trello envoie déjà chaque modification du tableau en JSON vers l'URL de votre choix — il ne vous faut qu'un petit morceau de code qui traduit ce payload en appel vers l'API TextMeFlow. Pour qui préfère ne pas maintenir un outil à part, ou travaille déjà avec n8n/Make et veut simplifier ce cas précis, c'est la voie directe. (Pour la plupart des autres intégrations — CRM, formulaires, tableurs — n8n, Make ou Zapier reste souvent plus rapide à mettre en place.)
Étape 1 : enregistrer un webhook Trello
Trello exige un appel POST vers sa propre API pour créer un webhook. Il vous faut une clé d'API et un jeton (via trello.com/app-key), ainsi que l'identifiant du tableau à suivre.
curl -X POST "https://api.trello.com/1/webhooks" \
-d "key=VOTRE_CLE_API" \
-d "token=VOTRE_TOKEN" \
-d "callbackURL=https://votredomaine.tld/trello-webhook" \
-d "idModel=BOARD_ID" \
-d "description=Notifications WhatsApp"
Important : Trello envoie d'abord une requête HEAD à votre callbackURL pour vérifier qu'elle est joignable, avant d'enregistrer le webhook. Votre point de terminaison doit donc déjà être en ligne et renvoyer au moins un 200 à une requête HEAD.
Étape 2 : filtrer le payload sur les déplacements de carte
Trello envoie un événement pour chaque modification du tableau — une nouvelle étiquette, une description modifiée, une carte déplacée. Vous ne voulez réagir qu'à action.type === "updateCard" lorsque listBefore et listAfter diffèrent.
// routes/web.php ou un contrôleur séparé
Route::post('/trello-webhook', function (Request $request) {
$action = $request->input('action');
if (($action['type'] ?? null) !== 'updateCard') {
return response()->json(['ok' => true]);
}
$listBefore = $action['data']['listBefore']['name'] ?? null;
$listAfter = $action['data']['listAfter']['name'] ?? null;
if (! $listAfter || $listBefore === $listAfter) {
return response()->json(['ok' => true]);
}
$cardName = $action['data']['card']['name'] ?? 'Carte inconnue';
Http::withToken(config('services.textmeflow.api_key'))
->post('https://textmeflow.eu/api/messages', [
'to' => config('services.trello_notify.phone'),
'body' => "La carte \"{$cardName}\" a été déplacée vers \"{$listAfter}\".",
]);
return response()->json(['ok' => true]);
});
Vous ne voulez une notification que pour une liste précise — par exemple uniquement lorsqu'une carte arrive dans « Action requise » ? Ajoutez simplement if ($listAfter !== 'Action requise') return; avant l'appel à l'API.
Étape 3 : cibler un groupe plutôt qu'un seul numéro
Un numéro de téléphone codé en dur convient pour un test, mais en pratique vous voulez souvent que toute l'équipe voie le message. Dans ce cas, envoyez vers un groupe WhatsApp plutôt que vers un numéro en 1-à-1, ou parcourez une liste de membres de l'équipe et envoyez individuellement. Tenez compte des limites de débit et statuts d'envoi de l'API — avec plusieurs destinataires par événement, il vaut mieux envoyer de façon séquentielle avec une courte pause, et non en rafale parallèle.
Sécuriser le point de terminaison
Trello ne signe pas par défaut ses payloads de webhook avec HMAC, comme le fait TextMeFlow pour les événements WhatsApp entrants. Ajoutez donc au minimum un paramètre de requête secret à votre callbackURL (par exemple ?secret=xxxx) et vérifiez-le à chaque requête, afin que n'importe qui ne puisse pas appeler votre point de terminaison avec de faux payloads. Si vous traitez aussi vous-même des webhooks WhatsApp entrants, utilisez alors bien la vérification HMAC proposée par TextMeFlow — voir l'explication sur la vérification des signatures de webhook.
Automatiser plus loin
La même structure fonctionne pour d'autres événements Trello : une nouvelle carte dans une liste (createCard), une étiquette ajoutée ou une échéance qui approche. Combinez-la avec les événements webhook de TextMeFlow si vous voulez aussi communiquer dans l'autre sens — par exemple un client qui répond via WhatsApp et dont la réponse est automatiquement publiée en commentaire sur la bonne carte Trello.
Pour les équipes qui veulent construire ce type d'intégration sans code : c'est tout à fait possible via Make ou n8n, où Trello est disponible comme déclencheur prêt à l'emploi. La voie directe ci-dessus est surtout intéressante si vous avez déjà un backend en service et ne voulez pas d'abonnement supplémentaire.
Pour commencer
Envie d'essayer ? L'offre gratuite de TextMeFlow vous donne 50 messages par mois, sans date d'expiration — de quoi construire et tester entièrement cette intégration Trello avant de payer quoi que ce soit. Commencez gratuitement.
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