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:
.xlsxwird bei Bedarf automatisch ergänzt. - Verwendet die
invoices/offersaus 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.