Notifications WhatsApp depuis ClickUp avec des webhooks
ClickUp n'a pas d'intégration WhatsApp native, mais il dispose de sa propre API de webhooks, capable de déclencher une requête HTTP pour presque toute action sur une tâche : un changement de statut, une nouvelle tâche, une échéance modifiée ou un membre d'équipe assigné. Combinez cela avec l'API TextMeFlow et, en quelques minutes, vous envoyez un message WhatsApp à un client ou à un collègue dès que quelque chose change dans une tâche.
Cet article présente le chemin le plus court : ClickUp → votre propre récepteur de webhook → l'API TextMeFlow. Pas besoin de Zapier ni de Make, même si vous pouvez utiliser ces outils si vous ne voulez pas maintenir votre propre endpoint.
Créer un webhook ClickUp
ClickUp n'offre pas de bouton dans l'interface pour enregistrer un webhook — cela se fait via l'API elle-même. Vous envoyez un POST à https://api.clickup.com/api/v2/team/{team_id}/webhook avec votre jeton d'API ClickUp, l'URL de votre récepteur et les événements auxquels vous voulez réagir :
curl -X POST "https://api.clickup.com/api/v2/team/123456/webhook" \
-H "Authorization: $CLICKUP_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"endpoint": "https://jouw-domein.be/webhooks/clickup",
"events": ["taskStatusUpdated", "taskCreated", "taskDueDateUpdated"]
}'
ClickUp répond avec un webhook_id et un secret. Conservez ce secret — chaque appel de webhook entrant contient un en-tête X-Signature, un HMAC-SHA256 de la payload avec ce secret comme clé. Vérifiez cette signature avant de traiter la payload, sinon n'importe qui connaissant l'URL peut envoyer de faux changements de statut.
// routes/api.php (Laravel)
Route::post('/webhooks/clickup', function (Illuminate\Http\Request $request) {
$expected = hash_hmac('sha256', $request->getContent(), config('services.clickup.secret'));
if (!hash_equals($expected, $request->header('X-Signature', ''))) {
abort(401);
}
$event = $request->input('event');
$taskId = $request->input('task_id');
// ... traitez la modification, voir ci-dessous
return response()->json(['ok' => true]);
});
De l'événement ClickUp au message WhatsApp
Chaque appel de webhook contient le type d'event et un task_id, mais pas toujours toutes les données de la tâche. Pour obtenir le nouveau statut ou la nouvelle échéance, vous ajoutez généralement un appel GET /task/{task_id} séparé, ou vous utilisez le champ history_items que certains événements fournissent déjà. Associez le numéro de téléphone à la tâche via un champ personnalisé ou votre propre table de correspondance, et transmettez-le à l'API TextMeFlow :
$phone = Task::where('clickup_task_id', $taskId)->value('whatsapp_number');
if ($phone && $event === 'taskStatusUpdated') {
$task = Http::withToken(config('services.clickup.token'))
->get("https://api.clickup.com/api/v2/task/{$taskId}")
->json();
Http::withToken(config('services.textmeflow.api_key'))
->post('https://textmeflow.eu/api/v1/messages', [
'to' => $phone,
'type' => 'text',
'text' => "Mise à jour : « {$task['name']} » est maintenant au statut « {$task['status']['status']} ».",
]);
}
Si vous ne voulez pas maintenir votre propre backend, vous pouvez aussi construire ces deux mêmes étapes (vérification de signature + transfert) dans n8n ou Make — consultez notre guide Envoyer des messages WhatsApp depuis n8n, Make.com ou Zapier pour la mise en place d'un tel flux.
Quels événements valent la peine
ClickUp envoie des dizaines de types d'événements ; seuls quelques-uns sont pertinents pour des notifications WhatsApp :
taskStatusUpdated— informer un client ou un membre de l'équipe dès qu'une tâche passe à « En revue » ou « Terminée ».taskCreated— escalader en interne quand une nouvelle tâche urgente arrive (filtrez par liste ou par tag, sinon vous recevrez un message par tâche).taskDueDateUpdated— envoyer un rappel d'échéance quand une date limite change, en combinaison avec une tâche cron planifiée qui vérifie chaque jour quelles tâches arrivent à échéance demain.
Abonnez-vous uniquement aux événements que vous traitez réellement — chaque type d'événement supplémentaire augmente le nombre d'appels vers votre endpoint sans utilité.
Sécuriser et limiter le flux
Outre la vérification HMAC de ClickUp lui-même, la même règle s'applique du côté TextMeFlow de votre intégration : chaque notification de statut que TextMeFlow renvoie (par exemple « délivré » ou « échoué ») arrive avec sa propre signature HMAC dans l'en-tête, que vous devez vérifier avant de la traiter. L'explication complète se trouve dans Vérifier les signatures des webhooks WhatsApp et dans la documentation des webhooks.
Tenez aussi compte des règles anti-spam côté envoi : limites de débit, score de risque par numéro et gestion automatique de STOP veillent à ce que votre numéro WhatsApp ne soit pas surchargé, même si une liste ClickUp transmet soudainement dix changements de statut par minute.
Pour commencer
Il vous suffit d'une clé API TextMeFlow pour construire cette intégration. L'offre gratuite vous donne 50 messages par mois pour tester l'intégration avant de passer à une offre payante.
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