Canal de notification Webhook

Un canal de notification webhook dans Document360 est une méthode automatisée permettant d’envoyer des données d’événements en temps réel de votre base de connaissances vers une application externe chaque fois qu’une action spécifiée se produit. Les webhooks éliminent le besoin de surveillance manuelle en envoyant directement des charges utiles JSON structurées vers une URL de votre choix — comme un canal Slack, une intégration personnalisée ou une plateforme d’automatisation. Vous pouvez configurer plusieurs canaux webhook et associer chacun à des événements spécifiques de la base de connaissances via les paramètres de correspondance des notifications .

Quand utiliser les canaux de notification webhook

Utilisez les notifications webhook lorsque vous souhaitez automatiser la façon dont votre équipe ou les systèmes externes réagissent aux changements dans la base de connaissances.

• Alertes équipe : Prévenez une équipe support ou documentation sur Slack ou Microsoft Teams dès qu’un article est publié, mis à jour ou supprimé — sans que personne n’ait besoin de consulter manuellement le portail.
• Invalidation du cache : Détectez les événements de suppression d’articles (qui incluent les slugs pour toutes les langues) et supprimez automatiquement les entrées correspondantes de votre cache de contenu.
• Automatisation des flux de travail : déclenchez des processus en aval dans des outils comme Make ou Zapier lorsque des événements spécifiques surviennent, comme la publication d’un nouvel article ou la suppression d’un jeton d’extension.
• Audit et conformité : Transférer les activités de la base de connaissances vers un service de journalisation afin de maintenir une trace d’audit en temps réel de qui a modifié quoi et quand.

Avant que tu commences

• Ayez l’URL du webhook de destination prête — c’est le point de terminaison fourni par l’application réceptrice (par exemple, une URL de webhook entrante Slack, un webhook de scénario Make ou votre propre point de terminaison serveur).
• Si l’application réceptrice nécessite une authentification, obtenez la clé d’autorisation avant de commencer.

Comment configurer un canal de notification webhook

1. Naviguez dans Paramètres () > portail de la base de connaissances dans la barre de navigation de gauche.

2. Dans le panneau de navigation de gauche, sélectionnez Notifications.
   L’onglet Canaux de notifications est sélectionné par défaut.

3. Cliquez sur Nouvelle chaîne.

4. Dans le panneau Canaux disponibles , sélectionnez Webhook et cliquez sur Suivant.

   

   Le panneau de configuration des canaux apparaît.

5. Dans le champ Nom Amical , saisissez un nom unique pour ce canal webhook.

6. Dans la menu déroulante Méthode de demande , sélectionnez POST ou PUT selon les attentes de la demande réceptrice.

7. Dans le champ URL Webhook , saisissez l’URL de destination où les notifications doivent être envoyées.

8. Dans la liste déroulante Requête de contenu , choisissez le format du message pour la charge utile.

9. Si l’application réceptrice nécessite des en-têtes HTTP supplémentaires, cliquez sur Ajouter un nouvel en-tête () sous En-têtes par défaut et ajoutez chaque en-tête comme paire clé-valeur.

10. Si l’authentification est requise, saisissez la clé d’autorisation dans le champ correspondant.

11. Cliquez sur Enregistrer.

Le canal webhook est créé et listé sous les canaux de notification. Pour l’activer, allez dans l’onglet Notification et mappez le canal aux événements que vous souhaitez suivre.

Meilleures pratiques

• Utilisez des noms descriptifs amicaux qui identifient à la fois la destination et l’étendue de l’événement — par exemple, Slack-ArticlePublish ou Make-AllEvents — afin que les canaux soient faciles à distinguer lors de la cartographie des notifications.
• Ajustez chaque canal à un ensemble ciblé d’événements plutôt que de faire passer tous les événements par un seul webhook. Cela facilite la gestion des échecs et permet de réessayer indépendamment certains types d’événements.
• Sécurisez votre point de terminaison avec une clé d’autorisation chaque fois que l’application réceptrice la supporte, afin d’empêcher que des charges utiles non autorisées n’atteignent vos systèmes.
• Utilisez le champ Slugs dans les événements de suppression pour identifier et purger immédiatement les entrées de cache correctes dans toutes les langues lorsqu’un article est supprimé, évitant ainsi le contenu obsolète.

FAQ

{
  "Knowledge base name": "Document360 2.0",
  "Event": "Article settings saved",
  "User": "Matt Sterling",
  "User email": "matt.sterling@document360.co",
  "Logged on (UTC)": "09/12/2025 06:15:00",
  "Article name": "Getting Started",
  "Article id": "e1444f0x-0xx0-000x-xxx0-0x3f2bc3713c",
  "Language": "English",
  "Language code": "en",
  "Project version id": "55144000-0xxx-000x-0000-0x2346b3bms3",
  "Project version name": "1.0"
}

{
  "Knowledge base name": "My Knowledge Base",
  "Event": "Article deleted",
  "User": "John Doe",
  "User email": "johndoe@example.com",
  "Logged on (UTC)": "02/13/2026 10:57:16",
  "Article name": "Getting Started Guides",
  "Article id": "24a4e58a-9d64-453c-8f00-4159eb94b82e",
  "Language": "English",
  "Project version id": "0644e0fe-2ae1-4d16-a993-98b81524d5c4",
  "Language code": "en",
  "Slugs": [
    { "language": "en", "slug": "getting-started" },
    { "language": "fr", "slug": "demarrer" },
    { "language": "de", "slug": "erste-schritte" }
  ]
}

{
  "Knowledge base name": "Document360 2.0",
  "Event": "Extension token deleted",
  "User": "Matt Sterling",
  "User email": "matt.sterling@document360.co",
  "Logged on (UTC)": "09/12/2025 06:47:10",
  "Extension": "MAKE"
}