Skip to content
Moritz Klaßen

Moritz Klassen

Selbstständige 8 Min. Lesezeit

Formularanfragen automatisch ins Aufgabenboard übertragen

Kontaktanfragen sollten nicht im Postfach darauf warten, dass jemand sie entdeckt und manuell verteilt. Dieses Tutorial zeigt dir, wie du aus jeder gültigen Formularanfrage zuverlässig eine zugewiesene Aufgabe machst – mit eindeutiger Zuordnung, Schutz vor Duplikaten und einem brauchbaren Fehlerweg.

Ein Webhook vom Kontaktformular zum Aufgabenboard – damit sei die Übergabe erledigt. Für eine belastbare Automation reicht diese direkte Verbindung nicht. Sie kann Aufgaben doppelt anlegen, unvollständige Daten übertragen oder Fehler so gründlich verstecken, dass die Anfrage weiterhin im E-Mail-Postfach gesucht werden muss.

Das Ziel sollte deshalb genauer formuliert sein: Jede gültige Formularanfrage erzeugt genau eine nachvollziehbare Aufgabe, erhält eine verantwortliche Person und bleibt auch dann auffindbar, wenn das Zielsystem vorübergehend nicht erreichbar ist. Diese Definition bestimmt die folgenden Schritte.

Lege zuerst das Ergebnis im Aufgabenboard fest

Beginne nicht mit dem verfügbaren Automationswerkzeug, sondern mit der Aufgabe, die am Ende tatsächlich bearbeitet werden soll. Ein Eintrag mit dem Titel „Neue Formularanfrage“ hilft kaum. Die zuständige Person muss ihn öffnen, den Inhalt entziffern und anschließend entscheiden, ob sie überhaupt zuständig ist.

Für eine typische Anfrage sind folgende Angaben sinnvoll:

  • Titel: Anliegen und Name oder Unternehmen, beispielsweise „Relaunch-Anfrage – Beispiel GmbH“.
  • Beschreibung: Nachricht aus dem Formular sowie die für die Bearbeitung erforderlichen Kontaktdaten.
  • Kategorie: etwa Projektanfrage, Support, Bewerbung oder allgemeine Nachricht.
  • Quelle: konkretes Formular und Seite, über die die Anfrage eingegangen ist.
  • Eingangszeitpunkt: Zeitpunkt, zu dem dein System die Anfrage angenommen hat.
  • Verantwortung: Person oder Team, das den nächsten Schritt übernimmt.
  • Externe Referenz: eine eindeutige ID der ursprünglichen Einsendung.

Die externe Referenz ist kein dekoratives Metadatum. Sie verbindet die Aufgabe mit dem Originaldatensatz und verhindert später Duplikate. Fehlt sie, wird die Fehlersuche schnell zu einer kriminalistischen Nebenbeschäftigung.

Speichere die Anfrage vor der Weitergabe

Eine Formularanfrage sollte zuerst in einem System unter deiner Kontrolle gespeichert werden. Das kann die Datenbank der Website, ein dafür vorgesehenes Formularsystem oder ein kleines internes Tool sein. Erst danach beginnt die Übergabe an das Aufgabenboard.

Diese Reihenfolge trennt zwei Ereignisse sauber voneinander: Die Website hat die Anfrage erfolgreich angenommen, und das Aufgabenboard hat daraus erfolgreich eine Aufgabe erstellt. Fällt die zweite Aktion aus, bleibt das Original erhalten und kann erneut verarbeitet werden.

Verlässt du dich ausschließlich auf eine versendete E-Mail oder einen einmaligen direkten API-Aufruf, fehlt dir dieser stabile Ausgangspunkt. Ein Timeout lässt dann offen, ob die Aufgabe gar nicht, einmal oder möglicherweise doch zweimal angelegt wurde.

Vergib beim Speichern eine eindeutige Einreichungs-ID. Sie darf nicht aus Name, E-Mail-Adresse und Zeitpunkt zusammengebaut werden, weil sich diese Werte wiederholen oder nachträglich ändern können. Nutze stattdessen die vom Formularsystem erzeugte Datensatz-ID oder eine technisch generierte UUID, also eine global eindeutige Kennung.

Definiere eine feste Zuordnung der Felder

Schreibe vor der Implementierung auf, welches Formularfeld in welches Feld des Aufgabenboards übertragen wird. Diese Zuordnung wird häufig nur in einzelnen Automationsschritten hinterlegt. Dann weiß einige Wochen später niemand mehr, warum die Telefonnummer im Beschreibungstext steht und das Feld „Priorität“ den Wert einer Budgetauswahl enthält.

Eine einfache Zuordnung kann so aussehen:

  • Anfragetyp bestimmt Projekt, Liste oder Kategorie im Aufgabenboard.
  • Name und Unternehmen werden für den Aufgabentitel verwendet.
  • Nachricht landet unverändert in der Beschreibung.
  • E-Mail-Adresse und Telefonnummer werden als Kontaktdaten gekennzeichnet.
  • Einreichungs-ID wird in einem eigenen Referenzfeld gespeichert.
  • Formularname und Seiten-URL dokumentieren die Herkunft.
  • Einwilligungsfelder bleiben im Originaldatensatz und werden nur übertragen, wenn sie für den konkreten Prozess benötigt werden.

Behandle leere optionale Felder ausdrücklich. Eine fehlende Telefonnummer sollte beispielsweise nicht den Text „Telefon: null“ erzeugen. Der Automationsablauf kann solche Zeilen auslassen oder einen neutralen Hinweis setzen, falls die Information für die Bearbeitung wichtig ist.

Halte die Verteilungsregeln überschaubar

Nach dem Übertragen der Inhalte muss feststehen, wo die Aufgabe landet. Beginne mit wenigen Regeln, die sich aus eindeutigen Formularangaben ableiten lassen. Eine Auswahl wie „Support“ oder „Projektanfrage“ eignet sich besser als der Versuch, Freitext automatisch zu interpretieren.

Eine nachvollziehbare Verteilung könnte beispielsweise so funktionieren:

  • Projektanfragen landen in der Liste für neue Anfragen und werden dem Vertrieb oder der Geschäftsführung zugewiesen.
  • Supportanfragen landen in der Supportliste und erhalten die verantwortliche Rolle.
  • Bewerbungen werden in einen getrennten, entsprechend geschützten Bereich übertragen.
  • Unbekannte oder fehlende Kategorien landen in einer allgemeinen Eingangsliste.

Die allgemeine Eingangsliste ist wichtig. Sie verhindert, dass eine neue Formularoption oder ein unerwarteter Wert die gesamte Verarbeitung abbricht. Die Automation trifft in diesem Fall keine kreative Entscheidung, sondern wählt einen sicheren Auffangweg.

Vermeide Regeln, die an einzelne Namen gebunden sind, wenn eigentlich Rollen gemeint sind. „Support-Team“ bleibt verständlich, wenn Zuständigkeiten wechseln. „Immer an Max“ wird spätestens im Urlaub zu einer organisatorischen Zeitkapsel.

Verhindere doppelte Aufgaben mit einer Referenz-ID

Automationen werden erneut ausgeführt. Ein Zielsystem antwortet zu langsam, ein Workflow wird manuell neu gestartet oder ein Formular sendet denselben Webhook noch einmal. Deshalb muss die Erstellung idempotent sein. Idempotent bedeutet hier: Mehrere Verarbeitungsversuche derselben Anfrage führen weiterhin nur zu einer Aufgabe.

Prüfe vor dem Anlegen, ob im Aufgabenboard bereits ein Eintrag mit der Einreichungs-ID existiert. Ist er vorhanden, wird keine weitere Aufgabe erzeugt. Je nach System kannst du stattdessen den bestehenden Eintrag aktualisieren oder den erneuten Versuch lediglich protokollieren.

Wenn das Aufgabenboard keine Suche nach einem eigenen Referenzfeld erlaubt, speichere die Verbindung in deinem internen Datensatz:

  • Einreichungs-ID des Formulars
  • ID der erzeugten Aufgabe
  • Zeitpunkt der erfolgreichen Übertragung
  • aktueller Übertragungsstatus

Der Ablauf prüft dann vor jeder Erstellung, ob bereits eine Aufgaben-ID hinterlegt ist. So bleibt die Zuordnung auch dann eindeutig, wenn ein Bearbeiter den Titel der Aufgabe später ändert.

Baue den Ablauf als klare Zustandsfolge

Für einen kleinen Workflow reichen wenige Zustände. Sie sollten allerdings im Ausgangssystem gespeichert werden, damit du den Bearbeitungsstand einer Anfrage erkennen und fehlgeschlagene Übertragungen gezielt wiederholen kannst.

  1. Empfangen: Das Formular wurde geprüft und gespeichert.
  2. Bereit zur Übertragung: Pflichtfelder und Verteilungsregeln sind vollständig.
  3. In Verarbeitung: Der Workflow bearbeitet den Datensatz gerade.
  4. Übertragen: Die Aufgabe wurde angelegt und ihre ID gespeichert.
  5. Fehlgeschlagen: Die Übertragung konnte nicht abgeschlossen werden; Ursache und Zeitpunkt wurden protokolliert.

Der Zwischenzustand „In Verarbeitung“ verhindert, dass zwei gleichzeitig gestartete Prozesse dieselbe Anfrage übernehmen. Dafür braucht die Verarbeitung eine atomare Reservierung: Nur ein Prozess darf den Status von „Bereit zur Übertragung“ auf „In Verarbeitung“ ändern. Welche technische Methode du dafür verwendest, hängt vom System ab. Entscheidend ist die exklusive Übernahme.

Bleibt ein Datensatz durch einen Abbruch dauerhaft in diesem Zwischenzustand, darf er nicht verschwinden. Lege fest, wann eine hängende Verarbeitung wieder freigegeben oder zur Prüfung markiert wird.

Behandle Fehler als regulären Teil des Workflows

Ein Fehlerweg ist keine zusätzliche Komfortfunktion. Ohne ihn hast du lediglich eine Automation, die so lange zuverlässig wirkt, bis das Aufgabenboard ein Problem hat.

Unterscheide mindestens zwischen vorübergehenden und dauerhaften Fehlern. Ein Timeout oder eine kurzfristig nicht erreichbare Schnittstelle kann nach einer Wartezeit erneut versucht werden. Eine ungültige Projekt-ID, ein gelöschter Benutzer oder ein nicht unterstützter Feldwert verschwindet dagegen nicht durch beharrliches Wiederholen.

Für jeden fehlgeschlagenen Datensatz solltest du speichern:

  • den verständlichen Fehlergrund,
  • den Zeitpunkt des letzten Versuchs,
  • die Anzahl der bisherigen Versuche,
  • den nächsten vorgesehenen Versuch oder den Status „manuelle Prüfung“,
  • die ursprüngliche Einreichungs-ID.

Gib einer zuständigen Person eine einfache Ansicht auf offene Fehler. Das kann eine gefilterte Liste im internen Tool oder eine zusammengefasste Benachrichtigung sein. Einzelne E-Mails für jeden technischen Aussetzer erzeugen meist nur ein zweites Postfach, das ebenfalls niemand gern betreut.

Übertrage nur Daten, die im Aufgabenboard gebraucht werden

Ein internes Aufgabenboard ist nicht automatisch der richtige Ablageort für sämtliche Formulardaten. Übertrage nur Informationen, die für Zuordnung und Bearbeitung erforderlich sind. Besonders bei Bewerbungen, Gesundheitsangaben oder anderen sensiblen Inhalten sollte die Aufgabe eher auf den geschützten Originaldatensatz verweisen, statt alle Angaben zu kopieren.

Prüfe dabei konkret:

  • Wer kann das Zielprojekt und seine Aufgaben sehen?
  • Werden Inhalte in Benachrichtigungs-E-Mails des Aufgabenboards wiederholt?
  • Wie lange bleiben erledigte Aufgaben gespeichert?
  • Enthalten Kommentare oder Anhänge zusätzliche personenbezogene Daten?
  • Kann die Verknüpfung zum Originaldatensatz bei einer Löschung sauber entfernt werden?

Technisch bequemes Kopieren vergrößert die Zahl der Ablageorte. Damit steigen auch der Aufwand für Zugriffsrechte, Korrekturen und Löschungen. Ein aussagekräftiger Aufgabentitel braucht beispielsweise selten eine vollständige E-Mail-Adresse.

Setze die Automation in einer kontrollierten Reihenfolge um

Wenn Datenmodell, Zuordnung und Fehlerweg feststehen, lässt sich der eigentliche Workflow ohne Rätselraten bauen. Die konkrete Oberfläche unterscheidet sich je nach Formular-, Automations- und Aufgabenwerkzeug; die Reihenfolge bleibt gleich.

  1. Formulareingabe serverseitig validieren und als Datensatz speichern.
  2. Eindeutige Einreichungs-ID vergeben.
  3. Datensatz für die Übertragung markieren oder ein Verarbeitungsereignis auslösen.
  4. Datensatz exklusiv übernehmen und den Status auf „In Verarbeitung“ setzen.
  5. Prüfen, ob bereits eine Aufgaben-ID gespeichert ist.
  6. Zielprojekt, Kategorie und zuständige Rolle anhand fester Regeln bestimmen.
  7. Benötigte Felder in Titel, Beschreibung und Metadaten umwandeln.
  8. Aufgabe über die Schnittstelle des Zielsystems anlegen.
  9. Erhaltene Aufgaben-ID und Übertragungszeitpunkt beim Originaldatensatz speichern.
  10. Status auf „Übertragen“ setzen oder einen Fehler mit passender Behandlung erfassen.

Die Erfolgsmeldung des Kontaktformulars sollte nicht davon abhängen, ob das Aufgabenboard in derselben Sekunde antwortet. Sobald die Anfrage sicher gespeichert ist, kann die Website den Eingang bestätigen. Die interne Weiterleitung darf anschließend im Hintergrund laufen.

Teste Fälle statt nur den Idealfall

Eine einzelne Testanfrage mit vollständig ausgefüllten Feldern beweist lediglich, dass der sonnige Weg funktioniert. Für die Freigabe brauchst du Testfälle, die deine Verteilungs- und Fehlerlogik tatsächlich beanspruchen.

  • Gültige Projektanfrage mit allen optionalen Angaben
  • Gültige Anfrage ohne Telefonnummer oder Unternehmen
  • Anfrage mit Zeilenumbrüchen, Umlauten und längeren Texten
  • Unbekannter Wert im Feld für den Anfragetyp
  • Doppelte Verarbeitung derselben Einreichungs-ID
  • Timeout nach dem Absenden an das Aufgabenboard
  • Ungültige oder gelöschte Zielperson
  • Fehlende Berechtigung für das Zielprojekt
  • Erneuter Versuch eines fehlgeschlagenen Datensatzes

Kontrolliere bei jedem Fall sowohl den Originaldatensatz als auch die erzeugte Aufgabe. Eine grüne Erfolgsmeldung im Automationswerkzeug genügt nicht, wenn die Aufgabe anschließend in der falschen Liste liegt oder ihre Referenz-ID fehlt.

Starte klein, aber vollständig

Für den ersten produktiven Ablauf genügt häufig ein einziges Formular, ein Aufgabenprojekt und eine Handvoll eindeutiger Verteilungsregeln. Vollständig bedeutet dabei nicht funktionsreich. Es bedeutet, dass Speicherung, Duplikatschutz, Zuständigkeit und Fehlerbehandlung vom ersten Tag an vorhanden sind.

Weitere Formulare lassen sich später anschließen, wenn sie dieselben Grundregeln erfüllen. Erst danach lohnt sich die Frage, ob automatische Prioritäten, Antwortvorlagen oder Auswertungen ergänzt werden sollen. Solche Erweiterungen verbessern einen stabilen Prozess. Sie reparieren keinen unklaren Eingang.

Eine zuverlässige Übergabe entsteht somit nicht durch die direkte Verbindung zweier Werkzeuge. Sie entsteht durch eine eindeutige Einreichungs-ID, eine dokumentierte Feldzuordnung, einfache Verteilungsregeln und einen sichtbaren Fehlerweg. Dann landet jede gültige Anfrage als bearbeitbare Aufgabe bei der richtigen Rolle – und das Postfach muss nicht länger als improvisiertes Ticketsystem auftreten.

Häufige Fragen

Kurz beantwortet, damit du schneller einschätzen kannst, was für dein Projekt wichtig ist.

Brauche ich für die Übergabe ein eigenes internes Tool?

Nicht zwingend. Ein vorhandenes Automationswerkzeug kann ausreichen, wenn es den Originaldatensatz speichert, eindeutige Referenzen unterstützt, Fehler sichtbar macht und fehlgeschlagene Übertragungen wiederholen kann.

Soll die Aufgabe direkt beim Absenden des Formulars erstellt werden?

Die Anfrage sollte zuerst zuverlässig gespeichert werden. Die Aufgabe kann anschließend im Hintergrund entstehen, damit ein vorübergehend nicht erreichbares Aufgabenboard die Formularübermittlung nicht blockiert.

Wie verhindere ich doppelte Aufgaben?

Vergib jeder Einsendung eine eindeutige ID und speichere sie zusammen mit der erzeugten Aufgaben-ID. Vor jedem neuen Erstellungsversuch prüft der Workflow, ob diese Zuordnung bereits existiert.

Welche Formulardaten gehören nicht ins Aufgabenboard?

Übertrage nur Angaben, die für Zuordnung und Bearbeitung erforderlich sind. Sensible Inhalte, vollständige Anhänge oder nicht benötigte Kontaktdaten bleiben besser im passend geschützten Ursprungssystem.

Kontakt

Lass uns über dein Projekt sprechen.

Ob neue Website, Laravel-Tool, Relaunch oder technischer Sparringstermin: Buch dir gern direkt einen Slot oder schreib mir eine Mail.

Erstgespräch buchen Lieber per Mail? hello@moritzklassen.com
Moritz Klaßen
Moritz Klaßen Entwickler & Ansprechpartner