· 4 min · TextMeFlow Team

Notifications WhatsApp depuis Monday.com avec webhooks

Monday.com n'envoie pas lui-même de messages WhatsApp, mais il dispose d'une intégration webhook native capable de déclencher une requête HTTP à presque chaque modification d'un tableau. Associez cela à l'API TextMeFlow et, en quelques minutes, vous envoyez une notification WhatsApp à un client ou à un collègue dès qu'un élément change de statut, qu'une échéance approche ou qu'une nouvelle ligne est ajoutée.

Cet article présente le chemin le plus court : Monday.com → un petit 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 construire votre propre endpoint.

Comment fonctionne le webhook de Monday.com

Monday.com propose des « Intégrations » au niveau du tableau. Dans le générateur d'automatisations, vous choisissez un déclencheur (par exemple « le statut passe à Terminé » ou « un élément est créé ») et, comme action, « Send a webhook ». Vous y indiquez une seule URL, celle de votre récepteur, et Monday.com y envoie en POST une charge JSON à chaque modification correspondante, contenant l'ID du tableau, l'ID de l'élément, les valeurs des colonnes et le nouveau statut.

Détail important : à la création du webhook, Monday.com envoie d'abord une requête de vérification challenge. Votre endpoint doit renvoyer cette valeur de challenge inchangée dans la réponse, faute de quoi le webhook n'est pas activé.

// routes/api.php (Laravel)
Route::post('/webhooks/monday', function (Illuminate\Http\Request $request) {
    if ($request->has('challenge')) {
        return response()->json(['challenge' => $request->input('challenge')]);
    }

    $event = $request->input('event');
    // ... traiter le changement de statut, voir ci-dessous

    return response()->json(['ok' => true]);
});

De l'événement Monday.com au message WhatsApp

Une fois le challenge traité, chaque appel suivant contient un objet event avec notamment pulseId (l'élément), columnId, value (nouvelle valeur) et previousValue. Récupérez dans votre propre base de données le numéro de téléphone associé à cet élément, généralement lié via un champ personnalisé ou une table de correspondance, et transmettez-le à l'API TextMeFlow :

$phone = Item::where('monday_item_id', $event['pulseId'])->value('whatsapp_number');

if ($phone) {
    Http::withToken(config('services.textmeflow.api_key'))
        ->post('https://textmeflow.eu/api/v1/messages', [
            'to' => $phone,
            'type' => 'text',
            'text' => "Mise à jour du statut : l'élément n°{$event['pulseId']} est maintenant « {$event['value']['label']['text']} ».",
        ]);
}

Si vous préférez ne pas utiliser votre propre backend, vous pouvez construire les deux mêmes étapes (vérification + transmission) dans n8n ou Make. Voir notre guide envoyer des messages WhatsApp depuis n8n, Make.com ou Zapier pour la mise en place d'un tel flux.

Sécurisez votre endpoint

Les webhooks de Monday.com ne sont pas signés, mais le côté TextMeFlow de votre intégration l'est : chaque notification de statut entrante renvoyée par TextMeFlow (par exemple « livré » ou « échoué ») arrive avec une signature HMAC dans l'en-tête. Vérifiez-la toujours avant de traiter la charge utile. L'explication complète se trouve dans Vérifier les signatures des webhooks WhatsApp et dans la documentation des webhooks. Pour votre propre récepteur Monday.com, le même conseil s'applique : ajoutez au minimum un paramètre de requête secret ou une liste d'IP autorisées, afin que n'importe quel POST ne puisse pas déclencher votre flux.

Applications pratiques

Quelques exemples qui fonctionnent bien avec cette configuration :

  • Suivi de projet : le client reçoit un message WhatsApp dès qu'un élément passe à « Révision » ou « Terminé ».
  • Escalade interne : envoyez un message à un membre de l'équipe lorsqu'un élément reste plus de X jours sur « En cours » (à combiner avec les déclencheurs temporels propres à Monday.com).
  • Rappels d'échéance : reliez la colonne de date à un rappel programmé, la veille de l'échéance.

Pour chacune de ces applications, gardez à l'esprit les règles anti-spam : limites de débit, score de risque par numéro et traitement automatique des STOP font en sorte que votre numéro WhatsApp ne soit pas surchargé, même si un tableau transmet soudain dix changements de statut par minute.

Pour démarrer

Il vous suffit d'une clé d'API TextMeFlow pour construire cette liaison. Le forfait gratuit vous donne 50 messages par mois pour tester l'intégration avant de passer à un forfait payant.

Commencez gratuitement vos tests

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