---
title: "Webhooks"
description: "Sois notifié dès qu'une tâche se termine, et vérifie que les webhooks viennent de Samsa."
url: https://help.samsa.ai/fr/articles/142-webhooks
collection: "API & MCP"
updated: 2026-07-07
language: fr
alternates: [en, de, it]
---

# Webhooks

Sois notifié dès qu'une tâche se termine, et vérifie que les webhooks viennent de Samsa.

## Webhooks

Les tâches d'image et de vidéo s'exécutent en arrière-plan. Plutôt que de vérifier sans cesse si une tâche est terminée, tu peux demander à Samsa de **notifier ton app au moment où elle se termine**. C'est à ça que servent les webhooks.

### Comment ça marche

Quand tu lances une génération via l'API, tu peux inclure une **URL de webhook** — une adresse dans ta propre app. Dès que la tâche se termine, Samsa envoie un message à cette adresse avec le résultat, pour que ton app puisse réagir immédiatement. La façon exacte d'inclure l'URL de webhook est détaillée dans le [guide des webhooks](https://docs.samsa.ai/guides/webhooks) de la documentation développeur (s'ouvre dans un nouvel onglet).

### Vérifier qu'un message vient bien de Samsa

Pour que tu puisses faire confiance aux notifications, Samsa **signe** chaque webhook et te fournit un **secret de signature webhook** pour vérifier cette signature.

Pour trouver ton secret :

1.  Ouvre **Paramètres de l'organisation** > **Clés API**.
    
2.  Repère le **secret de signature webhook** et choisis **Afficher** (ou **Copier**).
    

Garde ce secret privé, comme une clé API. Ton app l'utilise pour confirmer que chaque message entrant est authentique — la vérification pas à pas est dans le [guide des webhooks](https://docs.samsa.ai/guides/webhooks) (s'ouvre dans un nouvel onglet).

### Bon à savoir

-   Les webhooks sont **facultatifs** — tu peux toujours vérifier l'état d'une tâche toi-même.
    
-   Si tu penses que ton secret de signature a été exposé, traite-le comme une clé : renouvelle-le et mets à jour ton app.
