Webhooks

Que sont les webhooks ?

Les webhooks permettent à Hedy d’envoyer des données à d’autres applications et services en temps réel. Lorsqu’un événement se produit — comme la fin d’une session ou la création d’un point important — Hedy envoie les données à une URL que vous spécifiez. Cela vous permet de créer des automatisations puissantes sans aucun code.

Par exemple, vous pourriez automatiquement :

• Sauvegarder les transcriptions de réunion dans Google Docs ou Notion

• Publier les récapitulatifs de session dans un canal Slack

• Créer des tâches dans Asana ou Todoist à partir des actions à mener

• Enregistrer les données de session dans un tableur

Prérequis

• Abonnement Hedy Pro — Les webhooks sont une fonctionnalité Pro

• Cloud Sync activé — Nécessaire pour que Hedy puisse traiter les événements webhook via le cloud

Vous pouvez consulter vos webhooks sans Cloud Sync, mais vous devez l’activer pour les créer, les modifier ou les déclencher.

Configurer un webhook

1. Ouvrez Hedy et accédez à Settings

2. Faites défiler jusqu’à la section API Access

3. Appuyez sur Manage Webhooks

4. Appuyez sur le bouton + pour ajouter un nouveau webhook

5. Saisissez un nom (optionnel) — un libellé pour vous rappeler l’utilité de ce webhook (par ex. « Zapier — Meeting Notes »)

6. Collez l’URL du webhook provenant de votre service externe — il doit s’agir d’une URL HTTPS

7. Sélectionnez les événements auxquels vous souhaitez vous abonner (voir ci-dessous)

8. Appuyez sur Create

Vous pouvez créer jusqu’à 10 webhooks.

Événements disponibles

Choisissez les événements qui déclenchent votre webhook :

Session Created — Se déclenche lorsque vous démarrez un nouvel enregistrement. Envoie le titre de la session et l’heure de début.

Session Ended — Se déclenche lorsqu’un enregistrement se termine. Envoie les données complètes de la session, y compris la transcription, le récapitulatif, le compte rendu de réunion, les points importants et les informations du sujet. C’est l’événement le plus complet.

Session Exported — Se déclenche lorsque vous exportez manuellement une session vers vos webhooks. Envoie des données similaires à Session Ended (transcription, récapitulatif, points importants, etc.).

Highlight Created — Se déclenche chaque fois qu’un point important est capturé pendant une session. Envoie le texte du point important, l’analyse IA et l’horodatage.

Todo Exported — Se déclenche lorsque vous exportez une action à mener. Envoie le texte de la tâche, la date d’échéance et la session associée.

Exporter manuellement une session

En plus des événements automatiques, vous pouvez envoyer manuellement n’importe quelle session à vos webhooks :

1. Ouvrez une session terminée

2. Appuyez sur Export to Webhook

3. Si vous avez plusieurs webhooks abonnés à l’événement Session Exported, sélectionnez ceux auxquels envoyer

4. Confirmez l’export

Tester votre webhook

Avant de compter sur un webhook, vous pouvez vérifier qu’il fonctionne :

1. Rendez-vous dans Settings > API Access > Manage Webhooks

2. Appuyez sur le bouton test sur n’importe quel webhook

3. Hedy envoie un payload de test à votre URL et indique si l’envoi a réussi, avec le code de statut de la réponse

Si le test échoue, vérifiez que l’URL est correcte et que votre service externe est prêt à recevoir des requêtes.

Quelles données sont envoyées ?

Chaque requête webhook est un HTTP POST avec un corps JSON. Les données dépendent du type d’événement, mais un événement Session Ended inclut :

• Détails de la session — Titre, heure de début, heure de fin, durée

• Transcription — Le texte intégral de votre session

• Conversations — Dialogue structuré intervenant par intervenant

• Compte rendu de réunion — Points de discussion clés

• Récapitulatif — Résumé généré par l’IA

• Points importants — Chaque point important avec son analyse IA, sa citation et son horodatage

• Sujet — Le nom du sujet et les analyses, si la session est attribuée à un sujet

Sécurité et vérification

Chaque requête webhook inclut une signature pour que vous puissiez vérifier qu’elle provient bien de Hedy :

• En-tête X-Hedy-Signature — Un hash HMAC-SHA256 du corps de la requête, signé avec le secret unique de votre webhook

• En-tête X-Hedy-Event — Le type d’événement (par ex. session.ended)

Toutes les URL de webhook doivent utiliser HTTPS pour garantir que vos données sont chiffrées en transit. Hedy n’enverra pas de données vers des endpoints HTTP.

Utiliser les webhooks avec les plateformes populaires

Zapier — Créez un Zap avec « Webhooks by Zapier » comme déclencheur. Choisissez « Catch Hook », copiez l’URL du webhook et collez-la dans Hedy.

Make (anciennement Integromat) — Ajoutez un module « Custom Webhook » comme déclencheur de votre scénario. Copiez l’URL générée et collez-la dans Hedy.

n8n — Ajoutez un noeud déclencheur « Webhook » à votre workflow. Copiez l’URL de production et collez-la dans Hedy.

Livraison et tentatives de renvoi

Hedy réessaie automatiquement les livraisons échouées :

• Erreurs serveur (5xx) — Jusqu’à 2 tentatives de renvoi avec des délais croissants

• Limitation de débit (429) — Une tentative de renvoi, en respectant le délai de retry du service

• Erreurs client (4xx) — Pas de renvoi, car elles indiquent généralement un problème de configuration

Dépannage

Le test du webhook échoue — Vérifiez que l’URL est correcte, utilise HTTPS, et que votre service externe écoute activement les requêtes.

Les événements ne sont pas reçus — Vérifiez que Cloud Sync est activé, que le webhook est abonné au bon événement et que votre abonnement Pro est actif.

Message « Webhooks require Pro » — Passez à Hedy Pro dans Settings > Subscription pour accéder aux webhooks.

Message « Cloud Sync required » — Activez Cloud Sync dans Settings > Cloud Sync, ou appuyez sur le bouton Enable sur la bannière d’avertissement affichée en haut de l’écran Webhooks.

Astuce Pro : Commencez par vous abonner à l’événement Session Ended — il inclut les données les plus complètes et est le plus utile pour construire des automatisations autour de vos notes de réunion.