· 5 min · TextMeFlow Team

Notifications WhatsApp depuis les webhooks de tickets Jira

Les résumés par e-mail et la cloche de Jira sont faciles à ignorer, surtout pour les personnes qui ne passent pas leur journée dans Jira : un responsable support qui attend une transition vers « ready for QA », un chef de projet en contact avec les clients qui doit savoir à l'instant où un ticket bloquant est rouvert. WhatsApp est ouvert dans les minutes qui suivent l'arrivée d'un message. Ce guide relie directement les webhooks natifs de Jira à l'API TextMeFlow, de sorte qu'un changement de statut ou une réassignation devienne un message WhatsApp sans abonnement d'automatisation entre les deux.

Pourquoi passer en direct plutôt que par un outil d'automatisation

Jira peut envoyer une charge utile JSON signée vers n'importe quelle URL pour les événements de création, de mise à jour et de suppression de tickets, ainsi que pour les commentaires. Si vous exploitez déjà un backend, transformer cette charge utile en message WhatsApp se résume à un petit gestionnaire de route : rien d'autre à héberger, rien d'autre qui puisse tomber en panne indépendamment de votre propre pile. Si vous préférez ne pas écrire ni maintenir ce point de terminaison, n8n, Make ou Zapier disposent tous de déclencheurs Jira natifs et constituent la voie la plus rapide quand personne dans l'équipe ne veut toucher au code.

Étape 1 : enregistrez le webhook

Pour Jira Cloud, les webhooks se gèrent par application si vous développez une application Connect/Forge, ou, pour une configuration plus simple sur votre propre instance ou via un webhook créé par un administrateur, sous Settings → System → WebHooks (droits d'administrateur Jira requis). Pointez-le vers votre point de terminaison et choisissez les événements qui vous intéressent :

URL: https://yourdomain.tld/jira-webhook
Events: jira:issue_updated, jira:issue_created
JQL filter: project = SUPPORT AND status changed

Le filtre JQL compte plus qu'il n'y paraît : sans lui, vous recevez chaque modification de chaque ticket du projet, y compris celles qui ne justifient aucune notification sur téléphone.

Étape 2 : traitez la charge utile et filtrez les vrais changements

Jira envoie l'objet ticket complet à chaque événement, plus un bloc changelog qui liste précisément les champs modifiés. Appuyez-vous dessus plutôt que de redéduire vous-même le changement :

// routes/web.php
Route::post('/jira-webhook', function (Request $request) {
    $changelog = $request->input('changelog.items', []);

    $statusChange = collect($changelog)->first(
        fn ($item) => ($item['field'] ?? null) === 'status'
    );

    if (! $statusChange) {
        return response()->json(['ok' => true]);
    }

    $issue = $request->input('issue', []);
    $key = $issue['key'] ?? 'UNKNOWN';
    $summary = $issue['fields']['summary'] ?? '';
    $to = $statusChange['toString'] ?? '';

    Http::withToken(config('services.textmeflow.api_key'))
        ->post('https://textmeflow.eu/v1/messages', [
            'to' => config('services.jira_notify.phone'),
            'text' => "{$key} est passé à {$to} : {$summary}",
        ]);

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

La réassignation fonctionne de la même façon : cherchez un élément du changelog dont le champ field vaut assignee, et retrouvez le numéro de téléphone du nouvel assigné dans votre propre table d'utilisateurs plutôt que de coder en dur un destinataire unique.

Étape 3 : acheminez vers la bonne personne, pas vers tout le monde

Un seul numéro dans la configuration suffit pour un premier test, mais en production vous voulez généralement que le message atteigne la personne réellement responsable ensuite de ce ticket : le nouvel assigné lors d'une réassignation, un groupe WhatsApp de support fixe lors d'un passage au statut « Escalated ». Conservez cette correspondance dans votre propre base de données plutôt que dans Jira ; les charges utiles des webhooks ne contiennent que des identifiants de compte Jira, il vous faut donc toujours une table de correspondance qui les relie aux numéros de téléphone. Si un événement doit atteindre plusieurs personnes, envoyez les messages l'un après l'autre avec un court délai et vérifiez la réponse 202/429 de /v1/messages, conformément à la documentation sur les limites de débit : lancer une rafale de requêtes parallèles pour une seule mise à jour de ticket est le plus sûr moyen de les atteindre.

Sécurisez le point de terminaison

Les webhooks Jira ne sont pas signés par défaut sur un webhook standard au niveau de l'instance : quiconque trouve l'URL pourrait envoyer une fausse charge utile en POST. Placez un jeton secret dans le chemin de l'URL ou dans un en-tête que votre route vérifie avant tout traitement, et gardez ce point de terminaison séparé de toute gestion des messages WhatsApp entrants. Les webhooks entrants de TextMeFlow utilisent une véritable vérification de signature HMAC ; les deux intégrations sont indépendantes et ne doivent pas partager une hypothèse de confiance simplement parce qu'elles se trouvent dans la même base de code.

Aller plus loin

Le même schéma de filtrage du changelog couvre n'importe quel champ Jira : priorité relevée à Highest, date d'échéance définie, commentaire ajouté par une personne extérieure à l'équipe. Combinez-le avec les événements webhook de TextMeFlow pour boucler dans les deux sens : un client qui répond « approuvé » sur WhatsApp déclenche un appel à l'API Jira pour faire passer automatiquement le ticket lié à l'étape suivante.

Pour commencer

L'offre gratuite de TextMeFlow comprend 50 messages par mois sans date d'expiration, de quoi construire et tester toute cette intégration Jira avant de payer quoi que ce soit. Commencer 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