# Anrufdaten nach jedem Anruf per Webhook senden

> Richte für einen Agenten einen Webhook ein, damit qutee nach jedem Anruf die Anrufdaten als JSON an dein System schickt, zum Beispiel an n8n, Make oder Zapier.

Quelle: https://docs.qutee.ai/integrationen/webhook-nach-anruf/

Mit einem Webhook schickt qutee nach jedem Anruf eines Agenten die Anrufdaten an eine Adresse, die du festlegst. So können Werkzeuge wie n8n, Make oder Zapier oder dein eigenes System automatisch auf neue Anrufe reagieren, zum Beispiel einen Datensatz anlegen oder eine Nachricht verschicken.

## Bevor du loslegst

- Du brauchst die Rolle **Unternehmensadmin**. Andere Rollen sehen den Reiter **Webhook** nicht.
- Webhooks gehören zu den Integrationen und sind je nach Tarif verfügbar. Ist der Webhook in deinem Tarif nicht enthalten, kannst du ihn einrichten, er sendet aber erst nach einem Upgrade. Die App zeigt dann den Hinweis „Ihr Tarif enthält keine Integrationen. Der Webhook sendet erst nach einem Upgrade.“
- Du brauchst eine Empfangsadresse (URL), die öffentlich per HTTPS erreichbar ist, zum Beispiel den Webhook-Trigger eines n8n-, Make- oder Zapier-Workflows.
- Ein Webhook gilt für einen Agenten. Sollen mehrere Agenten senden, richtest du ihn bei jedem Agenten ein.

## Webhook einrichten

1. Öffne **Agenten** und wähle oben den Agenten aus.
2. Öffne den Reiter **Webhook**.
3. Trag unter **Webhook-URL** die Adresse deines Empfängers ein. Sie muss mit `https://` beginnen und auf eine öffentliche Adresse zeigen. Weiterleitungen werden nicht verfolgt.
4. Lass **Webhook aktiv** angehakt.
5. Entscheide, ob **Transkript mitsenden** angehakt bleibt. Dann enthält jede Nachricht auch das Transkript des Gesprächs. Das Transkript wird nur gesendet, wenn es je nach Tarif in deinem Unternehmen freigeschaltet ist.
6. Klicke auf **Webhook einrichten**.
7. Die App zeigt dein **Signier-Secret**. Klicke auf **Secret kopieren** und hinterlege es in deinem Empfänger. Das Secret wird nur dieses eine Mal angezeigt.
8. Klicke auf **Fertig**.

Ab jetzt schickt qutee nach jedem Anruf dieses Agenten eine Nachricht an deine URL, sobald Zusammenfassung, Tags und erfasste Informationen vorliegen. Das dauert nach Ende des Anrufs meist einen kleinen Moment.

## Was qutee sendet

Jede Nachricht ist ein HTTP-`POST` mit einem JSON-Body. Sie enthält die Daten des Anrufs, unter anderem die **Zusammenfassung**, die Tags, die **Erfassten Informationen** und, wenn eingeschaltet, das Transkript.

Am einfachsten siehst du den genauen Aufbau mit **Test senden** (siehe unten): Die Testnachricht hat denselben Aufbau wie eine echte, enthält aber Beispieldaten und ist als Test gekennzeichnet.

## Testnachricht senden

1. Klicke im Reiter **Webhook** auf **Test senden**. Hast du vorher etwas geändert, speichere zuerst mit **Speichern**.
2. Die App zeigt das Ergebnis, zum Beispiel „Test zugestellt: Ihr Server hat mit HTTP 200 geantwortet“ oder „Test nicht zugestellt“ mit dem Grund.

In n8n, Make oder Zapier kannst du die Testnachricht nutzen, um die Felder für deinen Workflow zuzuordnen.

## Absender prüfen (Signatur)

Damit dein Empfänger sicher sein kann, dass eine Nachricht wirklich von qutee kommt, ist jede Nachricht signiert. Die Signatur folgt dem offenen Standard „Standard Webhooks“, für den es fertige Bibliotheken in vielen Programmiersprachen gibt. Jede Nachricht trägt drei Kopfzeilen:

| Kopfzeile | Bedeutung |
| --- | --- |
| `webhook-id` | Eindeutige ID des Ereignisses. Sie bleibt bei Wiederholungen gleich, damit du doppelte Zustellungen erkennst. |
| `webhook-timestamp` | Sendezeitpunkt in Unix-Sekunden. Lehne Nachrichten ab, die älter als fünf Minuten sind. |
| `webhook-signature` | `v1,` gefolgt von der Base64-kodierten HMAC-SHA256-Signatur über `ID.Zeitstempel.Body`. Der Schlüssel ist der Base64-dekodierte Teil des Secrets nach `whsec_`. |

Diese Angaben findest du auch in der App im Reiter **Webhook** unter **Signatur prüfen und Wiederholungen**.

Hast du das Secret verloren oder befürchtest du, dass jemand es kennt, klicke auf **Secret erneuern**. Das bisherige Secret gilt dann sofort nicht mehr. Bis du das neue Secret im Empfänger hinterlegt hast, lehnt dein Empfänger die Nachrichten ab.

## Wenn eine Zustellung fehlschlägt

Dein Empfänger muss innerhalb von 10 Sekunden mit einem 2xx-Status antworten. Sonst versucht qutee es bis zu fünf weitere Male: nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 8 Stunden. Eine Nachricht kann dadurch mehr als einmal ankommen. Erkenne Doppel an der `webhook-id`.

Im Reiter **Webhook** siehst du:

- **Letzte erfolgreiche Zustellung** und **Letzter Fehler** für echte Anrufe (Testnachrichten zählen hier nicht),
- das **Zustellprotokoll** der letzten 30 Tage mit **Zeitpunkt**, **Ereignis**, **Status**, **Versuche** und **Antwort**. Mit **Erneut senden** schickst du ein Ereignis noch einmal, mit den aktuellen Anrufdaten und derselben ID.

qutee schaltet den Webhook selbst ab, wenn mehrere Anrufe in Folge nicht zugestellt werden konnten oder dein Server mit HTTP 410 antwortet. Die App zeigt dann den Grund. Prüfe deinen Empfänger und hake **Webhook aktiv** danach wieder an.

## Webhook pausieren oder entfernen

- **Pausieren**: Entferne den Haken bei **Webhook aktiv** und klicke auf **Speichern**. Für Anrufe in dieser Zeit sendet qutee nichts nach.
- **Entfernen**: Klicke auf **Webhook entfernen** und bestätige. qutee sendet für diesen Agenten keine Anrufe mehr, offene Wiederholungen werden abgebrochen.

## Häufige Probleme

**„Die URL muss mit https:// beginnen.“**: Unverschlüsselte `http://`-Adressen sind nicht erlaubt.

**„Die URL muss auf eine öffentliche Adresse zeigen. Interne Adressen sind nicht erlaubt.“**: qutee sendet nur an Adressen, die aus dem Internet erreichbar sind. Ein Server im Firmennetz braucht eine öffentliche Adresse, zum Beispiel über einen Reverse Proxy.

**„Ihr Server hat mit einer Weiterleitung geantwortet.“**: Trag die endgültige Adresse ein, auf die dein Server weiterleitet.

**Der Test kommt an, echte Anrufe nicht**: Prüfe, ob **Webhook aktiv** angehakt ist und ob dein Tarif Integrationen enthält. Im **Zustellprotokoll** steht bei nicht gesendeten Ereignissen der Grund.

## Weiter geht's

- [Mit welchen Systemen qutee zusammenarbeitet](https://docs.qutee.ai/integrationen/integrationen-ueberblick/)
- [Claude, ChatGPT und andere KI-Assistenten per MCP verbinden](https://docs.qutee.ai/integrationen/api-und-mcp/)
