Recette d'intégration

Intégration WhatsApp avec Freshdesk : des tickets sur le numéro que vous utilisez déjà

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

Il existe deux façons de faire fonctionner WhatsApp avec Freshdesk. Freshdesk propose son propre canal WhatsApp via la WhatsApp Business API, ce qui implique un numéro enregistré sur l'API, des modèles validés pour les messages hors de la fenêtre de 24 heures, et des frais par message. L'autre façon garde WhatsApp sur le numéro que vos clients utilisent déjà, avec Spun comme espace de travail WhatsApp, et relie WhatsApp et Freshdesk par un workflow dans votre propre n8n.

Cette page couvre la seconde voie, le workflow WhatsApp-Freshdesk : chaque conversation individuelle devient un ticket Freshdesk, les messages suivants y sont ajoutés, et la note publique d'un agent repart vers le client sur WhatsApp. Si toute votre activité de support passe déjà par Freshdesk et que la tarification de la Business API vous convient, le canal de Freshdesk lui-même est le choix le plus simple.

Ce que fait le workflow WhatsApp-Freshdesk

  • Chaque conversation WhatsApp individuelle devient un ticket avec la source Chat, les balises spun et whatsapp, et l'identifiant de la conversation Spun dans un champ personnalisé.
  • Le demandeur est associé à un contact Freshdesk par téléphone, puis par mobile, au format international. S'il n'y a pas de correspondance, un contact est créé avec le nom et le numéro uniquement. Les contacts existants ne sont jamais modifiés et aucune adresse e-mail n'est jamais ajoutée.
  • Les messages suivants sont ajoutés comme notes publiques du côté client du fil, précédés du nom et du numéro de l'expéditeur. Un ticket En attente ou Résolu repasse à Ouvert.
  • Les agents répondent par une note publique, et la note arrive chez le client sur WhatsApp sous forme de texte. Les notes privées restent internes.
  • Les réponses que votre équipe envoie depuis la boîte de réception Spun apparaissent comme notes privées, de sorte que les deux côtés peuvent répondre.
  • Archiver dans Spun ferme le ticket (ou le résout, selon un réglage), et désarchiver le rouvre. Fermer dans Freshdesk peut aussi archiver la conversation dans Spun, une option désactivée tant que vous ne l'activez pas.
  • Une fois un ticket Fermé, le message suivant ouvre un nouveau ticket qui mentionne le numéro du ticket précédent.

L'API de Freshdesk n'a pas de source de ticket WhatsApp, ces tickets utilisent donc la source Chat plus la balise whatsapp. Les rapports filtrés sur le canal WhatsApp de Freshdesk lui-même ne les incluent pas ; filtrez plutôt sur la balise.

Répondez par une note publique, pas avec le bouton Répondre

Sur un ticket WhatsApp, les agents répondent avec « Ajouter une note » et rendent la note publique. Le bouton Répondre envoie un e-mail, et un client créé par le workflow n'a pas d'adresse e-mail. C'est une note publique que la règle d'automatisation envoie au workflow, et c'est elle qui arrive chez le client sur WhatsApp.

La configuration, pas à pas

Il vous faut Freshdesk Growth ou supérieur pour la synchronisation bidirectionnelle, car les notes des agents atteignent le workflow par une règle d'automatisation qui appelle un webhook. Sur Free et Sprout, les messages WhatsApp deviennent quand même des tickets, mais les notes ne peuvent pas être renvoyées. Il vous faut aussi un administrateur Freshdesk, un agent d'intégration comme « Spun WhatsApp » avec sa propre clé API, et une instance n8n que Freshdesk et Spun peuvent joindre en HTTPS.

  1. 1

    Créez l'identifiant de la clé API

    Connecté en tant qu'agent d'intégration, copiez la clé API depuis les paramètres du profil et ajoutez-la dans n8n comme identifiant Basic Auth.

  2. 2

    Ajoutez un champ de ticket « Spun chat id »

    Un champ texte sur une ligne, non obligatoire pour les agents ni pour la fermeture, plus un champ « Spun line » facultatif.

  3. 3

    Importez le workflow

    Ouvrez son nœud Settings et collez l'URL de votre Freshdesk, le nom d'API du champ d'identifiant de conversation et l'identifiant de l'agent d'intégration.

  4. 4

    Choisissez l'URL de réponse et le secret

    Donnez au nœud de réponse un long chemin aléatoire, définissez une seconde chaîne aléatoire comme secret Freshdesk, et activez le workflow.

  5. 5

    Créez la règle d'automatisation

    Dans l'onglet des mises à jour de tickets (Ticket Updates), une règle qui s'exécute lorsqu'un agent ajoute une note sur un ticket portant la balise spun, et qui appelle l'URL de réponse du workflow avec l'en-tête X-Spun-Secret.

  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 fermeture dans Freshdesk 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. Un ticket apparaît dans Freshdesk ; répondez-y par une note publique et la réponse arrive sur le téléphone. Vérifiez les notifications e-mail des demandeurs pendant ce premier test.

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

Ce que vous devez savoir avant de construire

  • Freshdesk ne signe pas ses webhooks, le workflow vérifie donc un en-tête de secret partagé à chaque réponse. Les propres événements de Spun sont signés en HMAC.
  • Les médias entrent dans le ticket sous forme de lien valable 24 heures, pas comme pièce jointe. Les pièces jointes d'une note d'agent ne sont pas transmises.
  • Les conversations de groupe sont ignorées.
  • La limite d'API de Freshdesk s'applique par compte et par minute (Growth 100, Pro 400, Enterprise 700) et elle est partagée avec vos autres applications. Une nouvelle conversation prend jusqu'à 5 appels et un message suivant 2 ou 3. Freshdesk autorise 1 000 appels de webhook par heure et met le reste en file d'attente.
  • 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

Freshdesk peut-il créer des tickets à partir de messages WhatsApp ?

Oui. Avec Spun et le workflow n8n, chaque conversation WhatsApp individuelle devient un ticket Freshdesk lié à un contact associé par téléphone, et les messages suivants sont ajoutés à ce ticket.

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

Par une note publique sur le ticket. Une règle d'automatisation envoie la note au workflow, qui l'envoie au client sur WhatsApp depuis votre propre numéro. Le bouton Répondre envoie plutôt un e-mail, utilisez donc les notes publiques pour WhatsApp.

De quelle formule Freshdesk ai-je besoin ?

Growth ou supérieure pour la synchronisation bidirectionnelle, car les réponses passent par une règle d'automatisation avec une action webhook. Sur Free et Sprout, les messages WhatsApp deviennent quand même des tickets, mais les notes des agents ne peuvent pas être renvoyées sur WhatsApp.

Cela modifiera-t-il mes contacts Freshdesk existants ?

Non. Les contacts existants sont seulement associés par téléphone ou mobile, jamais modifiés, et le workflow n'ajoute jamais d'adresse e-mail. Les nouveaux contacts sont créés avec un nom et un numéro uniquement.

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

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.

WhatsApp sur votre numéro, les tickets dans Freshdesk

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