{
"title": "Comment utiliser les webhooks Zendesk : Un guide complet pour 2026",
"slug": "zendesk-webhooks",
"locale": "fr",
"date": "2026-03-03",
"updated": "2026-03-03",
"template": "default",
"excerpt": "Un guide étape par étape pour créer, configurer et utiliser les webhooks Zendesk pour l'automatisation et les intégrations.",
"categories": [
"Zendesk",
"Guides"
],
"tags": [
"Zendesk",
"Webhooks",
"Automation",
"API",
"Customer Support"
],
"readTime": 10,
"author": 16,
"reviewer": 14,
"seo": {
"title": "Comment utiliser les webhooks Zendesk : Un guide complet pour 2026",
"description": "Un guide étape par étape pour créer, configurer et utiliser les webhooks Zendesk pour l'automatisation et les intégrations.",
"image": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-ee71d0eb-18f0-4def-bf53-f287cb019732"
},
"coverImage": "https://wmeojibgfvjvinftolho.supabase.co/storage/v1/object/public/public_assets/blog-gen/banner-ee71d0eb-18f0-4def-bf53-f287cb019732",
"coverImageAlt": "Image de bannière pour Comment utiliser les webhooks Zendesk : Un guide complet pour 2026",
"coverImageWidth": 1920,
"coverImageHeight": 1080,
"faqs": {
"heading": "Foire aux questions",
"type": "blog",
"answerType": "html",
"faqs": [
{
"question": "Ai-je besoin de compétences en codage pour utiliser les webhooks Zendesk ?",
"answer": "Les webhooks de base ne nécessitent pas de codage si vous vous connectez à des services qui prennent déjà en charge les intégrations Zendesk. Mais si vous créez des points de terminaison personnalisés ou si vous traitez des données de webhook, vous aurez besoin de quelques connaissances en développement. Pour les équipes non techniques, des outils comme eesel AI offrent une automatisation sans aucun codage."
},
{
"question": "Quelle est la différence entre les webhooks et les intégrations natives de Zendesk ?",
"answer": "Les intégrations natives sont des connexions pré-construites qui fonctionnent prêtes à l'emploi avec des applications spécifiques. Les webhooks vous offrent la flexibilité de vous connecter à n'importe quel système qui peut recevoir des requêtes HTTP, y compris les outils et services construits sur mesure sans prise en charge native de Zendesk."
},
{
"question": "Les webhooks Zendesk sont-ils sécurisés ?",
"answer": "Oui, lorsqu'ils sont correctement configurés. Utilisez toujours l'authentification (jetons Bearer ou clés API), activez HTTPS pour vos points de terminaison et envisagez de mettre en œuvre la vérification de la signature du webhook pour vous assurer que les requêtes proviennent réellement de Zendesk."
},
{
"question": "Puis-je utiliser les webhooks Zendesk pour mettre à jour les tickets automatiquement ?",
"answer": "Zendesk déconseille d'utiliser les webhooks pour mettre à jour directement les tickets, car cela peut entraîner des conditions de concurrence et des erreurs de limite de débit. Utilisez plutôt des déclencheurs et des automatisations pour les mises à jour de tickets, et réservez les webhooks pour les notifications et intégrations externes."
},
{
"question": "Combien de webhooks Zendesk puis-je créer ?",
"answer": "Cela dépend de votre plan. Les comptes d'essai sont limités à 10 webhooks. Les plans payants ont des limites plus élevées, bien que Zendesk ne publie pas de chiffres spécifiques. Si vous atteignez les limites, envisagez de consolider les webhooks ou d'utiliser une logique conditionnelle pour réduire le nombre dont vous avez besoin."
},
{
"question": "Que se passe-t-il si mon point de terminaison de webhook est hors service ?",
"answer": "Zendesk met en œuvre une logique de nouvelle tentative avec un backoff exponentiel. Si votre point de terminaison renvoie une erreur 5xx ou expire, Zendesk tentera de relancer la livraison plusieurs fois au cours des prochaines heures. Consultez vos journaux d'activité de webhook pour voir les tentatives de relance et les échecs éventuels."
}
],
"supportLink": null
}
}
---
Les webhooks sont l'un des outils d'automatisation les plus puissants de [Zendesk](https://www.zendesk.com). Ils permettent à votre plateforme de support de communiquer avec d'autres systèmes en temps réel, en envoyant des données là où elles doivent aller sans intervention manuelle.
Considérez un webhook comme un messager qui s'exécute entre les applications. Lorsque quelque chose se produit dans Zendesk (un ticket est créé, un utilisateur est mis à jour, une priorité change), le webhook transmet instantanément cette information à un autre système. Au lieu de vérifier les mises à jour toutes les quelques minutes, vos systèmes sont avertis dès que quelque chose se produit.
Ce guide vous explique tout ce que vous devez savoir sur les webhooks Zendesk : ce qu'ils sont, comment les configurer et comment les utiliser efficacement. Que vous connectiez Zendesk à Slack, que vous mettiez à jour un CRM ou que vous construisiez des intégrations personnalisées, vous trouverez des étapes pratiques que vous pouvez suivre immédiatement.
Si vous recherchez une automatisation sans la complexité technique des webhooks, des outils comme [eesel AI](https://www.eesel.ai/integration/zendesk-ai) offrent des intégrations Zendesk natives qui se chargent du gros du travail pour vous. Notre [Agent IA](https://www.eesel.ai/product/ai-agent) peut résoudre les tickets de manière autonome sans aucune configuration de webhook. Mais si vous voulez un contrôle total sur vos flux de données, les webhooks sont la solution.
## Étape 1 : Accéder à la section des webhooks dans le Centre d'administration Zendesk
Pour commencer, connectez-vous à votre compte Zendesk et accédez au Centre d'administration. Cliquez sur l'icône d'engrenage dans la barre latérale, puis allez dans **Applications et intégrations** > **Webhooks**. Pour plus de détails, consultez la [documentation officielle des webhooks Zendesk](https://support.zendesk.com/hc/en-us/articles/4408839108378).
Le tableau de bord des webhooks affiche tous vos webhooks existants, leur statut (actif ou inactif) et la date de leur dernier déclenchement. Si c'est la première fois que vous venez ici, la liste sera vide.
Prenez un moment pour vous familiariser avec l'interface. Vous verrez des options pour créer de nouveaux webhooks, modifier ceux qui existent et consulter les journaux d'activité. Les journaux d'activité sont particulièrement utiles lorsque vous dépannez des problèmes plus tard.
***
## Étape 2 : Créer un nouveau webhook
Cliquez sur le bouton **Créer un webhook** pour démarrer le processus de configuration. Vous verrez un formulaire avec plusieurs champs à configurer.
**Nommez votre webhook** avec quelque chose de descriptif. Vous vous remercierez plus tard lorsque vous aurez plusieurs webhooks et que vous devrez vous rappeler ce que chacun fait. « Notifications Slack pour les tickets urgents » est mieux que « Webhook 1 ».
**Choisissez votre méthode de connexion**. Zendesk offre deux façons de connecter les webhooks :
1. **Déclencheur ou automatisation** : le webhook se déclenche lorsque des conditions de ticket spécifiques sont remplies (comme lorsqu'un ticket de haute priorité est créé)
2. **Événements Zendesk** : le webhook s'abonne aux événements du système (comme lorsqu'un utilisateur est créé ou mis à jour)
La différence essentielle ? Les webhooks basés sur des déclencheurs vous donnent un contrôle précis sur le moment où ils se déclenchent. Les webhooks basés sur des événements se déclenchent pour chaque instance de ce type d'événement, sans filtrage au niveau de Zendesk.
**Important** : Une fois que vous avez créé un webhook, vous ne pouvez pas modifier sa méthode de connexion. Si vous commencez avec un webhook basé sur un déclencheur, il sera toujours basé sur un déclencheur. Choisissez soigneusement en fonction de votre cas d'utilisation.
Entrez l'**URL de votre point de terminaison** : c'est là que Zendesk enverra les données du webhook. Pour les tests, vous pouvez utiliser un service comme [webhook.site](https://webhook.site) pour voir les charges utiles. Pour la production, il doit s'agir de votre point de terminaison d'intégration réel.
***
## Étape 3 : Configurer les paramètres de la requête
Vous allez maintenant configurer la façon dont le webhook envoie les données à votre point de terminaison.
**Sélectionnez la méthode HTTP** en fonction de ce que votre point de terminaison attend :
- **POST** : le plus courant pour créer des ressources ou envoyer des données
- **PUT/PATCH** : pour mettre à jour les ressources existantes
- **GET** : pour récupérer des données (rarement utilisé avec les webhooks)
- **DELETE** : pour supprimer des ressources
Si vous vous connectez à des événements Zendesk (pas à des déclencheurs), vous devez utiliser POST. Les abonnements aux événements ne prennent pas en charge les autres méthodes HTTP.
**Choisissez votre format de requête** :
- **JSON** : la norme pour les API modernes, lisible par l'homme et largement pris en charge
- **XML** : format plus ancien, encore utilisé par certains systèmes d'entreprise
- **Formulaire encodé** : paires clé-valeur simples, utiles pour les intégrations de base
Encore une fois, les webhooks basés sur des événements nécessitent JSON. Seuls les webhooks basés sur des déclencheurs vous offrent une flexibilité de format.
**Configurez l'authentification**. La plupart des points de terminaison de production nécessitent une forme d'authentification. Zendesk prend en charge :
- **Jeton Bearer** : Zendesk envoie un en-tête `Authorization: Bearer <token>`
- **Authentification de base** : nom d'utilisateur et mot de passe encodés dans la requête
- **Clé API** : en-tête personnalisé avec votre clé API
- **Aucun** : pour les tests ou les points de terminaison publics uniquement
Pour l'authentification par jeton Bearer, collez votre jeton dans le champ. Zendesk gère le formatage de l'en-tête pour vous. Si vous utilisez un en-tête personnalisé pour les clés API, ajoutez-le dans la section des en-têtes personnalisés.
***
## Étape 4 : Tester votre webhook
Avant d'enregistrer votre webhook, testez-le pour vous assurer que tout fonctionne.
Cliquez sur **Tester le webhook** pour ouvrir le panneau de test. Vous verrez une charge utile d'exemple que Zendesk enverrait, ainsi que des options pour personnaliser les données de test.
Cliquez sur **Envoyer le test** et surveillez la réponse. Un test réussi affiche une coche verte avec un code d'état HTTP de niveau 200. Si vous voyez des erreurs, vérifiez :
- L'URL de votre point de terminaison est-elle correcte et accessible ?
- L'authentification est-elle correctement configurée ?
- Votre point de terminaison attend-il le bon format de requête ?
Les journaux d'activité des webhooks sont vos meilleurs amis pour le débogage. Allez dans **Centre d'administration** > **Webhooks** > [votre webhook] > **Activité** pour voir les tentatives de livraison, les codes de réponse et les messages d'erreur.
Les problèmes courants incluent :
- **Erreurs 401/403** : problèmes d'authentification, vérifiez vos jetons
- **Erreurs 404** : l'URL du point de terminaison est incorrecte ou le service est hors service
- **Erreurs 500** : votre point de terminaison plante, vérifiez les journaux de votre serveur
- **Délais d'attente** : votre point de terminaison est trop lent pour répondre (Zendesk attend 10 secondes)
Une fois votre test réussi, cliquez sur **Créer** pour enregistrer le webhook.
***
## Étape 5 : Se connecter à des déclencheurs ou à des événements
Votre webhook est créé, mais il ne fera rien tant que vous ne l'aurez pas connecté à un déclencheur, à une automatisation ou à un abonnement à un événement.
**Pour les webhooks basés sur des déclencheurs** :
1. Allez dans **Centre d'administration** > **Objets et règles** > **Déclencheurs** (ou **Automatisations**)
2. Créez un nouveau déclencheur ou modifiez-en un existant
3. Définissez vos conditions (par exemple, « La priorité est élevée » ET « Le statut est nouveau »)
4. Sous **Actions**, sélectionnez **Notifier le webhook actif** et choisissez votre webhook
5. Configurez la charge utile JSON à l'aide d'espaces réservés Zendesk tels que `{{ticket.id}}`, `{{ticket.requester.email}}` ou `{{ticket.subject}}`
**Pour les webhooks basés sur des événements** :
1. Modifiez votre webhook
2. Sous **Abonnements**, sélectionnez les événements auxquels vous souhaitez vous abonner
3. Les événements disponibles incluent les événements de ticket, les événements d'utilisateur, les événements d'organisation, et plus encore
4. Enregistrez vos modifications
N'oubliez pas : les webhooks basés sur des événements se déclenchent pour chaque instance de cet événement. Si vous vous abonnez à « ticket créé », vous recevrez un webhook pour chaque ticket. Assurez-vous que votre point de terminaison peut gérer le volume.
***
## Cas d'utilisation courants des webhooks Zendesk
Une fois que vous avez compris les bases, vous commencerez à voir des opportunités de webhook partout. Voici quelques-unes des façons les plus courantes dont les équipes utilisent les webhooks Zendesk :
**Notifications Slack pour les tickets urgents**
Lorsqu'un ticket de haute priorité arrive, publiez un message sur votre canal #support-urgent avec les détails du ticket et un lien direct. Cela permet à tout le monde d'être informé sans vérification constante de Zendesk.
**Mise à jour des systèmes CRM externes**
Lorsqu'un utilisateur est créé ou mis à jour dans Zendesk, synchronisez ces données avec Salesforce, HubSpot ou votre CRM personnalisé. Cela permet de maintenir la cohérence des enregistrements clients sur toutes les plateformes.
**Envoi de notifications SMS**
Connectez Zendesk à un service SMS comme [8x8](https://developer.8x8.com/connect/docs/zendesk-notifications-webhooks/) ou [Twilio](https://www.twilio.com/docs/usage/webhooks) pour envoyer aux clients des mises à jour proactives sur leurs tickets.
**Journalisation de l'entrepôt de données**
Envoyez tous les événements de ticket à un entrepôt de données comme Snowflake ou BigQuery pour l'analyse. Cela vous donne un historique complet de l'activité de support pour les rapports et l'apprentissage automatique.
**Actions automatisées sur les tickets via des appels d'API internes**
Utilisez les webhooks pour appeler l'API de Zendesk pour des mises à jour de tickets complexes que les déclencheurs ne peuvent pas gérer. Par exemple, copier des données entre des champs personnalisés ou mettre à jour des tickets connexes.
**Automatisation de la confidentialité et de la conformité**
Connectez-vous à des plateformes de confidentialité comme [Transcend](https://docs.transcend.io/docs/articles/dsr-automation/api-integration/webhook-in-zendesk) pour traiter automatiquement les demandes des personnes concernées lorsque les clients envoient un e-mail à votre équipe de support.
***
## Tester les webhooks localement avec ngrok
Vous créez un point de terminaison de webhook sur votre machine locale ? Vous aurez besoin d'un moyen de l'exposer à Internet pour que Zendesk puisse l'atteindre. C'est là que [ngrok](https://ngrok.com/docs/integrations/webhooks/zendesk-webhooks) entre en jeu.
ngrok crée un tunnel sécurisé d'une URL publique à votre localhost. Voici comment le configurer :
1. **Installer ngrok** : téléchargez-le depuis [ngrok.com](https://ngrok.com/download) et authentifiez-vous avec votre jeton d'authentification
2. **Démarrer votre serveur local** : exécutez votre point de terminaison de webhook sur localhost (généralement le port 3000 ou 8080)
3. **Démarrer ngrok** : exécutez `ngrok http 3000` (remplacez 3000 par votre port)
4. **Copier l'URL ngrok** : elle ressemble à `https://1a2b-3c4d.ngrok.app`
5. **Utiliser cette URL dans Zendesk** : collez-la comme point de terminaison de votre webhook
Maintenant, lorsque Zendesk envoie des webhooks, ils seront acheminés via ngrok vers votre machine locale. Vous pouvez inspecter la charge utile complète de la requête, les en-têtes et la réponse dans le tableau de bord ou le terminal ngrok.
Cette configuration est parfaite pour le développement et les tests. N'oubliez pas : les URL ngrok changent chaque fois que vous redémarrez ngrok (sauf si vous avez un plan payant avec des domaines réservés). Mettez à jour la configuration de votre webhook Zendesk si votre URL ngrok change.
***
## Dépannage des problèmes courants
Même avec une configuration soignée, les webhooks échouent parfois. Voici comment diagnostiquer et résoudre les problèmes courants :
**Webhook ne se déclenchant pas**
- Vérifiez vos conditions de déclenchement : sont-elles réellement remplies ?
- Vérifiez que le webhook est actif, pas en pause
- Consultez les journaux d'activité du webhook pour les tentatives de livraison
- Pour les webhooks basés sur des déclencheurs, testez le déclencheur séparément
**Échecs d'authentification**
- Vérifiez votre jeton Bearer ou votre clé API
- Vérifiez que le jeton n'a pas expiré
- Assurez-vous d'utiliser la bonne méthode d'authentification pour votre point de terminaison
- Vérifiez si votre point de terminaison attend l'authentification dans un format d'en-tête spécifique
**Limitation du débit**
Les comptes d'essai sont limités à 60 invocations de webhook par minute. Si vous dépassez cette limite, Zendesk bloquera temporairement les requêtes supplémentaires. Solutions :
- Passez à un plan Zendesk payant
- Regroupez vos appels de webhook
- Utilisez des conditions de déclenchement pour réduire le déclenchement inutile de webhooks
**Erreurs de format de charge utile**
- Vérifiez que votre point de terminaison attend le format que vous envoyez (JSON vs XML)
- Vérifiez que les champs obligatoires sont inclus dans votre charge utile
- Testez avec un outil comme Postman pour valider que votre point de terminaison fonctionne indépendamment
**Logique de nouvelle tentative et échecs de livraison**
Zendesk relance automatiquement les webhooks ayant échoué avec un backoff exponentiel. Si votre point de terminaison renvoie une erreur 5xx ou expire, Zendesk tentera de relancer plusieurs fois au cours des prochaines heures. Consultez les journaux de votre point de terminaison pour voir si les nouvelles tentatives atteignent votre serveur.
***
## Rationalisation de l'automatisation du support avec eesel AI
Les webhooks vous offrent une flexibilité, mais ils nécessitent également une configuration technique et une maintenance continue. Si vous recherchez une automatisation sans écrire de code ni gérer les points de terminaison, [eesel AI](https://www.eesel.ai/integration/zendesk-ai) offre une approche différente. Vous pouvez également explorer notre [Copilote IA](https://www.eesel.ai/product/ai-copilot) pour rédiger des réponses ou [Triage IA](https://www.eesel.ai/product/ai-triage) pour le routage automatisé des tickets.
Au lieu de créer des intégrations de webhook, vous invitez eesel AI dans votre équipe en tant que coéquipier IA. Il se connecte directement à Zendesk et apprend de vos tickets passés, des articles du centre d'aide et des macros. En quelques minutes, il comprend votre entreprise et peut commencer à traiter les tickets.
Vous pouvez commencer par eesel AI qui rédige des réponses que vos agents peuvent examiner. Au fur et à mesure qu'il fait ses preuves, vous l'élevez au niveau supérieur pour qu'il envoie des réponses directement, gère des types de tickets spécifiques ou travaille 24 heures sur 24, 7 jours sur 7. La progression est contrôlée : vous décidez quand étendre sa portée en fonction des performances réelles.
Pour les équipes qui utilisent déjà des webhooks, eesel AI peut compléter votre automatisation existante. Utilisez les webhooks pour les intégrations de système à système, et laissez eesel AI gérer la couche de conversation avec le client. Ensemble, ils créent une pile d'automatisation puissante qui couvre à la fois les flux de travail techniques et les interactions de support de type humain.
Si vous passez plus de temps à maintenir les intégrations de webhook qu'à en bénéficier, il peut être intéressant d'explorer si une approche native de l'IA correspond mieux à vos besoins.
Partager cet article
Article by
