Plans prenant en charge cette fonctionnalité : Professional Business Enterprise
Un Webhook est une méthode permettant d’envoyer automatiquement des données en temps réel d’une application à une autre lorsque des événements spécifiques surviennent. Les webhooks dans Document360 vous permettent d’envoyer des notifications à d’autres applications, tenant votre équipe informée des changements dans le portail, le site ou le widget de la base de connaissances.
Par exemple, votre équipe de support utilise un outil de communication comme Slack. En créant un Webhook, vous pouvez informer instantanément l’équipe lorsqu’un article est mis à jour, en vous assurant que tout le monde dispose des dernières informations sans avoir à vérifier manuellement les mises à jour.
Mise en place d’un canal de notifications Webhook
Pour configurer un canal de notification Webhook dans Document360, suivez les étapes ci-dessous :
Naviguez dans () > Knowledge base portal dans la barre de navigation de gauche du portail de la base de connaissances.
Dans le panneau de navigation de gauche, Notifications.
Par défaut, l’onglet Canaux de notification sera sélectionné.
Cliquez sur Nouvelle chaîne.
Dans le panneau Canaux disponibles , sélectionnez Webhook et cliquez sur Suivant.
Le panneau de configuration des canaux apparaîtra.
Dans le champ Nom Amical , saisissez un nom unique pour votre chaîne Webhook.
Dans la liste déroulante de la méthode de requête , sélectionnez POST ou PUT, selon la manière dont vous souhaitez envoyer les données.
Dans le champ URL Webhook , saisissez l’URL de l’application où vous souhaitez envoyer les notifications.
Choisissez le format de message souhaité dans la menu déroulante Demander contenu.
Si des en-têtes supplémentaires sont nécessaires, cliquez sur Ajouter un nouveau () sous les en-têtes par défaut et ajoutez-les.
En option, saisissez la clé d’autorisation si l’application réceptrice nécessite une authentification.
Cliquez sur Enregistrer.
NOTE
Pour plus d’informations, voir l’en-tête Demande.
Une fois que vous avez enregistré, un nouveau canal de notification Webhook avec votre nom spécifié est créé. Maintenant, allez dans l’onglet Notification de mappage pour mapper les configurations avec votre application Webhook en fonction de vos besoins.
FAQ
Quelles informations sont incluses dans une notification Webhook ?
Lorsqu’un Webhook est déclenché, Document360 envoie une charge utile JSON structurée à l’URL configurée. La charge utile contient les détails des événements, l’utilisateur ayant effectué l’action, ainsi que des métadonnées concernant l’article ou le projet.
Pouvez-vous me montrer un exemple de charge utile ?
Oui. Voici un exemple de charge utile pour l’événement « Article publié » :
{
"Knowledge base name": "Document360 2.0",
"Event": "Article published",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:01:04",
"Article name": "Webhook notification test",
"Article id": "e1444f0x-0xx0-000x-xxx0-0x3f2bc3713c",
"Article URL": "https://Document3602.0/document360.io/docs/en/webhook-notification-test",
"Language": "English",
"Project version id": "55144000-0xxx-000x-0000-0x2346b3bms3",
"Language code": "en"
}Les champs de la charge utile sont :
Nom de la base de connaissances : Le nom du projet de la base de connaissances.
Événement : Le type d’action qui a déclenché le Webhook (par exemple, article publié).
Utilisateur / Email utilisateur : Le membre de l’équipe qui a effectué l’action.
Connecté (UTC) : Date et heure de l’action, en UTC.
Nom de l’article / Identifiant de l’article / URL de l’article : Détails et lien vers l’article concerné.
Langue / Code linguistique : Le langage de l’article.
ID de la version du projet : Identifiant pour la version de la base de connaissances.
Les charges utiles diffèrent-elles pour d’autres événements (par exemple, article mis à jour, supprimé) ?
Oui, la structure de la charge utile reste similaire, mais le champ Événement change selon l’action — par exemple, Article mis à jour ou Article supprimé. Non seulement le champ événement, mais aussi d’autres champs comme les détails utilisateur, les détails de l’article et la version du projet peuvent également varier. Par exemple :
{
"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"
}{
"Knowledge base name": "Document360 2.0",
"Event": "Widget setting created",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:47:36",
"Widget setting name": "Knowledge base widget"
}{
"Knowledge base name": "Document360 2.0",
"Event": "Drive folder added",
"User": "Matt sterling",
"User email": "matt.sterling@document360.co",
"Logged on (UTC)": "09/12/2025 06:48:08",
"Folder name": "Media"
}