Il existe deux façons honnêtes de faire fonctionner WhatsApp avec Zendesk, et elles sont très différentes. La première voie est le canal WhatsApp de Zendesk lui-même : officiel, construit sur la Business API, ce qui implique un numéro dédié, des validations de modèles, des frais par message et aucun groupe WhatsApp. La seconde voie garde WhatsApp sur le numéro que vous utilisez déjà, avec Spun comme espace de travail WhatsApp, et un workflow WhatsApp-Zendesk dans votre propre n8n transforme chaque conversation en ticket Zendesk.
Cette page documente la seconde voie, et dit honnêtement quand la première convient mieux : si toute votre activité de support vit dans Zendesk et que vous voulez WhatsApp comme un canal de tickets de plus, aux conditions économiques de l'API, utilisez le canal de Zendesk. Si WhatsApp est votre principal canal client et que Zendesk n'est qu'un système parmi d'autres, le garder sur votre vrai numéro avec une boîte de réception d'équipe sert généralement mieux les clients.
1. Tickets Zendesk depuis WhatsApp : ce que fait le workflow
Chaque conversation WhatsApp individuelle sur la ligne devient un ticket Zendesk, sans étiquette à appliquer au préalable. Les messages suivants sont ajoutés au même ticket, et un commentaire public d'un agent repart vers le client sur WhatsApp.
- Le demandeur est un utilisateur Zendesk que le workflow retrouve ou crée à partir du numéro de téléphone du client, et le ticket est créé pour cet utilisateur.
- Les commentaires publics des agents dans Zendesk sont envoyés au client sur WhatsApp sous forme de texte, depuis votre propre numéro. Les commentaires privés restent internes.
- Les réponses que votre équipe envoie depuis la boîte de réception Spun deviennent des commentaires privés sur le ticket, de sorte que les deux côtés peuvent répondre et que le ticket conserve tout l'échange.
- Archiver la conversation dans Spun résout le ticket, et la désarchiver le rouvre. Résoudre dans Zendesk peut aussi archiver la conversation dans Spun, une option désactivée tant que vous ne l'activez pas. Dans un cas comme dans l'autre, le workflow n'envoie aucun message d'état au client.
- Chaque réponse est envoyée avec l'identifiant du commentaire Zendesk comme clé d'idempotence, de sorte qu'une réponse retentée n'est pas envoyée deux fois.
Les conversations de groupe sont ignorées. Les médias arrivent dans le ticket sous forme de lien valable 24 heures.
2. Configurez-le
Il vous faut un administrateur Zendesk capable de créer des webhooks, des déclencheurs et un client OAuth, un agent d'intégration comme « Spun WhatsApp », et une instance n8n que Zendesk et Spun peuvent joindre en HTTPS. Le guide de configuration liste chaque valeur et l'endroit où la trouver.
- 1
Créez un client OAuth
Connecté en tant qu'agent d'intégration, ajoutez un client OAuth dans le Centre d'administration de Zendesk et un identifiant OAuth2 dans n8n avec l'autorisation client credentials. Un jeton d'API sert de solution de repli.
- 2
Importez le workflow
Ouvrez son nœud Settings et collez l'URL de votre Zendesk et l'identifiant utilisateur de l'agent d'intégration. Un groupe, une marque et un champ de ticket « Spun line » sont facultatifs.
- 3
Créez le webhook Zendesk et le déclencheur de réponse
Un webhook pointé vers l'URL de réponse du workflow, et un déclencheur qui l'appelle lorsqu'un ticket portant la balise spun reçoit un commentaire public. Collez le secret de signature du webhook dans le workflow.
- 4
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 Zendesk doit archiver la conversation dans Spun.
- 5
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.
- 6
Envoyez un message de test
Écrivez à la ligne depuis un autre téléphone. Un ticket apparaît dans Zendesk ; répondez par un commentaire public et la réponse arrive sur le téléphone.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "14155552671",
"text": "Thanks for waiting, your replacement ships today.",
"idempotency_key": "<Zendesk comment id>"
}À lire aussi : Documentation : Zendesk via n8n, le guide de configuration complet · WhatsApp + n8n : l'API et les webhooks sous-jacents
Ce que vous devez savoir avant de construire
- C'est un pont, pas une fusion de canaux : les conversations WhatsApp vivent dans Spun, les tickets vivent dans Zendesk, et le workflow les garde alignés. Si vous avez besoin de WhatsApp comme canal Zendesk avec son propre numéro, c'est la première voie, avec ses coûts et ses limites.
- C'est un workflow n8n que vous importez, pas une application de la marketplace Zendesk. Le côté Spun utilise une clé API ; le côté Zendesk utilise un client OAuth.
- Fermer depuis Zendesk appelle les endpoints de fermeture et de réouverture de Spun, qui exigent la portée « Fermer & Rouvrir les Conversations » sur la clé.
- Zendesk autorise 30 mises à jour par ticket toutes les 10 minutes, 5 nouveaux utilisateurs par minute et 5 000 commentaires par ticket. L'API Spun autorise 60 requêtes par minute et par clé.
- 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.
- Beaucoup d'équipes découvrent que la couche de tickets était la partie facultative : les étiquettes, l'attribution et les tâches de Spun couvrent à elles seules le suivi des demandes par conversation. Consultez la page du helpdesk WhatsApp.
À lire aussi : WhatsApp comme helpdesk à part entière (sans Zendesk) · Toutes les intégrations WhatsApp avec un helpdesk · WhatsApp + Zapier et Make (l'API complète)