1
Ouvrir les intégrations
Dans kChat, cliquez sur la roue dentée Paramètres en haut à droite (1). Dans la fenêtre Paramètres, cliquez sur Intégrations (2).
Créer des webhooks et bots dans kChat
Créez un webhook entrant pour qu'un outil externe publie dans un canal kChat, découvrez le formulaire des comptes de bot et supprimez une intégration devenue inutile.
Avancé
10 min
Mis à jour le 14 octobre 2026 FR
Avant de commencer
- Un accès à kChat avec les intégrations autorisées pour votre compte
- Être membre du canal qui recevra les messages (obligatoire pour un canal privé)
À retenir
- Chemin : kChat › Paramètres (roue dentée) › Intégrations.
- Un webhook entrant fournit une URL : tout outil qui l'appelle peut publier dans le canal choisi.
- L'URL du webhook est un secret : quiconque la connaît peut poster dans votre canal.
- Les Webhooks sortants, Commandes slash et Comptes de bot sont dans le même menu.
2
Choisir le type d'intégration
La page Intégrations propose quatre cartes :
- Webhooks entrants : des outils externes envoient des messages dans kChat ;
- Webhooks sortants : des outils externes reçoivent les messages et y répondent ;
- Commande slash : des commandes envoient des événements à des outils externes ;
- Comptes de bot : intégration via des extensions ou l'API.
Cliquez sur Webhooks entrants.
3
Ajouter un webhook entrant
Cliquez sur Ajouter un webhook entrant.
4
Remplir le formulaire
Renseignez :
- Titre (jusqu'à 64 caractères) et, si besoin, Description ;
- Canal : le canal qui recevra les messages par défaut ;
- Verrouiller le canal : cochez pour que le webhook ne puisse poster que dans ce canal.
Nom d'utilisateur et Photo de profil (URL d'une image .png ou .jpg d'au moins 128x128 px) sont facultatifs.
Cliquez sur Enregistrer (4).
Astuce : Conseil général : cochez Verrouiller le canal pour limiter ce que le webhook peut faire si son URL fuitait.
5
Copier l'URL du webhook
La page Installation réussie indique : « Le webhook entrant a été configuré. Envoyez les données à l'URL suivante ». Copiez l'URL avec l'icône de copie (1), puis cliquez sur Terminé (2).
Attention : Gardez cette URL secrète (pas de partage dans un ticket, un e-mail ou un dépôt de code public).
6
Retrouver le webhook dans la liste
Le webhook apparaît dans Webhooks entrants avec son URL et son créateur. Les liens Modifier et Supprimer permettent de le gérer.
Astuce : Conseil général / non testé : pour publier un message, l'outil externe envoie une requête POST en JSON à l'URL, par exemple :
``
curl -X POST -H 'Content-Type: application/json' -d '{"text": "Bonjour depuis mon outil"}' https://VOTRE-URL-DE-WEBHOOK
``
Cet envoi n'a pas été testé ; consultez le lien documentation de la page Installation réussie.
7
Découvrir le formulaire d'un compte de bot
Dans le menu de gauche, cliquez sur Comptes bots, puis sur Ajouter un compte de bot. Le formulaire demande :
- Nom d'utilisateur (minuscules, chiffres, points, tirets et tirets bas) ;
- Icône du bot (Envoyer une image) ;
- Nom d'affichage et Description (facultatifs) ;
- Rôle : Membre par défaut ou Administrateur système.
8
Choisir les autorisations du bot
Plus bas, cochez si besoin les autorisations additionnelles :
- message:tous : publier dans tous les canaux, y compris les messages personnels ;
- message:canaux : publier dans tous les canaux publics.
Cliquez sur Créer un compte de bot, ou sur Annuler.
Attention : Non testé pour ce tutoriel : aucun compte de bot n'a été créé (formulaire fermé avec Annuler) ; l'écran qui suit et la gestion du jeton du bot ne sont pas décrits. Conseil général : laissez le rôle Membre et n'accordez que les autorisations nécessaires.
9
Supprimer un webhook (facultatif)
Dans la liste Webhooks entrants, cliquez sur Supprimer à côté du webhook. Dans Supprimer l'intégration, cliquez sur Oui, le supprimer. La liste affiche ensuite « Aucun webhook entrant trouvé » s'il n'en reste aucun.
Attention : La suppression est définitive et « casse toutes les intégrations qui l'utilisent ». Supprimez aussi le webhook si son URL a fuité, puis recréez-en un.
Ça ne fonctionne pas ?
Le canal voulu n'apparaît pas dans la liste Canal
Pour un canal privé, vous devez en être membre. Rejoignez le canal puis rouvrez le formulaire.
Et les webhooks sortants et commandes slash ?
Non testé pour ce tutoriel : leurs pages (Webhooks sortants, Commandes slash) ont seulement été consultées, vides, avec les boutons Ajouter un webhook sortant et Ajouter une commande slash.
Certains libellés sont en anglais
Quelques textes restent en anglais dans l'interface (« Learn more », « No bot accounts found », « Bot Accounts »). Ils sont cités tels qu'affichés.
Ce tutoriel vous a-t-il aidé ?