Création d’un Webhook dans Comunik KIT

Les Webhooks de Comunik KIT permettent de connecter le module de chat à des systèmes externes (CRM, ERP, outil de gestion, etc.) en temps réel.

Ils agissent comme des ponts automatisés : lorsqu’un événement survient dans Comunik KIT, une requête HTTP POST est envoyée à une URL cible définie dans votre application.

Cela permet par exemple :

• d'envoyer des alertes dans un groupe Comunik depuis un logiciel métier,
• de synchroniser des données entre plateformes,
• de déclencher des automatisations sans intervention humaine.

🎯 À quoi servent les Webhooks dans Comunik KIT ?

Voici quelques cas d’usage concrets :

• 📬 Envoyer un message automatique dans un groupe de discussion.
• 🔔 Notifier la création d’une tâche ou l’arrivée d’un nouveau prospect.
• 🔄 Synchroniser des informations entre Comunik KIT et un outil tiers.
• 🤖 Déclencher des actions dans un scénario automatisé (type bot, workflow...).

🛠️ Créer un Webhook dans un groupe de discussion

1. Accéder au menu Webhook

• Rendez-vous dans le groupe de discussion concerné.
• Cliquez sur les trois points ⋮ en haut à droite.
• Sélectionnez « Webhook ».

2. Lancer la création d’un bot

Dans la fenêtre latérale « Webhook » :

• Cliquez sur « Créer un bot » pour ouvrir le formulaire de configuration.

3. Remplir les informations du bot

Dans le formulaire :

• Nom : donnez un nom significatif au bot (ex. : Notifier CRM, Alerte RH, etc.).
• Logo : ajoutez une image d’illustration pour personnaliser l’apparence du bot dans la discussion.

Une fois ces éléments renseignés, cliquez sur « Créer ».

4. Récupérer le code généré

Après la création du bot, un code source PHP-cURL est automatiquement généré.

Ce script contient :

• L’URL API de notification,
• L’identifiant du bot,
• Un exemple de message à envoyer,
• Le token d’autorisation sécurisé.

5. Intégrer le code dans votre application

• Copiez ce code dans le script de votre application externe.
• Il servira de passerelle pour envoyer des messages vers le groupe, depuis n’importe quel système connecté.

6. Tester la connexion

• Cliquez sur la flèche de test située au-dessus du code.

• Si le Webhook fonctionne correctement, un message sera automatiquement posté dans le groupe de discussion concerné.

✅ Conseils pratiques

🧠 Donnez un nom explicite à chaque bot pour bien distinguer leur fonction (ex. : Bot-Facturation, Bot-Interventions).

⚙️ Testez chaque Webhook avec le bouton intégré avant de le connecter à un outil externe.

🔒 Ne communiquez jamais le token ni l’URL API publique : ces données donnent un accès direct à l’écriture dans votre espace Comunik.

🛠️ Mettez à jour votre script si l’architecture ou le fonctionnement de votre système externe évolue.

🧪 Pour des intégrations critiques, effectuez des tests dans un groupe dédié avant de passer en production.

❓ Questions fréquentes (FAQ)

1. Puis-je créer plusieurs Webhooks dans un seul groupe ?

✅ Oui. Vous pouvez ajouter autant de bots que nécessaire dans un groupe. Chaque bot peut être relié à un système ou à un usage différent.

2. Peut-on désactiver un Webhook sans le supprimer ?

❌ Non. Il n’est pas possible de désactiver un Webhook temporairement. Il faudra le supprimer, puis le recréer si nécessaire.

3. Que faire si le test échoue ?

🔧 Vérifiez votre connexion réseau, le token d’authentification, l’URL cible et que votre application est bien configurée pour recevoir des requêtes POST.

4. Un bot peut-il répondre à un message ?

🚫 Non. Les Webhooks dans Comunik KIT permettent uniquement d’envoyer des messages vers le chat, mais ne déclenchent aucune logique de réponse automatique.