Notifications WhatsApp depuis les webhooks Asana
Les notifications natives d'Asana se perdent vite : entre chaque commentaire, chaque sous-tâche et chaque e-mail « a aimé cette tâche », l'unique mise à jour qui compte vraiment (un livrable destiné au client marqué comme terminé, une tâche réassignée à quelqu'un en congé) disparaît dans la masse. WhatsApp n'a pas ce problème : on l'ouvre en quelques minutes. Ce guide construit un pont webhook direct entre Asana et WhatsApp, sans passer par un outil d'automatisation tiers.
Pourquoi en direct plutôt que Zapier ou Make
Les webhooks Asana envoient une payload JSON signée vers une URL que vous contrôlez pour chaque modification d'un projet : tâche créée, tâche terminée, responsable modifié, échéance déplacée. Si vous avez déjà un backend, traduire cette payload en message WhatsApp ne demande qu'une dizaine de lignes de code — pas d'abonnement séparé, pas de service supplémentaire susceptible de tomber en panne indépendamment de votre propre stack. Si vous préférez ne pas maintenir ce endpoint vous-même, n8n, Make ou Zapier proposent tous des déclencheurs Asana et restent la voie la plus rapide pour les équipes qui ne veulent pas toucher au code.
Étape 1 : enregistrer le webhook
Les webhooks Asana se créent par un POST vers leur API, en ciblant la ressource à surveiller (généralement le GID d'un projet) et l'URL de rappel qui recevra les événements.
curl -X POST "https://app.asana.com/api/1.0/webhooks" \
-H "Authorization: Bearer YOUR_ASANA_TOKEN" \
-d "resource=PROJECT_GID" \
-d "target=https://yourdomain.tld/asana-webhook"
Asana effectue un handshake avant l'activation du webhook : il envoie un POST vide avec un en-tête X-Hook-Secret à votre URL de rappel et attend que vous renvoyiez ce même en-tête dans votre réponse en quelques secondes. Votre endpoint doit donc être en ligne et joignable avant d'enregistrer le webhook, pas après.
// routes/web.php
Route::post('/asana-webhook', function (Request $request) {
if ($secret = $request->header('X-Hook-Secret')) {
return response('', 200)->header('X-Hook-Secret', $secret);
}
// handle real events below
return response()->json(['ok' => true]);
});
Étape 2 : filtrer les événements qui vous intéressent
Asana regroupe plusieurs modifications dans une seule livraison de webhook : vous recevez donc un flux d'events dans une même payload. La plupart relèvent du bruit (une tâche déplacée entre sections, un abonné ajouté), sauf si vous filtrez sur la combinaison précise d'action et de resource_type voulue — généralement action: "changed" sur le champ completed d'une tâche, ou des changements de parent pour une réassignation.
Route::post('/asana-webhook', function (Request $request) {
if ($secret = $request->header('X-Hook-Secret')) {
return response('', 200)->header('X-Hook-Secret', $secret);
}
foreach ($request->input('events', []) as $event) {
if (($event['action'] ?? null) !== 'changed'
|| ($event['resource']['resource_type'] ?? null) !== 'task') {
continue;
}
$change = $event['change']['field'] ?? null;
if ($change !== 'completed') {
continue;
}
Http::withToken(config('services.textmeflow.api_key'))
->post('https://textmeflow.eu/v1/messages', [
'to' => config('services.asana_notify.phone'),
'text' => "Task {$event['resource']['gid']} was marked complete in Asana.",
]);
}
return response()->json(['ok' => true]);
});
La payload de tâche d'un événement changed ne fournit par défaut qu'un GID — appelez GET /api/1.0/tasks/{gid} avec votre jeton Asana si vous voulez le vrai nom de la tâche dans le message WhatsApp plutôt qu'un identifiant opaque.
Étape 3 : prévenir une équipe, pas un seul numéro
Un seul numéro de téléphone dans la configuration suffit pour tester, mais en production vous voudrez généralement toucher toute l'équipe, ou une personne précise selon l'assignation de la tâche. Envoyez vers un groupe WhatsApp quand la mise à jour concerne tout le monde, ou retrouvez le numéro du responsable dans votre propre table d'utilisateurs et envoyez en 1:1. Dans les deux cas, surveillez les limites de débit : quand un événement doit atteindre plusieurs destinataires, envoyez séquentiellement avec un court délai plutôt que de lancer les requêtes en parallèle, et vérifiez la réponse 202/429 de /v1/messages pour savoir si un envoi a réellement été mis en file d'attente.
Sécuriser le endpoint
Asana ne signe pas les payloads de livraison avec un mécanisme comparable à la vérification HMAC propre à TextMeFlow pour les réponses WhatsApp entrantes — le X-Hook-Secret ne couvre que le handshake, pas chaque événement suivant. Conservez le secret qu'Asana vous donne pendant le handshake et exigez-le en en-tête (ou en paramètre de requête secret) à chaque appel ultérieur vers votre endpoint, afin qu'un tiers qui devinerait l'URL ne puisse pas l'usurper. Si vous traitez aussi des messages WhatsApp entrants sur le même backend, assurez-vous qu'ils passent par la vérification de signature des webhooks de TextMeFlow — les deux intégrations sont indépendantes et ne doivent pas partager une hypothèse de confiance.
Aller plus loin
Le même schéma couvre d'autres déclencheurs Asana : une nouvelle tâche créée dans un projet donné, une échéance dans les 24 heures, un champ personnalisé qui change de statut. Associez-le aux événements webhook de TextMeFlow si vous voulez boucler dans les deux sens — par exemple, un client qui répond « approuvé » sur WhatsApp et la tâche Asana liée qui passe automatiquement en terminée via l'API Asana.
Pour commencer
Envie d'essayer ? L'offre gratuite de TextMeFlow comprend 50 messages par mois sans date d'expiration — de quoi construire et tester toute cette intégration Asana 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