Wenn Webhook empfangen wird

​

Mit KI erstellen

​

Konfiguration

​

Einrichtung

1. Öffnen Sie Ihre Automatisierung und fügen Sie einen neuen Auslöser hinzu.
2. Wählen Sie Wenn Webhook empfangen wird aus.
3. Der Auslöser erzeugt sofort eine eindeutige Webhook-URL. Kopieren Sie diese URL – Sie benötigen sie für das externe System.
4. (Optional, aber empfohlen) Klicken Sie auf Token generieren, um die Autorisierung per Bearer-Token zu aktivieren. Dadurch wird ein Token erzeugt, das im Header Authorization eingehender Anfragen enthalten sein muss.
5. Speichern und aktivieren Sie die Automatisierung.
6. Konfigurieren Sie Ihr externes System so, dass es eine POST-Anfrage an die Webhook-URL sendet. Fügen Sie das Token in den Header ein, falls Sie die Autorisierung aktiviert haben.
7. Senden Sie eine Testanfrage (siehe Beispiele unten). Prüfen Sie den Ausführungsverlauf der Automatisierung, um sicherzustellen, dass die Daten korrekt empfangen wurden.
8. Fügen Sie Ihre Aktionsschritte hinzu. Klicken Sie in einem beliebigen Aktionsfeld auf +, um auf Werte aus dem JSON-Text des Webhooks zu verweisen.

​

Welche Daten für nachfolgende Schritte verfügbar sind

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

​

Antwort anpassen

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

​

Webhook testen

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

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": "paid"}'

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"
    }
  }'

​

Ratenbegrenzungen

​

Bewährte Sicherheitspraktiken

• Verwenden Sie für produktive Webhooks immer die Autorisierung per Bearer-Token. Eine öffentliche Webhook-URL kann von jedem ausgelöst werden, der die URL kennt.
• Halten Sie Ihre Webhook-URL geheim. Behandeln Sie sie wie ein Passwort. Übertragen Sie sie nicht in öffentliche Repositorys und teilen Sie sie nicht in offenen Kanälen.
• Erzeugen Sie das Token neu, wenn Sie vermuten, dass es kompromittiert wurde. Sie können jederzeit im Auslöserbereich ein neues Token erzeugen.
• Validieren Sie Daten in Ihrem Workflow. Gehen Sie nicht davon aus, dass eingehende Daten korrekt formatiert sind. Verwenden Sie Filter oder Skriptschritte, um vor der Verarbeitung zu prüfen, ob erforderliche Felder vorhanden sind.
• Überwachen Sie den Ausführungsverlauf. Prüfen Sie regelmäßig die Ausführungsprotokolle Ihrer Automatisierung, um unerwartete oder nicht autorisierte Anfragen zu erkennen.

​

Anwendungsfälle

• Zahlungsereignisse von Stripe oder PayPal empfangen. Konfigurieren Sie einen Stripe-Webhook so, dass er invoice.paid-Ereignisse an Ihre Teable-Automatisierung sendet und automatisch Bestelldatensätze erstellt oder aktualisiert.
• Formularübermittlungen von Ihrer Website empfangen. Richten Sie das Kontakt- oder Registrierungsformular Ihrer Website auf die Webhook-URL aus, um Datensätze direkt in Teable zu erstellen.
• Daten von IoT-Geräten erfassen. Sensoren oder Geräte, die HTTP-Anfragen senden können, können Daten zur Überwachung und Alarmierung an Teable übertragen.
• CI/CD-Pipelines verbinden. Lösen Sie Workflows aus, wenn ein Build erfolgreich ist oder fehlschlägt – erstellen Sie Datensätze, senden Sie Benachrichtigungen oder aktualisieren Sie den Projektstatus.
• Ereignisse von einem beliebigen SaaS-Tool empfangen. Viele Tools (GitHub, Jira, Shopify, Twilio usw.) unterstützen Webhook-Benachrichtigungen. Richten Sie sie auf Ihren Teable-Webhook aus, um toolübergreifende Workflows zu automatisieren.

​

Tipps

• Der Webhook akzeptiert ausschließlich POST-Anfragen. GET, PUT und andere Methoden lösen die Automatisierung nicht aus.
• Senden Sie immer einen Header Content-Type: application/json. Wenn der Text kein gültiges JSON ist, kann der Auslöser die Daten möglicherweise nicht korrekt analysieren.
• Wenn Sie Daten aus einem System senden müssen, das keine benutzerdefinierten Header unterstützt (für die Bearer-Autorisierung), können Sie den öffentlichen Modus verwenden und einen geheimen Schlüssel zum JSON-Text hinzufügen, den Ihr Workflow mit einem Filter oder Skript validiert.
• Zur Fehlerdiagnose können Sie Dienste wie webhook.site verwenden, um zu prüfen, was Ihr externes System tatsächlich sendet, bevor Sie es auf Teable ausrichten.

​

Verwandte Themen

• Aktion „HTTP-Anfrage“ – das ausgehende Gegenstück: externe APIs aus Ihrem Workflow aufrufen
• Skript ausführen – für die erweiterte Verarbeitung von Webhook-Nutzlasten
• Aktion „Schleife (Stapel)“ – Arrays in Webhook-Nutzlasten verarbeiten