---
title: "Webhooks"
description: "Werde benachrichtigt, sobald ein Auftrag fertig ist, und prüfe, dass Webhooks echt sind."
url: https://help.samsa.ai/de/articles/142-webhooks
collection: "API & MCP"
updated: 2026-07-07
language: de
alternates: [en, fr, it]
---

# Webhooks

Werde benachrichtigt, sobald ein Auftrag fertig ist, und prüfe, dass Webhooks echt sind.

## Webhooks

Bild- und Video-Aufträge laufen im Hintergrund. Statt ständig zu prüfen, ob ein Auftrag fertig ist, kannst du Samsa **deine App in dem Moment benachrichtigen lassen, in dem er fertig ist**. Genau dafür sind Webhooks da.

### Wie es funktioniert

Wenn du eine Generierung über die API startest, kannst du eine **Webhook-URL** angeben — eine Adresse in deiner eigenen App. Sobald der Auftrag fertig ist, sendet Samsa eine Nachricht an diese Adresse mit dem Ergebnis, sodass deine App sofort reagieren kann. Wie du die Webhook-URL genau angibst, steht im [Webhooks-Guide](https://docs.samsa.ai/guides/webhooks) in den Entwicklerdocs (öffnet in einem neuen Tab).

### Prüfen, dass eine Nachricht wirklich von Samsa kommt

Damit du den Benachrichtigungen vertrauen kannst, **signiert** Samsa jeden Webhook und gibt dir ein **Webhook-Signatur-Secret**, mit dem du diese Signatur überprüfst.

So findest du dein Secret:

1.  Öffne **Organisationseinstellungen** > **API-Schlüssel**.
    
2.  Suche das **Webhook-Signatur-Secret** und wähle **Anzeigen** (oder **Kopieren**).
    

Halte dieses Secret geheim, genau wie einen API-Schlüssel. Deine App nutzt es, um zu bestätigen, dass jede eingehende Nachricht echt ist — die Schritt-für-Schritt-Überprüfung steht im [Webhooks-Guide](https://docs.samsa.ai/guides/webhooks) (öffnet in einem neuen Tab).

### Gut zu wissen

-   Webhooks sind **optional** — du kannst den Status eines Auftrags jederzeit auch selbst abfragen.
    
-   Wenn du glaubst, dass dein Signatur-Secret offengelegt wurde, behandle es wie einen Schlüssel: erneuere es und aktualisiere deine App.
