Gérer les webhooks

Les webhooks envoient les événements Klang à votre serveur. Utilisez-les pour mettre à jour un CRM, publier dans un chat ou lancer un processus lorsqu’une réunion est traitée.

Chaque webhook est personnel et reçoit uniquement les événements des contenus auxquels son propriétaire a accès.

Créer un webhook

1. Ouvrez Paramètres → Développeurs → Webhooks
2. Cliquez sur Créer un webhook

3. Saisissez l’URL publique HTTPS qui recevra les événements
4. Facultatif : ajoutez une Description
5. Sélectionnez les événements auxquels vous abonner ; les trois sont cochés par défaut
6. Cliquez sur Créer

Klang affiche une fois le secret de signature. Copiez-le et conservez-le en lieu sûr afin de vérifier que les requêtes proviennent bien de Klang.

Événements disponibles

• conversation.ready : la transcription et l’analyse IA sont prêtes
• conversation.failed : le traitement d’une réunion ou d’un fichier a échoué
• conversation.deleted : une réunion ou un fichier a été supprimé

Chaque charge utile comprend un identifiant, le type et une référence à la conversation. Consultez la documentation des webhooks pour le schéma, l’en-tête de signature et des exemples de vérification.

Surveiller les livraisons

Cliquez sur un webhook pour ouvrir ses détails.

La page affiche :

• État et URL, avec un bouton de suspension
• Secret de signature, avec Afficher et Copier
• Statistiques sur 24 heures : livraisons, taux d’erreur, temps de réponse moyen et activité
• Dernières livraisons : corps de la requête et réponse de votre serveur pour chaque tentative

Klang réessaie jusqu’à six fois avec un délai croissant. Le webhook est automatiquement suspendu après 25 échecs consécutifs. Corrigez le point de terminaison, puis réactivez Recevoir les événements.

Envoyer un événement de test

1. Ouvrez la page de détail
2. Cliquez sur Envoyer un événement de test
3. Si plusieurs événements sont sélectionnés, choisissez-en un
4. Observez la nouvelle ligne dans Dernières livraisons

Les tests portent la mention TEST et un identifiant commençant par evt_test_. Leur schéma est identique à celui des événements réels.

Suspendre ou supprimer

• Désactivez Recevoir les événements pour suspendre les envois tout en conservant l’historique.
• Cliquez sur Modifier, puis Supprimer le webhook pour le supprimer.

Ces actions sont aussi disponibles dans le menu … de la liste.

Prochaines étapes

• Consultez la documentation des webhooks
• Gérez vos intégrations pour utiliser des services comme Slack
• Créez un flux pour transformer un contenu avant son envoi