JTL Order Actions
Was ist das?
ArminCX Agents können direkt aus deinem JTL-System lesen und in es schreiben. Ein Agent kann eine Bestellung also nicht nur abrufen, sondern auch ändern: das Lieferdatum aktualisieren, Bestellfelder setzen und Custom Fields aktualisieren. Du verbindest diese Actions im Agent über dein Prompt. So führt der Agent von selbst die richtige Action aus, wenn ein Kunde schreibt.
Best Practice: erst lesen, dann schreiben
Starte jeden Bestell-Flow mit einem Lookup und handle dann. Lass den Agent die Bestellung zuerst abrufen, damit er mit Live-Daten arbeitet, und führe danach die Action aus, die etwas ändert. So aktualisiert der Agent nicht das falsche Feld oder die falsche Bestellung.
Verfügbare JTL Actions
Action | Was sie macht |
|---|---|
Get Order | Liest eine Bestellung aus JTL (Status, Felder, Lieferinfos). Nur lesend, es wird nichts geändert. |
Update Delivery Date | Setzt oder ändert das Lieferdatum einer bestehenden JTL-Bestellung. |
Update Order | Aktualisiert eine bestehende JTL-Bestellung. |
Update Custom Field | Aktualisiert ein Custom Field der Bestellung. Der Agent ruft zuerst die auf deinem JTL-System verfügbaren Custom Fields anhand des Namens ab, den du angibst, und aktualisiert dann das passende. |
List On Hold Reasons | Gibt die in deinem JTL-System hinterlegten On-Hold-Gründe zurück, damit der Agent einen gültigen auswählen kann. |
⚙️ So richtest du es ein
Öffne den Agent, dem du JTL-Zugriff geben willst.
Füge die JTL Actions hinzu, die du brauchst.
Sag dem Agent in den Instructions, wann er welche Action nutzen soll und in welcher Reihenfolge (zum Beispiel: erst die Bestellung holen, dann das Lieferdatum aktualisieren). Die Actions werden über das Prompt verbunden, nicht über einen separaten Config-Screen.
Update Custom Field, ohne ID
Du musst keine numerische Custom-Field-ID mehr nachschlagen und einfügen. Du gibst dem Agent den Feldnamen, der Agent ruft die Custom Fields auf deinem System ab, matcht über diesen Namen und aktualisiert das richtige Feld.
Wann du JTL Order Actions nutzt
Ein Kunde fragt, wo seine Bestellung ist. → Get Order.
Ein Kunde will seine Lieferung auf ein späteres Datum verschieben. → Get Order, dann Update Delivery Date.
Ein Kunde will ein Bestelldetail ändern, das du in einem Custom Field speicherst. → Get Order, dann Update Custom Field.
Für eine Bestellung muss ein On-Hold-Grund gesetzt werden. → List On Hold Reasons, dann aktualisieren.
Wann du JTL Order Actions NICHT nutzt
Für Bestelldaten, die in Shopify liegen, nicht in JTL. Nutze dafür die Shopify Actions.
Für eine einmalige manuelle Änderung an einer einzelnen Bestellung. Das direkt in JTL zu machen ist schneller, als einen Agent neu zu prompten.
Um ein Feld nur anzuzeigen. Ein Lookup (Get Order) reicht. Füge keine Write-Action hinzu, die du nicht nutzt.
Good to know: Die Update-Custom-Field-Action matcht über den Feldnamen, den du angibst. Heißt ein Feld in deinem JTL-System leicht anders, aktualisiert der Agent das, was er dort tatsächlich findet. Nutze in deinen Instructions also den exakten Feldnamen aus JTL.
Good to know: Write-Actions (Update Delivery Date, Update Order, Update Custom Field) ändern Live-Bestelldaten in JTL. Teste jede einzeln an einer Bestellung, bevor du einen Agent damit auf echte Tickets loslässt.
Fertig, du bist startklar!