Webhooks

Was sind Webhooks?

Webhooks ermöglichen es Hedy, Daten in Echtzeit an andere Apps und Dienste zu senden. Wenn ein Ereignis eintritt — wie das Ende einer Sitzung oder das Erstellen eines Highlights — sendet Hedy die Daten an eine von Ihnen angegebene URL. So können Sie leistungsstarke Automatisierungen ohne Programmierung erstellen.

Zum Beispiel könnten Sie automatisch:

• Besprechungstranskripte in Google Docs oder Notion speichern

• Sitzungszusammenfassungen in einen Slack-Kanal posten

• Aufgaben in Asana oder Todoist aus Aktionspunkten erstellen

• Sitzungsdaten in eine Tabellenkalkulation protokollieren

Voraussetzungen

• 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 anzeigen, benötigen es aber zum Erstellen, Bearbeiten oder Auslösen.

Einen Webhook einrichten

1. Öffnen Sie Hedy und gehen Sie zu Settings

2. Scrollen Sie zum Abschnitt API Access

3. Tippen Sie auf Manage Webhooks

4. Tippen Sie auf die +-Schaltfläche, um einen neuen Webhook hinzuzufügen

5. Geben Sie einen Namen ein (optional) — ein Label, das Ihnen hilft, den Zweck dieses Webhooks zu merken (z. B. “Zapier — Meeting-Notizen”)

6. Fügen Sie die Webhook-URL von Ihrem externen Dienst ein — dies muss eine HTTPS-URL sein

7. Wählen Sie die Ereignisse, die Sie abonnieren möchten (siehe unten)

8. Tippen Sie auf Create

Sie können bis zu 10 Webhooks erstellen.

Verfügbare Ereignisse

Wählen Sie, welche Ereignisse Ihren Webhook auslösen:

Session Created — Wird ausgelöst, wenn Sie eine neue Aufnahme starten. Sendet den Sitzungstitel und die Startzeit.

Session Ended — 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.

Session Exported — Wird ausgelöst, wenn Sie eine Sitzung manuell an Ihre Webhooks exportieren. Sendet ähnliche Daten wie Session Ended (Transkript, Zusammenfassung, Highlights usw.).

Highlight Created — Wird jedes Mal ausgelöst, wenn ein Highlight während einer Sitzung erfasst wird. Sendet den Highlight-Text, die KI-Erkenntnis und den Zeitstempel.

Todo Exported — Wird ausgelöst, wenn Sie eine Aufgabe 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:

1. Öffnen Sie eine abgeschlossene Sitzung

2. Tippen Sie auf Export to Webhook

3. Wenn Sie mehrere Webhooks haben, die das Ereignis Session Exported abonniert haben, wählen Sie aus, an welche gesendet werden soll

4. Bestätigen Sie den Export

Ihren Webhook testen

Bevor Sie sich auf einen Webhook verlassen, können Sie überprüfen, ob er funktioniert:

1. Gehen Sie zu Settings > API Access > Manage Webhooks

2. Tippen Sie auf die Test-Schaltfläche bei einem beliebigen Webhook

3. Hedy sendet einen Test-Payload an Ihre URL und zeigt an, ob der Versand erfolgreich war, zusammen mit dem Antwort-Statuscode

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 einem JSON-Body. Die Daten hängen vom Ereignistyp ab, aber ein Session Ended-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 KI-Erkenntnis, Zitat und Zeitstempel

• Thema — Der Themenname und die Erkenntnisse, falls die Sitzung einem Thema zugewiesen ist

Sicherheit & Verifizierung

Jede Webhook-Anfrage enthält eine Signatur, damit Sie überprüfen können, dass sie tatsächlich von Hedy stammt:

• X-Hedy-Signature-Header — Ein HMAC-SHA256-Hash des Anfragekörpers, signiert mit dem einzigartigen Secret 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 beliebten Plattformen nutzen

Zapier — Erstellen Sie einen Zap mit “Webhooks by Zapier” als Trigger. 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-Trigger hinzu. Kopieren Sie die generierte URL und fügen Sie sie in Hedy ein.

n8n — Fügen Sie einen “Webhook”-Trigger-Node 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 Wiederholungsversuche mit zunehmenden Verzögerungen

• Ratenbegrenzung (429) — Ein Wiederholungsversuch unter Berücksichtigung des Wiederholungszeitpunkts des Dienstes

• Clientfehler (4xx) — Keine Wiederholung, da diese typischerweise auf ein Konfigurationsproblem hinweisen

Fehlerbehebung

Webhook-Test schlägt fehl — Überprüfen Sie, ob die URL korrekt ist, HTTPS verwendet und Ihr externer Dienst aktiv auf Anfragen wartet.

Ereignisse werden nicht empfangen — Prüfen Sie, ob Cloud Sync aktiviert ist, der Webhook das richtige Ereignis abonniert hat und Ihr Pro-Abonnement aktiv ist.

Meldung “Webhooks require Pro” — Upgraden Sie auf Hedy Pro unter Settings > Subscription, um auf Webhooks zuzugreifen.

Meldung “Cloud Sync required” — Aktivieren Sie Cloud Sync unter Settings > Cloud Sync, oder tippen Sie auf die Enable-Schaltfläche im Warnhinweis oben auf dem Webhooks-Bildschirm.

Pro-Tipp: Beginnen Sie mit dem Abonnieren des Session Ended-Ereignisses — es enthält die umfassendsten Daten und ist am nützlichsten für den Aufbau von Automatisierungen rund um Ihre Besprechungsnotizen.