Zum Inhalt springen

Peak Automations · Entwickler und Webhooks

Dein System ruft an.
Peak Automations hört zu.

Heute gebaut ist der Webhook-Auslöser: Eine Automation bekommt eine eigene Adresse mit Schlüssel, und dein System startet sie mit einem POST. Die Felder des Aufrufs stehen den Bedingungen und Schritten zur Verfügung. Eine eigene API zum Anlegen und Steuern von Automationen ist geplant.

Webhook-Auslöser einrichten

Beispielhafte Zuordnung · kein Aufruf wird gesendet

Dein SystemDer Aufruf
Peak AutomationsDas Auslöserfeld
Peak Automations · Beispielzuordnung
Eine Zuordnung im Detail
01 / Dein Systememail
02 / Fiktiver Testwertalex@example.com
03 / Peak AutomationsAuslöser · E-Mail

Ein lesbarer Feldweg als Beispiel. Kein Lauf.

Alle 5 Zuordnungen ansehen
Beispielhafte Felder eines Aufrufs mit fiktiven Werten. Die echten Felder bestimmst du in deinem System.
Dein SystemFeld im Auslöser
emailAuslöser · E-Mail
order_refAuslöser · Referenz
statusAuslöser · Status
noteAuslöser · Notiz
sent_atAuslöser · Zeitpunkt
Beispielzuordnung
Kein Lauf
Heute gibt es nur den Webhook-Auslöser. Eine Automations-API ist geplant.
Ein konkretes Ziel

Felder zuordnen. Herkunft behalten.

Peak AutomationsAnkunft im ZielNoch nicht getestet

Die Zuordnung zeigt, welcher Wert aus dem Auslöser in welchen Schritt geht. Erst ein Testlauf in deinem Workspace zeigt, was wirklich ankommt.

02 / Wie der Webhook-Auslöser arbeitet

Eine Adresse, ein Schlüssel, eine Warteschlange.

Der Aufruf startet keinen Schritt direkt. Er stellt einen Lauf in die Warteschlange, mit denselben Prüfungen wie jeder andere Auslöser.

  1. 01 / Heute

    Adresse und Schlüssel

    Jede Automation mit Webhook-Auslöser hat ihre eigene Adresse. Ohne gültigen Schlüssel wird der Aufruf abgelehnt.

    Was gibt es?Webhook-AuslöserEigene Adresse mit SchlüsselWarteschlange mit Wiederholung
  2. 02 / Geplant

    Lauf einreihen

    Der Aufruf landet in der Warteschlange. Wiederholungen und Doppelungsschutz verhindern, dass derselbe Aufruf zweimal wirkt.

    Was fehlt noch?Automations-APILäufe abfragenAusgehende Webhooks
  3. 03 / Dein Weg

    Gleiche Regeln

    Auch per Webhook gestartete Läufe brauchen eine aktive, getestete Version, und riskante Schritte warten auf Freigabe.

    Was tust du heute?Adresse anlegenBeispielaufruf testenVersion aktivieren

Vertrauen braucht Klarheit

Was es für Entwickler noch nicht gibt.

01 / Der vorhandene Beleg

Keine Automations-API

Endpunkte, um Automationen von außen anzulegen, zu ändern oder Läufe abzufragen, sind geplant. Heute gibt es nur den Webhook-Auslöser.

Dein System / Peak AutomationsBEISPIEL
Dein SystemFeldzuordnungPeak Automations
Zuordnung
Beispiel
Ankunft im Ziel
Nicht getestet

02 / Deine Prüfung

Keine ausgehenden Webhooks als Schritt

Eine Aktion, die einen beliebigen Webhook aufruft, ist kein Teil der heutigen Bausteine. Externe Aktionen laufen über die gelisteten Integrationen.

Verbindung
Hier nicht verbunden
Rechte
Rollen im Workspace

03 / Die klare Grenze

Kein Aufruf auf dieser Seite

Die Zuordnung oben ist ein Beispiel. Hier wird keine Adresse erzeugt und kein Aufruf gesendet.

  • Webhook
  • Schlüssel
  • Warteschlange
  • API geplant

Der nächste Schritt

Dein System als Auslöser, Peak für den Rest.

Starte Peak Automations, wähle den Webhook-Auslöser und teste die Automation mit einem Beispielaufruf.

Webhook-Auslöser einrichten
Deine FeldzuordnungNICHT VERBUNDEN
Dein System→Peak Automations
email → Auslöser · E-Mail

Prüfe im Testlauf deines Workspace, was tatsächlich angekommen ist.

Häufige Fragen

Wie wird ein Webhook geschützt?

Mit einem Schlüssel, von dem Peak nur einen Hash speichert.

Gibt es eine API für Automationen?

Noch nicht. Sie ist geplant. Heute gibt es den Webhook-Auslöser.

Läuft ein Webhook sofort nach dem Anlegen?

Nein. Auch hier gilt: erst testen, dann aktivieren.