Was sind Webhooks?
Webhooks ermöglichen es Hedy, Daten in Echtzeit an andere Apps und Dienste zu senden. Wenn ein Ereignis eintritt – beispielsweise wenn eine Sitzung endet oder ein Highlight erstellt wird – sendet Hedy die Daten an eine URL, die Sie angeben. Dies ermöglicht es Ihnen, leistungsstarke Automatisierungen ohne Programmierung zu erstellen.
Sie könnten zum Beispiel automatisch:
Besprechungsprotokolle in Google Docs oder Notion speichern
Sitzungszusammenfassungen in einen Slack-Kanal posten
Aufgaben in Asana oder Todoist aus Aktionspunkten erstellen
Sitzungsdaten in einer Tabelle protokollieren
Anforderungen
Hedy Pro-Abonnement — Webhooks sind eine Pro-Funktion
Cloud Sync aktiviert — Erforderlich, damit Hedy Webhook-Ereignisse über die Cloud verarbeiten kann
Sie können Ihre Webhooks ohne Cloud Sync einsehen, benötigen Cloud Sync jedoch, um sie zu erstellen, zu bearbeiten oder auszulösen.
Einrichten eines Webhooks
Öffnen Sie Hedy und gehen Sie zu Einstellungen
Scrollen Sie hinunter zum Abschnitt API-Zugriff
Tippen Sie auf Webhooks verwalten
Tippen Sie auf die Schaltfläche +, um einen neuen Webhook hinzuzufügen
Geben Sie einen Namen ein (optional) – eine Bezeichnung, um sich zu merken, wofür dieser Webhook bestimmt ist (z. B. „Zapier – Besprechungsnotizen")
Fügen Sie die Webhook-URL von Ihrem externen Dienst ein – dies muss eine HTTPS-URL sein
Wählen Sie die Ereignisse aus, die Sie abonnieren möchten (siehe unten)
Tippen Sie auf Erstellen
Sie können bis zu 10 Webhooks erstellen.
Verfügbare Ereignisse
Wählen Sie, welche Ereignisse Ihren Webhook auslösen:
Sitzung erstellt — Wird ausgelöst, wenn Sie eine neue Aufnahme starten. Sendet den Sitzungstitel und die Startzeit.
Sitzung beendet — Wird ausgelöst, wenn eine Aufnahme endet. Sendet die vollständigen Sitzungsdaten einschließlich Transkript, Zusammenfassung, Besprechungsprotokoll, Highlights und Themeninformationen. Dies ist das umfassendste Ereignis.
Sitzung exportiert — Wird ausgelöst, wenn Sie eine Sitzung manuell in Ihre Webhooks exportieren. Sendet ähnliche Daten wie „Sitzung beendet" (Transkript, Zusammenfassung, Highlights usw.).
Highlight erstellt — Wird jedes Mal ausgelöst, wenn während einer Sitzung ein Highlight erfasst wird. Sendet den Highlight-Text, die KI-Erkenntnis und den Zeitstempel.
Aufgabe exportiert — Wird ausgelöst, wenn Sie einen Aktionspunkt exportieren. Sendet den Aufgabentext, das Fälligkeitsdatum und die zugehörige Sitzung.
Manuelle Sitzungsexporte
Zusätzlich zu automatischen Ereignissen können Sie jede Sitzung manuell an Ihre Webhooks senden:
Öffnen Sie eine abgeschlossene Sitzung
Tippen Sie auf In Webhook exportieren
Wenn Sie mehrere Webhooks haben, die das Ereignis „Sitzung exportiert" abonniert haben, wählen Sie aus, an welche gesendet werden soll
Bestätigen Sie den Export
Testen Ihres Webhooks
Bevor Sie sich auf einen Webhook verlassen, können Sie überprüfen, ob er funktioniert:
Gehen Sie zu Einstellungen > API-Zugriff > Webhooks verwalten
Tippen Sie die Test-Schaltfläche auf einem beliebigen Webhook
Hedy sendet eine Test-Nutzlast an Ihre URL und zeigt an, ob sie erfolgreich war, zusammen mit dem Antwortstatuscode
Wenn der Test fehlschlägt, überprüfen Sie, ob die URL korrekt ist und Ihr externer Dienst bereit ist, Anfragen zu empfangen.
Welche Daten werden gesendet?
Jede Webhook-Anfrage ist ein HTTP POST mit JSON-Body. Die Daten hängen vom Ereignistyp ab, aber ein „Sitzung beendet"-Ereignis enthält:
Sitzungsdetails — Titel, Startzeit, Endzeit, Dauer
Transkript — Der vollständige Text Ihrer Sitzung
Gespräche — Strukturierter Sprecher-für-Sprecher-Dialog
Besprechungsprotokoll — Wichtige Diskussionspunkte
Zusammenfassung — Von KI generierte Zusammenfassung
Highlights — Jedes Highlight mit seiner KI-Erkenntnis, dem Zitat und dem Zeitstempel
Thema — Der Themenname und Erkenntnisse, falls die Sitzung einem Thema zugeordnet ist
Sicherheit & Verifizierung
Jede Webhook-Anfrage enthält eine Signatur, damit Sie überprüfen können, ob sie wirklich von Hedy stammt:
X-Hedy-Signature Header — Ein HMAC-SHA256-Hash des Anfragetexts, signiert mit Ihrem eindeutigen Webhook-Geheimnis
X-Hedy-Event Header — Der Ereignistyp (z. B. session.ended)
Alle Webhook-URLs müssen HTTPS verwenden, um sicherzustellen, dass Ihre Daten während der Übertragung verschlüsselt sind. Hedy sendet keine Daten an HTTP-Endpunkte.
Webhooks mit beliebten Plattformen verwenden
Zapier — Erstellen Sie einen Zap mit „Webhooks by Zapier" als Auslöser. Wählen Sie „Catch Hook", kopieren Sie die Webhook-URL und fügen Sie sie in Hedy ein.
Make (ehemals Integromat) — Fügen Sie ein Modul „Custom Webhook" als Szenario-Auslöser hinzu. Kopieren Sie die generierte URL und fügen Sie sie in Hedy ein.
n8n — Fügen Sie einen Webhook-Auslöser-Knoten zu Ihrem Workflow hinzu. Kopieren Sie die Produktions-URL und fügen Sie sie in Hedy ein.
Zustellung & Wiederholungen
Hedy versucht fehlgeschlagene Zustellungen automatisch erneut:
Serverfehler (5xx) — Wird bis zu 2-mal mit zunehmenden Verzögerungen wiederholt
Rate Limited (429) — Wird einmal wiederholt und respektiert dabei die Wiederholungsfrist des Dienstes
Clientfehler (4xx) — Keine Wiederholung, da diese normalerweise auf ein Konfigurationsproblem hindeuten
Problembehandlung
Webhook-Test schlägt fehl — Überprüfen Sie, ob die URL korrekt ist, HTTPS verwendet und dass Ihr externer Dienst aktiv auf Anfragen wartet.
Ereignisse nicht empfangen — Überprüfen Sie, ob Cloud Sync aktiviert ist, der Webhook das richtige Ereignis abonniert hat und dass Ihr Pro-Abonnement aktiv ist.
Meldung „Webhooks benötigen Pro" — Führen Sie in Einstellungen > Abonnement ein Upgrade auf Hedy Pro durch, um auf Webhooks zuzugreifen.
Meldung „Cloud Sync erforderlich" — Aktivieren Sie Cloud Sync in Einstellungen > Cloud Sync, oder tippen Sie auf die Schaltfläche Aktivieren auf dem Warnbanner oben auf dem Webhooks-Bildschirm.
Profi-Tipp: Beginnen Sie damit, das Ereignis Sitzung beendet zu abonnieren – es enthält die umfassendsten Daten und ist am nützlichsten für die Erstellung von Automatisierungen rund um Ihre Besprechungsnotizen.