Recette d'intégration

Intégration WhatsApp avec Jira : des demandes Service Management depuis WhatsApp

Guide de configuration et workflow n8n importableDernière vérification : octobre 2026

Spun garde WhatsApp sur le numéro que vos clients utilisent déjà et le relie à Jira Service Management par un workflow dans votre propre n8n. Chaque conversation WhatsApp devient une demande dans votre projet de service, les messages suivants sont ajoutés sous forme de commentaires, et le commentaire public d'un agent repart vers le client sur WhatsApp.

C'est la configuration WhatsApp pour Jira Service Management destinée aux équipes qui suivent déjà le support dans Jira : les agents continuent de traiter les demandes là où elles sont, les clients continuent d'écrire là où ils écrivent. Le jeton d'API Jira reste dans votre n8n ; Spun ne le reçoit ni ne le conserve jamais.

Ce que fait le workflow WhatsApp-Jira Service Management

  • Le premier message d'une conversation crée une demande du type de demande que vous choisissez, avec le nom, le numéro et le message du client dans la description et le numéro dans un champ de numéro WhatsApp.
  • Les messages suivants sont ajoutés à la demande ouverte sous forme de commentaires publics, précédés du nom et du numéro de l'expéditeur.
  • Le commentaire public d'un agent est envoyé au client sur WhatsApp sous forme de texte. Les commentaires internes ne quittent jamais Jira.
  • Les réponses que votre équipe envoie depuis la boîte de réception Spun sont ajoutées comme commentaires internes, de sorte que les deux côtés peuvent répondre.
  • Archiver la conversation dans Spun exécute votre transition de résolution, et la désarchiver rouvre la demande lorsqu'une transition de réouverture est définie. Résoudre dans Jira peut aussi archiver la conversation dans Spun, une option désactivée tant que vous ne l'activez pas.

Chaque demande est créée par un seul compte d'intégration, un agent du projet de service. Le workflow ne crée ni n'associe de clients Jira, les notifications client de Jira pour ces demandes arrivent donc dans la boîte mail de ce compte, pas chez le client.

La configuration, pas à pas

Il vous faut un site Jira Service Management avec un projet de service, un compte d'intégration qui est agent de ce projet (la facturation du siège dépend de votre formule Jira), un administrateur Jira une fois pour créer le webhook, et une instance n8n que Jira et Spun peuvent joindre en HTTPS.

  1. 1

    Créez un jeton d'API pour le compte d'intégration

    Connecté avec ce compte, créez un jeton d'API et conservez-le dans n8n comme identifiant Basic Auth. Il reste dans votre n8n.

  2. 2

    Ajoutez un champ « WhatsApp number »

    Un champ de texte court sur le type de demande que les conversations WhatsApp doivent utiliser.

  3. 3

    Repérez vos transitions

    La transition qui résout une demande et, si vous le souhaitez, celle qui la rouvre.

  4. 4

    Importez le workflow

    Ouvrez son nœud Settings et collez l'URL de votre site, le centre de services, le type de demande, la clé du projet, l'identifiant du champ, les transitions et l'identifiant du compte d'intégration.

  5. 5

    Créez le webhook Jira

    En tant qu'administrateur Jira, un webhook vers l'URL de réponse du workflow sur Comment: created, filtré en JQL sur votre projet et protégé par un secret. Jira signe chaque livraison et le workflow le vérifie.

  6. 6

    Créez une clé API Spun

    « Paramètres », puis « Webhooks », puis « Gérer les clés API », avec la portée d'envoi de messages. Cochez aussi « Fermer & Rouvrir les Conversations » si la résolution dans Jira doit archiver la conversation dans Spun.

  7. 7

    Abonnez Spun au workflow

    Ajoutez un webhook pour les messages entrants, les messages sortants, la conversation fermée et la conversation rouverte, avec le modèle de contenu réglé sur raw, et collez son secret de signature dans le workflow.

  8. 8

    Envoyez un message de test

    Écrivez à la ligne depuis un autre téléphone. Une demande apparaît dans Jira ; ajoutez un commentaire public en tant qu'agent et la réponse arrive sur le téléphone.

À lire aussi : Documentation : Jira Service Management via n8n, le guide de configuration complet · WhatsApp + n8n : l'API et les webhooks sous-jacents

Ce que vous devez savoir avant de construire

  • Les conversations de groupe sont ignorées.
  • Les médias entrent dans la demande sous forme de lien valable 24 heures, pas comme pièce jointe Jira. Les réponses depuis Jira sont uniquement textuelles ; les pièces jointes d'un commentaire ne sont pas transmises.
  • Jira accepte 20 écritures sur une même demande en 2 secondes et 100 en 30 secondes. Lors d'une longue rafale de messages, les messages en trop ne sont pas ajoutés à la demande ; ils restent dans la boîte de réception Spun et l'exécution n8n peut être relancée.
  • Une seule demande ouverte par conversation. Les commentaires de plus de 32 000 caractères sont tronqués.
  • Chaque événement livré consomme des jetons IA de votre formule Spun. La façon dont cela est décompté pour un usage helpdesk est encore à l'étude.

À lire aussi : Toutes les intégrations WhatsApp avec un helpdesk · WhatsApp comme helpdesk à part entière

Questions fréquentes

Jira Service Management peut-il recevoir des messages WhatsApp ?

Oui, via Spun et un workflow n8n. Chaque conversation WhatsApp devient une demande dans votre projet de service, et les messages suivants sont ajoutés sous forme de commentaires.

Comment les agents répondent-ils sur WhatsApp depuis Jira ?

Par un commentaire public sur la demande. Un webhook Jira signé l'envoie au workflow, qui l'envoie au client sur WhatsApp depuis votre propre numéro. Les commentaires internes restent dans Jira.

Les demandes sont-elles créées au nom du client ?

Non. Chaque demande est créée par un seul compte d'intégration, et le nom et le numéro du client sont inscrits dans la demande. Aucun compte client Jira n'est créé.

Spun conserve-t-il mon jeton d'API Jira ?

Non. Le jeton réside dans les identifiants de votre n8n. Spun ne voit que le côté WhatsApp et les réponses que le workflow lui demande d'envoyer.

S'agit-il d'une application de la marketplace Jira ?

Non. C'est un workflow n8n que vous importez dans votre propre n8n, Cloud ou auto-hébergé, avec un guide de configuration dans la documentation de Spun.

Les conversations WhatsApp en demandes Jira

Spun transforme votre numéro WhatsApp existant en boîte de réception d'équipe partagée, avec étiquettes, attribution et résumés par IA, ainsi que les webhooks et l'API qu'utilise ce workflow. Essai gratuit.

Commencez gratuitement : 7 jours avec tout inclus

Voir toutes les intégrations