Automatisierungs-Blöcke im Überblick

Jeder Flow im Flow-Editor besteht aus Blöcken. Diese Referenz listet alle Blöcke auf, die Finito derzeit mitbringt – gegliedert in Auslöser (starten einen Flow), Middleware (holen oder setzen Daten) und Aktionen (führen etwas aus). Zu jedem Block finden Sie, was er tut, welche Einstellungen er hat und welche Ausgabewerte er an nachfolgende Blöcke weitergibt.

Zuletzt aktualisiert:

So lesen Sie diese Referenz

Blöcke werden über Ausgabewerte und Eingabewerte verbunden: Was ein vorheriger Block ausgibt, steht dem nächsten als {{Vorlage}} zur Verfügung. Beispiel: Der Auslöser «Offer Created» gibt offer.client_email aus – im Block «Send Email» tragen Sie als Empfänger dann {{offer.client_email}} ein.

  • Alle Textfelder mit dem Hinweis «unterstützt Vorlagen» akzeptieren {{platzhalter}}, die zur Laufzeit durch echte Werte ersetzt werden.
  • Die Block-Bezeichnungen in der Palette (z. B. «Send Email», «Get Invoices») sind aktuell auf Englisch. Die deutschen Namen in dieser Referenz dienen dem Verständnis.
ℹ

Wie Sie Blöcke auf die Zeichenfläche ziehen, verbinden, konfigurieren und testen, lesen Sie im Artikel Automatisierungen einrichten.

1. Auslöser (Trigger)

Ein Auslöser startet den Flow. Jeder Flow benötigt genau einen Auslöser-Block; er hat keinen Eingangs-Port. Es gibt ereignisbasierte Auslöser (feuern, wenn etwas in Finito passiert), zeitbasierte Auslöser (feuern nach Zeitplan) und den Webhook-Auslöser (feuert auf Zuruf eines externen Systems).

Ereignisbasierte Auslöser

Block Feuert, wenn … Wichtige Ausgabewerte
Inquiry Received
Anfrage eingegangen
eine neue Anfrage für Ihre Organisation eingeht. inquiry.uuid, inquiry.name, inquiry.source
Invoice Created
Rechnung erstellt
eine Rechnung angelegt wird. invoice.number, invoice.status, invoice.total, invoice.currency, invoice.client_email
Offer Created
Offerte erstellt
eine Offerte angelegt wird. offer.number, offer.name, offer.client_email, offer.author_uuid
Comment Created
Kommentar erstellt
ein Kommentar geschrieben wird. comment.content, comment.entity_uuid, comment.author_email
ℹ

Alle Auslöser geben zusätzlich organization.email und organization.name aus – praktisch, um Benachrichtigungen an die Organisation zu senden.

Zeitbasierte Auslöser

Block Ausführung
Every Day – Täglich Startet den Flow einmal pro Tag.
Every Week – Wöchentlich Startet den Flow einmal pro Woche.
Every Month – Monatlich Startet den Flow einmal pro Monat.

Zeitbasierte Auslöser geben schedule.type (daily / weekly / monthly) sowie die Organisationsdaten aus. Sie eignen sich ideal in Kombination mit Middleware-Blöcken – etwa «Get Invoices» → «Send Statistics Report» für einen monatlichen Umsatzbericht.

Webhook

Block Einstellungen Ausgabewerte
Webhook Webhook: Auswahl des registrierten Endpunkts. Feuert, wenn ein externes System per HTTP-POST an dessen URL sendet. webhook.name, payload (der gesendete Datenkörper als Objekt)
ℹ

Endpunkte, URL, Sicherheits-Secret und einen fertigen cURL-Befehl finden Sie auf der Automatisierungen-Übersichtsseite im Bereich Webhooks. Behandeln Sie das Secret wie ein Passwort.

2. Middleware (Abfragen & Variablen)

Middleware-Blöcke sitzen zwischen Auslöser und Aktion. Sie holen Daten aus Finito oder setzen Variablen, ohne selbst etwas nach aussen zu bewirken.

Block Was er tut Einstellungen Wichtige Ausgabewerte
Get Invoices
Rechnungen abrufen
Liest die Rechnungen eines Zeitraums. Zeitraum: aktueller Monat, letzter Monat oder aktuelles Jahr. invoices, invoice_count, unique_client_count, total_amount, currency, period_start/period_end
Get Offers
Offerten abrufen
Liest die Offerten eines Zeitraums. Zeitraum: aktueller Monat, letzter Monat oder aktuelles Jahr. offers, offer_count, period_start/period_end
Get Clients
Kunden abrufen
Liest alle Kunden der Organisation. Keine. clients, client_count
Set Variable
Variable setzen
Legt einen benannten Wert an, der später als {{name}} verwendbar ist. Name und Wert (Wert unterstützt Vorlagen). Der gesetzte Wert, abrufbar unter dem gewählten Namen.
ℹ

Die Ausgaben von «Get Invoices» und «Get Offers» werden direkt vom Block «Send Statistics Report» weiterverarbeitet – Sie müssen die Werte nicht manuell zuordnen.

3. Aktionen

Aktions-Blöcke bewirken etwas – sie versenden E-Mails, rufen fremde Systeme auf oder geben Debug-Informationen aus.

Send Email – E-Mail senden

Versendet eine E-Mail.

  • Empfänger: E-Mail-Adresse; leer lassen für die Organisations-Adresse.
  • Betreff und Text: unterstützen Vorlagen.

Ausgabe: status (sent, skipped oder skipped_dev).

Send Statistics Report – Statistikbericht senden

Versendet einen Statistikbericht als .xlsx-Anhang per E-Mail.

  • Empfänger, Betreff, Text wie bei «Send Email».
  • Dateiname: .xlsx wird bei Bedarf automatisch ergänzt.
  • Verwendet die invoices/offers aus vorgeschalteten «Get …»-Blöcken.

HTTP Request – HTTP-Anfrage

Ruft ein externes System auf.

  • Methode: GET, POST, PATCH, PUT oder DELETE.
  • URL und Text (Body): unterstützen Vorlagen.
  • Header: je Zeile ein Eintrag im Format Header-Name: Wert.
  • Timeout: in Sekunden (Standard 10).

Ausgabe: http.status_code, http.response_body, http.url.

Send Push Notification – Push-Benachrichtigung senden

Sendet eine Push-Benachrichtigung an die App.

  • Titel und Text: unterstützen Vorlagen.
  • Ziel: «Alle Organisationsbenutzer» oder «Bestimmter Benutzer». Bei letzterem erscheint das Feld Benutzer-UUID (muss ein Benutzer Ihrer Organisation sein; unterstützt Vorlagen, z. B. {{offer.author_uuid}}).

Ausgabe: status, delivered_count (Anzahl zugestellter Nachrichten).

Console Log – Konsolenausgabe (Debug)

Gibt eine Nachricht in die Editor-Konsole aus – nützlich beim Aufbau und Testen eines Flows. Der Text unterstützt Vorlagen. Enthält ein Flow diesen Block, öffnet sich beim Testlauf automatisch das Konsolen-Panel am unteren Rand des Editors.

Sie vermissen einen Block?

Der Block-Katalog wird laufend erweitert. Fehlt Ihnen ein Auslöser oder eine Aktion für Ihren Anwendungsfall, schreiben Sie an hello@finitopro.ch und beschreiben Sie, was Sie benötigen.

ℹ

Neben diesen Standard-Blöcken kann das Finito-Team für einzelne Organisationen zusätzliche, massgeschneiderte Blöcke bereitstellen. Diese erscheinen dann ebenfalls in Ihrer Palette.

War dieser Artikel hilfreich?