Zum Hauptinhalt springen
Was this helpful?

Webhook-Fehler

PrimeCal-Automatisierungsregeln können durch eingehende Webhooks ausgelöst werden — ein externer Dienst sendet einen JSON-Payload per POST an eine eindeutige URL, und die Automatisierung wird ausgeführt. Diese Seite erklärt, was zu prüfen ist, wenn ein Webhook nicht wie erwartet ausgelöst wird.

Die Webhook-URL verstehen​

Jede Automatisierungsregel mit einem webhook.incoming-Trigger erhält ihre eigene eindeutige URL:

POST https://app.primecal.eu/api/automation/webhooks/{token}/receive

Das {token} ist spezifisch für diese Regel. Du findest es unter Automatisierung → [Deine Regel] → Webhook.

Der Webhook wird nicht ausgelöst​

Schritt 1: Überprüfe, ob die URL korrekt ist.

Kopiere die Webhook-URL aus dem Webhook-Bereich der Regel in PrimeCal und bestätige, dass sie mit der URL übereinstimmt, an die du sendest. Token sind lange zufällige Zeichenketten — ein einziger falscher Buchstabe bedeutet, dass der Webhook keiner Regel zugeordnet werden kann.

Schritt 2: Stelle sicher, dass die Anfrage PrimeCal erreicht.

Prüfe, ob dein externer Dienst (Slack, Zapier, dein eigener Dienst usw.) die HTTP-Anfrage tatsächlich stellt:

  • Schau dir die ausgehenden Webhook-Logs deines Dienstes an
  • Bestätige, dass die Anfrage einen 2xx-Statuscode von PrimeCal zurückgibt

Ein 404 bedeutet, dass das Token falsch ist. Ein 400 bedeutet, dass das Payload-Format falsch ist. Ein 200 bedeutet, dass PrimeCal es erhalten hat.

Schritt 3: Überprüfe die Bedingungen der Automatisierungsregel.

Webhooks lösen die Regel nur aus, wenn ihre Bedingungen erfüllt sind. Wenn deine Automatisierung Bedingungen wie webhook.data.status equals "completed" hat, wird die Regel nicht ausgelöst, wenn der eingehende Payload einen anderen Wert hat.

Gehe zu Automatisierung → [Deine Regel] → Audit-Log, um zu sehen, ob der Webhook empfangen wurde und warum er ausgelöst wurde oder nicht.

Das Audit-Log zeigt „Empfangen, aber Bedingungen nicht erfüllt"​

Dies ist der häufigste Fall. Der Webhook kam erfolgreich bei PrimeCal an, aber die Bedingungen der Regel stimmten nicht mit dem Payload überein.

Überprüfe deine Bedingungswerte:

  • webhook.data.status greift auf data.status innerhalb des JSON-Body zu
  • Der Vergleich ist bei dem Operator equals Groß-/Kleinschreibung-sensitiv
  • Verwende contains statt equals, wenn du Teilübereinstimmungen möchtest

Beispiel-Payload:

POST /api/automation/webhooks/abc123.../receive
{
  "event": "order.completed",
  "data": {
    "status": "completed",
    "customer_id": "cust_456"
  }
}

Für diesen Payload würde der Feldpfad webhook.data.status zu "completed" aufgelöst.

Die Webhook-URL gibt 401 oder 403 zurück​

Webhook-URLs sind öffentlich zugänglich und erfordern keine Authentifizierung — sie verwenden das Token selbst als Autorisierungsmechanismus. Wenn du einen 401 oder 403 bekommst:

  • Stelle sicher, dass du nicht versehentlich einen Authorization-Header sendest, der einen Konflikt verursacht
  • Stelle sicher, dass die Webhook-URL nicht neu generiert wurde — wenn das Token neu generiert wurde, ist die alte URL ungültig

Um ein Token neu zu generieren (wodurch auch die alte URL ungültig wird): Gehe zur Regeldetailansicht → Tab „Webhook" → Token neu generieren. Aktualisiere anschließend die URL in deinem externen Dienst.

Der Webhook gibt 200 zurück, aber nichts passiert​

Wenn das Audit-Log zeigt, dass der Webhook empfangen wurde und die Bedingungen erfüllt sind, die Aktion aber nicht ausgeführt wurde:

  1. Prüfe die Aktionskonfiguration — bei set_event_color muss ein Ereignis mit passendem Kalenderkontext vorhanden sein
  2. Prüfe, ob die Regel aktiviert ist (nicht pausiert)
  3. Beachte das Ratenlimit: Automatisierungsregeln haben eine 1-Minuten-Abkühlzeit zwischen Ausführungen, um endlose Schleifen zu verhindern. Wenn ein zweiter Webhook innerhalb einer Minute nach dem ersten eintrifft, wird er möglicherweise übersprungen

Einen Webhook manuell testen​

Du kannst deinen Webhook mit curl oder einem anderen HTTP-Client testen:

curl -X POST https://app.primecal.eu/api/automation/webhooks/YOUR_TOKEN_HERE/receive \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"status": "completed"}}'

Überprüfe dann das Audit-Log der Automatisierungsregel, um zu sehen, ob er empfangen und verarbeitet wurde.

Immer noch nicht gelöst?​

  • Prüfe zuerst das Audit-Log — es zeigt jeden Webhook-Eingang und warum er ausgelöst wurde oder nicht
  • Für Bedingungen und Feldpfade: Webhook Smart Values
  • Support kontaktieren: Support-Kontakt