À la réception d’un webhook

Remarque : vous pouvez configurer tous les déclencheurs dans le Chat IA. Indiquez à l’IA ce que le flux de travail doit accomplir et elle se chargera du reste.

Ce déclencheur génère une URL unique. Lorsqu’un système externe lui envoie une requête HTTP POST, le flux de travail s’exécute.

Créer avec l’IA

Ouvrez le Chat IA dans la barre latérale droite de votre table et décrivez ce que vous souhaitez. L’IA s’occupe de tout : elle choisit le bon déclencheur, associe les champs pertinents et configure automatiquement toutes les actions. Décrivez une seule fois votre objectif et le flux de travail est prêt, sans aucune configuration manuelle. Exemple : “Lorsque je reçois un webhook de paiement Stripe, crée un enregistrement de commande.”

Configuration

Paramètre	Obligatoire	Description
Autorisation	Non	Aucune (publique : toute personne disposant de l’URL peut la déclencher) ou Jeton Bearer (un jeton généré automatiquement doit figurer dans l’en-tête de la requête)
Réponse	Non	Par défaut (Teable renvoie son propre accusé de réception) ou Personnalisée (vous choisissez le code d’état, le type de contenu et le corps)

Procédure de configuration

Ouvrez votre automatisation et ajoutez un nouveau déclencheur.
Sélectionnez À la réception d’un webhook.
Le déclencheur génère immédiatement une URL de webhook unique. Copiez cette URL : vous en aurez besoin dans le système externe.
(Facultatif, mais recommandé) Cliquez sur Générer un jeton pour activer l’autorisation par jeton Bearer. Un jeton est alors créé et doit être inclus dans l’en-tête Authorization des requêtes entrantes.
Enregistrez et activez l’automatisation.
Configurez votre système externe pour qu’il envoie une requête POST à l’URL du webhook. Incluez le jeton dans l’en-tête si vous avez activé l’autorisation.
Envoyez une requête de test (voir les exemples ci-dessous). Consultez l’historique d’exécution de l’automatisation pour vérifier que les données ont été correctement reçues.
Ajoutez vos étapes d’action. Cliquez sur + dans n’importe quel champ d’action pour référencer les valeurs du corps JSON du webhook.

Données accessibles aux étapes suivantes

L’intégralité du corps JSON de la requête POST entrante est disponible sous forme de variables. Par exemple, si vous envoyez :

{
  "order_id": "12345",
  "customer": "Alice",
  "amount": 99.95
}

Dans vos actions, vous pouvez ensuite référencer séparément order_id, customer et amount en cliquant sur +, puis en accédant aux champs de sortie du déclencheur. Teable analyse automatiquement le JSON et crée des variables nommées pour chaque clé de premier niveau. Les objets imbriqués sont également accessibles.

Personnaliser la réponse

Par défaut, Teable répond à chaque requête entrante avec son propre accusé de réception. Certaines plateformes ne l’acceptent pas : elles vérifient une URL d’abonnement en envoyant une requête de contrôle et exigent que votre point de terminaison leur renvoie la valeur d’un champ. Slack fonctionne ainsi ; ses événements ne peuvent donc atteindre une automatisation qu’une fois que le webhook a répondu à cette requête de validation. Dans le panneau du déclencheur, faites passer Réponse de Par défaut à Personnalisée :

Champ	Description
Code d’état	Tout code compris entre 200 et 299. La valeur par défaut est 200.
Type de contenu	JSON ou texte brut. La valeur par défaut est JSON.
Corps de la réponse	Texte à renvoyer. Utilisez `{{body.<path>}}` pour insérer des valeurs provenant de la requête entrante.

Lorsque vous sélectionnez Personnalisée, le corps est prérempli avec la réponse de validation dont la plupart des appelants ont besoin :

{"challenge":"{{body.challenge}}"}

Les chemins entre {{ }} sont les mêmes que ceux exposés par le déclencheur sous forme de variables de sortie. Vous pouvez donc copier directement un chemin depuis une charge utile déjà reçue lors d’une exécution de test. Les valeurs imbriquées fonctionnent également, par exemple {{body.event.type}}. Dans un corps JSON, un chemin absent de la requête est rendu sous la forme null, ce qui garantit la validité du JSON renvoyé.

Slack ne peut pas envoyer d’en-tête Authorization. Lorsque vous le connectez, laissez donc le paramètre Autorisation défini sur Aucune. Le panneau du déclencheur affiche un avertissement si les deux options sont activées simultanément.

Vous pouvez à tout moment faire repasser Réponse à Par défaut pour rétablir l’accusé de réception propre à Teable. Les automatisations qui n’utilisent jamais ce paramètre ne sont pas affectées.

Tester votre webhook

La méthode la plus simple consiste à utiliser curl depuis la ligne de commande. Copiez l’URL réelle depuis le panneau du déclencheur plutôt que de la saisir manuellement : elle contient les identifiants de la base et du flux de travail. Sans autorisation :

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "Bonjour depuis curl"}'

Avec autorisation par jeton Bearer :

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "payé"}'

Envoi de données plus complexes :

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

Après l’envoi d’une requête de test, consultez l’historique d’exécution de l’automatisation pour confirmer que les données ont été correctement reçues et analysées.

Limites de débit

Portée	Limite
Par base	50 requêtes/seconde
Par flux de travail	2 requêtes/seconde

Les requêtes qui dépassent la limite de débit reçoivent une réponse HTTP 429. Si votre système externe envoie des rafales de requêtes, envisagez de mettre en œuvre une logique de nouvelle tentative avec délai exponentiel.

Bonnes pratiques de sécurité

Utilisez toujours l’autorisation par jeton Bearer pour les webhooks de production. Une URL de webhook publique peut être déclenchée par toute personne qui la découvre.
Gardez l’URL de votre webhook confidentielle. Traitez-la comme un mot de passe. Ne l’enregistrez pas dans un dépôt public et ne la partagez pas sur des canaux ouverts.
Régénérez le jeton si vous pensez qu’il a été compromis. Vous pouvez générer un nouveau jeton à tout moment depuis le panneau du déclencheur.
Validez les données dans votre flux de travail. Ne supposez pas que les données entrantes sont correctement structurées. Utilisez des filtres ou des étapes de script pour vérifier la présence des champs obligatoires avant de les traiter.
Surveillez l’historique d’exécution. Consultez régulièrement les journaux d’exécution de votre automatisation pour repérer les requêtes inattendues ou non autorisées.

Cas d’utilisation

Recevoir des événements de paiement provenant de Stripe ou PayPal. Configurez un webhook Stripe pour envoyer des événements invoice.paid à votre automatisation Teable afin de créer ou de mettre à jour automatiquement les enregistrements de commande.
Accepter les soumissions de formulaires de votre site Web. Faites pointer le formulaire de contact ou d’inscription de votre site vers l’URL du webhook afin de créer directement des enregistrements dans Teable.
Ingérer des données provenant d’appareils IoT. Les capteurs ou appareils capables d’envoyer des requêtes HTTP peuvent transmettre des données à Teable à des fins de surveillance et d’alerte.
Connecter des pipelines CI/CD. Déclenchez des flux de travail lorsqu’une compilation réussit ou échoue : créez des enregistrements, envoyez des notifications ou mettez à jour le statut du projet.
Recevoir des événements provenant de n’importe quel outil SaaS. De nombreux outils (GitHub, Jira, Shopify, Twilio, etc.) prennent en charge les notifications par webhook. Faites-les pointer vers votre webhook Teable afin d’automatiser les flux de travail entre outils.

Conseils

Le webhook n’accepte que les requêtes POST. Les méthodes GET, PUT et autres ne déclenchent pas l’automatisation.
Envoyez toujours un en-tête Content-Type: application/json. Si le corps n’est pas un JSON valide, le déclencheur risque de ne pas analyser correctement les données.
Si vous devez envoyer des données depuis un système qui ne prend pas en charge les en-têtes personnalisés (pour l’autorisation Bearer), envisagez d’utiliser le mode public tout en ajoutant au corps JSON une clé secrète que votre flux de travail validera au moyen d’un filtre ou d’un script.
Pour le débogage, vous pouvez utiliser des services comme webhook.site afin d’examiner ce que votre système externe envoie réellement avant de le faire pointer vers Teable.

Pages associées

Action Requête HTTP — équivalent sortant permettant d’appeler des API externes depuis votre flux de travail
Exécuter un script — pour le traitement avancé des charges utiles de webhook
Action Boucle (traitement par lots) — traite les tableaux présents dans les charges utiles de webhook

IA

Espace

Automatisation

Base

Matrice d’autorité

SSO

Comparaison

À la réception d’un webhook

Créer avec l’IA

Configuration

Procédure de configuration

Données accessibles aux étapes suivantes

Personnaliser la réponse

Tester votre webhook

Limites de débit

Bonnes pratiques de sécurité

Cas d’utilisation

Conseils

Pages associées

​Créer avec l’IA

​Configuration

​Procédure de configuration

​Données accessibles aux étapes suivantes

​Personnaliser la réponse

​Tester votre webhook

​Limites de débit

​Bonnes pratiques de sécurité

​Cas d’utilisation

​Conseils

​Pages associées

Créer avec l’IA

Configuration

Procédure de configuration

Données accessibles aux étapes suivantes

Personnaliser la réponse

Tester votre webhook

Limites de débit

Bonnes pratiques de sécurité

Cas d’utilisation

Conseils

Pages associées