Zum Hauptinhalt springen
Tale bietet zwei Arten von Webhooks: Workflow-Webhooks (lösen eine Automatisierung aus) und Agent-Webhooks (senden eine Nachricht an einen Agent außerhalb der Chat-UI). Beide nutzen dasselbe Request-Format und dasselbe Signatur-Schema.

​
Workflow-Webhooks

Jeder Workflow hat eine eigene Webhook-URL, sichtbar im Konfiguration-Tab: 
https://<your-tale-domain>/api/webhooks/workflow/<workflow-id>
POSTe einen JSON-Body, um den Workflow mit diesen Daten als Input zu starten: 
curl -X POST https://tale.example.com/api/webhooks/workflow/abc123 \
  -H "Content-Type: application/json" \
  -H "X-Tale-Signature: sha256=..." \
  -d '{"customerId": "c-42", "priority": "high"}'
Die Antwort enthält sofort eine Ausführungs-ID. Den Status und Output siehst du im Ausführungen-Tab des Workflows (oder über die REST-API).

​
Agent-Webhooks

Jeder Agent hat einen eigenen Endpoint: 
https://<your-tale-domain>/api/webhooks/agent/<agent-slug>
POSTe eine Nachricht, um eine Agent-Antwort ohne die Plattform-UI zu bekommen. Die Antwort ist synchron — der HTTP-Request blockiert, bis der Agent fertig generiert hat. 
curl -X POST https://tale.example.com/api/webhooks/agent/support-agent \
  -H "Content-Type: application/json" \
  -H "X-Tale-Signature: sha256=..." \
  -d '{
    "message": "Wo bleibt meine Bestellung?",
    "conversationId": "optional-existing-id"
  }'
Wenn conversationId weggelassen wird, wird eine neue Konversation angelegt und in der Antwort zurückgegeben.

​
Signatur-Verifizierung

Tale signiert jeden Webhook-Request mit HMAC-SHA-256 unter Verwendung des Webhook-Secrets. Die Signatur wird im Header X-Tale-Signature als sha256=<hex> mitgeschickt. Empfänger sollten:
  1. den rohen Request-Body lesen (nicht das geparste JSON);
  2. HMAC-SHA-256(secret, body) berechnen;
  3. den Header-Wert per constant-time-Vergleich prüfen;
  4. Requests ablehnen, die nicht übereinstimmen.
Node.js-Beispiel: 
import { createHmac, timingSafeEqual } from 'node:crypto';

export function verify(req, secret) {
  const signature = req.headers['x-tale-signature'];
  if (!signature) return false;
  const expected =
    'sha256=' + createHmac('sha256', secret).update(req.rawBody).digest('hex');
  const a = Buffer.from(signature);
  const b = Buffer.from(expected);
  return a.length === b.length && timingSafeEqual(a, b);
}
Python-Beispiel: 
import hmac, hashlib

def verify(body: bytes, header: str, secret: str) -> bool:
    expected = 'sha256=' + hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(header or '', expected)

​
Wiederholungen

Tale versucht fehlgeschlagene Webhook-Zustellungen (Non-2xx-Antworten, Timeouts) mit exponentiellem Backoff bis zu 5 Mal erneut. Nach dem letzten Fehlschlag wird die Zustellung als fehlgeschlagen markiert und im Audit-Stream protokolliert — ein Admin kann sie über die Audit-Logs-Seite wiedergeben.

​
Siehe auch

Last modified on April 20, 2026