n8n

Der Usetix-Community-Node verbindet eine selbst gehostete n8n-Instanz mit Deinem Account. Er nutzt dieselbe Admin-API und dieselben Rechte wie das Dashboard.

Paket: n8n-nodes-usetix, Version 1.0.1 oder neuer. Quellcode: github.com/gobijan/n8n-nodes-usetix.

n8n Cloud setzt die Freigabe durch n8n voraus. Die automatischen Checks sind bestanden, das Demo-Video ist eingereicht und die manuelle Prüfung läuft. Auf selbst gehosteten Instanzen kannst Du den Node bereits installieren.

Installieren

Auf einer selbst gehosteten n8n-Instanz:

1. Öffne Settings → Community Nodes → Install.
2. Gib n8n-nodes-usetix ein.
3. Starte n8n neu, wenn Du dazu aufgefordert wirst.

Community Nodes müssen auf dieser Instanz erlaubt sein. Das Paket allein öffnet noch keinen Usetix-Account. Dafür legst Du eine Credential an.

Account verbinden

Öffne in Usetix Einstellungen → API-Tokens und erstelle einen Token.

Token	Wofür
Lesen	Eventlisten, Bestellungssuche und andere Lesezugriffe.
Schreiben	Events, Gästelisten, Promo-Codes und Webhook-Abos anlegen oder ändern.

Lege in n8n eine Usetix API-Credential an und füge den Token ein. Der Node ruft damit https://app.usetix.io auf.

Usetix OAuth2 API ist für eine n8n-Instanz gedacht, die bereits einen eigenen registrierten Usetix-OAuth-Client hat. Die meisten Veranstalter nutzen einen API-Token. Co-Organisatoren nutzen einen persönlichen Token und arbeiten nur mit den Events, die ihnen zugewiesen sind. Accountweite Bestellungssuche und Gutschein-Benachrichtigungen brauchen eine Inhaber- oder Manager-Rolle.

Du kannst den Token in Usetix jederzeit widerrufen. Workflows, die ihn noch verwenden, scheitern beim nächsten Aufruf.

Aktionen

Der Node Usetix kann:

• Events anlegen, finden, auflisten, ändern, veröffentlichen und zurückziehen
• eine Bestellung über die öffentliche ID oder den Bestellcode finden
• Gästetickets eines Events auflisten
• eine Gästegruppe hinzufügen, inklusive Stehplatz oder konkreter Sitze, wenn das Event sie verwendet
• einen Promo-Code anlegen, inklusive Nutzungslimit und Ablaufdatum

Wähle zuerst das Event und danach Ticketarten oder Sitze. Usetix reserviert den Bestand, wenn die Gästegruppe angelegt wird. Ein veralteter Sitz liefert einen Fehler, den Du beheben kannst.

Für alle anderen Admin-API-Aufrufe nutzt Du den HTTP-Request-Node von n8n mit derselben Usetix-API-Credential. Die API-Dokumentation beschreibt Payloads und Rechte.

Trigger

Usetix Trigger abonniert eine oder mehrere dieser Benachrichtigungen:

• order.paid, order.refunded, order.cancelled
• event.published, event.unpublished
• ticket.redeemed
• voucher.issued, voucher.redeemed, voucher.refunded, voucher.adjusted, voucher.expired, voucher.blocked, voucher.unblocked, voucher.voided
• voucher_purchase.paid, voucher_purchase.refunded

Eine eventbezogene Benachrichtigung kannst Du auf ein Event begrenzen. Gutschein-Benachrichtigungen ohne Eventbezug gehören auf einen eigenen Trigger.

Beim Aktivieren des Workflows entsteht das Abo. Beim Deaktivieren oder Löschen wird es entfernt. Usetix liest die ursprünglich signierte Zustellung, bevor der Workflow Felder sieht. Ein gefälschter Callback-Body wird verworfen.

Wiederholungen

Usetix kann dieselbe Benachrichtigung mehr als einmal zustellen. Die id bleibt bei Wiederholungen gleich. Nutze in n8n Remove Duplicates mit dieser id, oder speichere sie im System, das Du aktualisierst.

Wenn ein folgender Schritt ein Event, eine Gästegruppe oder einen Promo-Code anlegt, trägst Du eine stabile Quell-ID in Unique Request Key ein. Derselbe Schlüssel und dieselbe Eingabe liefern sieben Tage lang das ursprüngliche Ergebnis und führen die Aktion nicht erneut aus. Eine andere Eingabe oder ein Token ohne die nötigen Rechte liefert HTTP 409. Für einen neuen Vorgang verwendest Du einen neuen Schlüssel.

Zapier und Make

Zapier und Make verwenden dieselbe Usetix-API und dieselben Benachrichtigungen. Beide lassen sich über Einladungslinks installieren; die Voraussetzungen für die öffentlichen Verzeichnisse sind noch nicht vollständig erfüllt.

Die Zapier-Anleitung und die Make-Anleitung führen Dich von der Einladung über die Account-Verbindung zum ersten Workflow.