Was sind Webhooks?
Webhooks ermöglichen es Hedy, Daten in Echtzeit an andere Apps und Dienste zu senden. Wenn ein Ereignis eintritt – wie das Beenden einer Sitzung oder das Erstellen eines Highlights – sendet Hedy die Daten an eine von Ihnen angegebene URL. Dies ermöglicht es Ihnen, leistungsstarke Automatisierungen ohne Programmierung zu erstellen.
Sie könnten zum Beispiel automatisch:
Besprechungstranskripte in Google Docs oder Notion speichern
Sitzungszusammenfassungen in einem Slack-Kanal posten
Aufgaben in Asana oder Todoist aus Aktionspunkten erstellen
Sitzungsdaten in einer Tabelle protokollieren
Voraussetzungen
Hedy Pro-Abonnement — Webhooks sind eine Pro-Funktion
Cloud-Synchronisierung aktiviert — Erforderlich, damit Hedy Webhook-Ereignisse über die Cloud verarbeiten kann
Sie können Ihre Webhooks ohne Cloud-Synchronisierung anzeigen, aber Sie müssen sie aktiviert haben, um sie zu erstellen, zu bearbeiten oder auszulösen.
Einen Webhook einrichten
Öffnen Sie Hedy und gehen Sie zu den Einstellungen
Scrollen Sie nach unten 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, die Ihnen hilft, sich zu erinnern, wofür dieser Webhook gedacht ist (z. B. „Zapier — Besprechungsnotizen“)
Fügen Sie die Webhook-URL Ihres externen Dienstes 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 aus, 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 beendet wird. 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 an 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.
Eine Sitzung manuell exportieren
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
Ihren Webhook testen
Bevor Sie sich auf einen Webhook verlassen, können Sie verifizieren, dass er funktioniert:
Gehen Sie zu Einstellungen > API-Zugriff > Webhooks verwalten
Tippen Sie bei einem beliebigen Webhook auf die Schaltfläche Testen
Hedy sendet eine Test-Payload an Ihre URL und zeigt an, ob dies erfolgreich war, zusammen mit dem Antwort-Statuscode
Wenn der Test fehlschlägt, prüfen Sie erneut, ob die URL korrekt ist und ob Ihr externer Dienst bereit ist, Anfragen zu empfangen.
Welche Daten werden gesendet?
Jede Webhook-Anfrage ist ein HTTP-POST mit einem 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 Dialog nach Sprechern
Besprechungsprotokoll — Wichtige Diskussionspunkte
Zusammenfassung — KI-generierte Zusammenfassung
Highlights — Jedes Highlight mit seiner KI-Erkenntnis, dem Zitat und dem Zeitstempel
Thema — Der Themenname und die Erkenntnisse, falls die Sitzung einem Thema zugeordnet ist
Sicherheit & Verifizierung
Jede Webhook-Anfrage enthält eine Signatur, damit Sie verifizieren können, dass sie tatsächlich von Hedy stammt:
X-Hedy-Signature-Header — Ein HMAC-SHA256-Hash des Anfrage-Bodys, signiert mit dem eindeutigen Geheimnis Ihres Webhooks
X-Hedy-Event-Header — Der Ereignistyp (z. B. session.ended)
Alle Webhook-URLs müssen HTTPS verwenden, um sicherzustellen, dass Ihre Daten bei der Übertragung verschlüsselt sind. Hedy sendet keine Daten an HTTP-Endpunkte.
Webhooks mit gängigen Plattformen nutzen
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 „Custom Webhook“-Modul 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öserknoten zu Ihrem Workflow hinzu. Kopieren Sie die Produktions-URL und fügen Sie sie in Hedy ein.
Zustellung & Wiederholungsversuche
Hedy wiederholt fehlgeschlagene Zustellungen automatisch:
Serverfehler (5xx) — Bis zu 2-malige Wiederholung mit zunehmenden Verzögerungen
Rate limited (429) — Einmalige Wiederholung unter Berücksichtigung der Wiederholungszeit des Dienstes
Clientfehler (4xx) — Keine Wiederholung, da diese in der Regel auf ein Konfigurationsproblem hinweisen
Fehlerbehebung
Webhook-Test schlägt fehl — Verifizieren Sie, ob die URL korrekt ist, HTTPS verwendet und ob Ihr externer Dienst aktiv auf Anfragen wartet.
Kein Empfang von Ereignissen — Prüfen Sie, ob die Cloud-Synchronisierung aktiviert ist, der Webhook das richtige Ereignis abonniert hat und ob 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-Synchronisierung erforderlich“ — Aktivieren Sie die Cloud-Synchronisierung unter Einstellungen > Cloud-Synchronisierung oder tippen Sie auf die Schaltfläche Aktivieren im Warnbanner oben im Webhook-Bildschirm.
Pro-Tipp: Beginnen Sie mit dem Abonnieren des Ereignisses Sitzung beendet — es enthält die umfassendsten Daten und ist am nützlichsten für die Erstellung von Automatisierungen rund um Ihre Besprechungsnotizen.