Zum Inhalt
ONE LOOP / Dokumentation / Plattform-Anleitungen

Plattform-Anleitungen

Bestehende Kontakte im Workflow finden

Finde zu übergebenen Daten den richtigen bestehenden Kontakt, baue sichere Treffer- und Nichttrefferwege auf und verhindere doppelte oder falsche Folgeaktionen.

Kurz erklärt

Die Aktion Kontakt finden sucht anhand von übergebenen Werten nach einem bereits vorhandenen Kontakt. Sie ist besonders nützlich, wenn ein Workflow startet, ohne dass ihm schon ein Kontakt zugeordnet ist – etwa wenn eine andere Anwendung nur eine E-Mail-Adresse, Telefonnummer oder eigene Kennung übergibt.

Nach der Suche entstehen automatisch zwei getrennte Wege:

  • Kontakt gefunden: Die nächsten Schritte arbeiten mit dem gefundenen Kontakt.

  • Kontakt nicht gefunden: Hier entscheidest du bewusst, ob ein neuer Kontakt angelegt, eine interne Aufgabe erstellt oder der Vorgang ohne weitere Aktion beendet wird.

Die Aktion erstellt selbst keinen Kontakt und ändert keine Daten. Sie entscheidet nur, welcher der beiden Wege weiterläuft.

Wann diese Aktion die richtige Wahl ist

Nutze Kontakt finden, wenn der auslösende Vorgang eine Person eindeutig beschreiben kann, aber noch kein Kontakt mitgeliefert wird. Typische Situationen sind:

  • Ein technischer Auslöser übergibt eine E-Mail-Adresse.

  • Eine Termin- oder Formularinformation soll dem richtigen bestehenden Kontakt zugeordnet werden.

  • Eine andere Anwendung übergibt eine stabile eigene Kennung, die du im Kontakt gespeichert hast.

  • Du willst vor einer Änderung prüfen, ob ein Kontakt existiert, statt vorschnell einen weiteren Datensatz anzulegen.

Nutze die Aktion nicht als unscharfe Namenssuche. Vorname, Nachname, Ort oder Unternehmensname können bei mehreren Personen gleich sein. Für automatische Abläufe brauchst du ein Merkmal, das zuverlässig zu genau einer Person passt.

Was vor dem Einrichten bereitstehen muss

Prüfe diese Voraussetzungen:

  • Der Auslöser liefert mindestens einen verwertbaren Wert, zum Beispiel eine E-Mail-Adresse, Telefonnummer oder eigene Kennung.

  • Derselbe Wert ist bereits im gewünschten Kontakt gespeichert.

  • Eingehender und gespeicherter Wert haben ein einheitliches Format. Schon kleine Unterschiede können einen Treffer verhindern.

  • Du hast für beide Ergebnisse einen Plan: Was soll bei einem Treffer passieren, was bei keinem Treffer?

  • Zum Testen gibt es mindestens einen vorhandenen Testkontakt sowie einen eindeutigen Wert, zu dem kein Kontakt existiert.

Tipp: Beginne mit nur einem wirklich eindeutigen Suchmerkmal. Füge erst dann ein zweites Merkmal hinzu, wenn die erste Suche im Test zu viele oder unklare Treffer liefern würde.

Das passende Suchfeld auswählen

Suchfeld

Sinnvoll, wenn

Wichtige Prüfung

E-Mail-Adresse

Die eingehende Adresse verlässlich ist und im Kontakt gepflegt wird.

Prüfe Schreibweise und ob die Adresse als Haupt- oder zusätzliche Adresse gespeichert ist.

Telefonnummer

Eine einheitliche Rufnummer übergeben wird.

Prüfe, dass die Darstellung vor und im Kontakt übereinstimmt.

Kontaktkennung

Der Auslöser bereits die eindeutige Kennung des Kontakts übergibt.

Verwende sie nur, wenn sie tatsächlich zum richtigen Kontakt gehört.

Eigenes Feld

Du eine stabile Kennung aus einem anderen System im Kontakt hinterlegt hast.

Das Feld muss angelegt und beim jeweiligen Kontakt gefüllt sein.

Name, Ort oder Unternehmensname

Nur als zusätzliche Eingrenzung zu einem eindeutigen Merkmal.

Nie als alleinige Grundlage für eine automatische Änderung verwenden.

Die Auswahl enthält sowohl Standardfelder als auch eigene Felder. In der Feldsuche kannst du die Liste durchsuchen und anschließend das gewünschte Feld auswählen.

Suchfeld und Suchwert richtig kombinieren

Jede Suchbedingung besteht aus einer Zeile mit zwei Teilen:

Teil der Zeile

Bedeutung

Worauf du achtest

Feld auswählen

Legt fest, welches gespeicherte Kontaktfeld geprüft wird. Die Auswahlliste lässt sich durchsuchen und trennt Standardfelder von eigenen Feldern.

Wähle die E-Mail nur, wenn der Auslöser auch wirklich eine E-Mail liefert. Eine Kontaktkennung darf nur mit der passenden Kennung verglichen werden.

Wert rechts daneben

Das ist der Wert, nach dem in diesem Feld gesucht wird. Im normalen Ablauf kommt er aus dem Auslöser; für einen kontrollierten Test kann er fest eingetragen sein.

Der Wert muss im gleichen Format vorliegen wie beim Kontakt. Kopiere keine Platzhalter oder Beispielwerte in den veröffentlichten Ablauf.

Über Feld hinzufügen entsteht eine weitere Bedingung. Eine versehentlich angelegte Zeile kannst du mit dem Papierkorb-Symbol am Ende dieser Zeile entfernen. Entferne sie, bevor du testest – auch eine leere oder falsche zusätzliche Bedingung kann den Treffer verhindern.

So funktioniert die Suche mit mehreren Feldern

Du kannst über Feld hinzufügen mehrere Bedingungen ergänzen. Diese Bedingungen werden mit und verknüpft: Alle ausgewählten Werte müssen beim selben Kontakt passen.

Beispiel:

  • E-Mail-Adresse stimmt.

  • Telefonnummer stimmt ebenfalls.

Nur wenn beide Werte beim selben Kontakt gespeichert sind, führt die Aktion zum Weg Kontakt gefunden. Passt die E-Mail zu Kontakt A und die Telefonnummer zu Kontakt B, wird kein Kontakt als Treffer verwendet.

Das schützt vor falschen Änderungen, kann aber bei unvollständigen oder uneinheitlichen Daten zu einem Nichttreffer führen. Ergänze daher nur Felder, die der Auslöser wirklich zuverlässig liefert.

Kontakt finden im Workflow einrichten

  1. Öffne Automatisierung > Workflows und erstelle einen neuen Ablauf oder öffne einen vorhandenen Ablauf zunächst als Entwurf.

  2. Füge unter dem Auslöser über das Pluszeichen eine neue Aktion hinzu.

  3. Suche im Bereich für Kontakte nach Kontakt finden und wähle die Aktion aus.

  4. Vergib einen klaren Aktionsnamen, zum Beispiel „Kontakt über E-Mail finden“. Der Name wird nur intern im Workflow angezeigt. Er sollte beschreiben, nach welchem Merkmal gesucht wird.

  5. Wähle unter Felder das erste Suchfeld aus:

    • Öffne die Auswahlliste.

    • Suche bei Bedarf nach dem Feldnamen.

    • Wähle ein Standardfeld oder ein eigenes Feld.

  6. Gib rechts daneben den Wert an, nach dem gesucht werden soll. Bei einem automatischen Ablauf verwendest du dafür den Wert aus dem Auslöser, damit jede Ausführung mit den tatsächlich eingegangenen Daten sucht. Einen fest eingetragenen Wert verwendest du nur für einen kontrollierten Test.

  7. Falls nötig, wähle Feld hinzufügen und ergänze weitere eindeutige Kriterien. Denke daran: Jedes zusätzliche Feld muss ebenfalls passen.

  8. Speichere die Aktion. Direkt darunter erscheinen die beiden Wege Kontakt gefunden und Kontakt nicht gefunden.

  9. Füge unter jedem Weg die passenden Folgeschritte hinzu. Veröffentliche den Workflow erst nach den Tests weiter unten.

Zusätzliche E-Mail-Adressen und Telefonnummern einbeziehen

Bei einer Suche über E-Mail-Adresse oder Telefonnummer wird zunächst der als Hauptwert gespeicherte Kontaktwert geprüft. In der Aktion kann zusätzlich ein Kontrollkästchen erscheinen:

  • Zusätzliche E-Mail-Adressen einbeziehen

  • Zusätzliche Telefonnummern einbeziehen

Aktivierst du die passende Option, wird auch in weiteren E-Mail-Adressen oder Telefonnummern des Kontakts gesucht. Das ist sinnvoll, wenn ein Kontakt mehrere erreichbare Werte hat und der Auslöser nicht immer den Hauptwert übergibt.

Aktiviere die Option nur, wenn zusätzliche Werte bei dir sorgfältig gepflegt werden. Sonst kann eine gemeinsame oder veraltete Adresse zu einer unerwarteten Zuordnung führen.

Die beiden Wege sicher aufbauen

Kontakt gefunden

In diesem Weg ist der gefundene Kontakt der Bezugspunkt für die nächsten Aktionen. Geeignete Folgeschritte sind zum Beispiel:

  • eine aktuelle Angabe am Kontakt ergänzen,

  • eine interne Aufgabe für die zuständige Person erstellen,

  • den Kontakt mit einem passenden Merkmal kennzeichnen,

  • eine gezielte Nachricht vorbereiten.

Prüfe vorher immer, ob die Aktion wirklich auf dem richtigen Datensatz arbeiten soll. Gerade bei Änderungen oder Nachrichten ist ein eindeutiges Suchfeld wichtiger als ein möglichst kurzer Workflow.

Kontakt nicht gefunden

Dieser Weg verhindert, dass ein unbekannter Wert unbemerkt verloren geht. Du kannst hier beispielsweise:

  • einen neuen Kontakt aus den vom Auslöser übergebenen Daten anlegen,

  • eine interne Prüfung anlegen, wenn Angaben fehlen oder nicht eindeutig sind,

  • den Vorgang beenden, wenn nur bestehende Kontakte verarbeitet werden dürfen.

Wenn du einen neuen Kontakt anlegst, übernimm die Kennung oder E-Mail-Adresse, mit der später erneut gesucht werden soll. So kann derselbe Vorgang beim nächsten Mal zuverlässig zugeordnet werden.

Vollständiger Test vor der Veröffentlichung

Teste nicht nur den Trefferweg. Beide Wege sind Teil derselben Einrichtung.

Test 1: Hauptwert findet einen bestehenden Kontakt

  1. Lege oder wähle einen Testkontakt mit einer eindeutig gespeicherten E-Mail-Adresse oder Telefonnummer.

  2. Übergib genau diesen Wert über den Testauslöser.

  3. Prüfe im Ausführungsprotokoll, ob der Weg Kontakt gefunden gelaufen ist.

  4. Prüfe am Kontakt, ob nur die erwarteten Folgeschritte ausgeführt wurden.

Test 2: Nichttreffer behandelt den Vorgang bewusst

  1. Übergib einen Wert, der in keinem Kontakt gespeichert ist.

  2. Prüfe im Ausführungsprotokoll, ob der Weg Kontakt nicht gefunden gelaufen ist.

  3. Kontrolliere, ob die dort vorgesehene Aktion korrekt ausgeführt wurde – etwa eine interne Aufgabe oder das Anlegen eines neuen Kontakts.

  4. Prüfe, dass kein bestehender Testkontakt versehentlich geändert wurde.

Test 3: Zusätzliche E-Mail-Adresse oder Telefonnummer

  1. Speichere bei einem Testkontakt einen zusätzlichen Wert.

  2. Suche zuerst bei ausgeschlossener Zusatzsuche nach diesem Wert. Das erwartete Ergebnis ist Kontakt nicht gefunden.

  3. Aktiviere anschließend die passende Option für zusätzliche Werte.

  4. Wiederhole den Test. Nun sollte der Weg Kontakt gefunden laufen.

Test 4: Mehrere Felder widersprechen sich

  1. Wähle zwei Suchfelder, beispielsweise E-Mail-Adresse und Telefonnummer.

  2. Übergib absichtlich eine E-Mail-Adresse von Kontakt A und eine Telefonnummer von Kontakt B.

  3. Prüfe, dass kein falscher Kontakt als Treffer verwendet wird.

  4. Korrigiere die Datenquelle oder vereinfache die Kriterien, wenn dieser Fall im Alltag vorkommen kann.

Typische Fehler und ihre Ursache

Beobachtung

Wahrscheinliche Ursache

So löst du es

Es wird kein Kontakt gefunden, obwohl er existiert.

Der übergebene Wert unterscheidet sich vom gespeicherten Wert oder das falsche Feld wurde gewählt.

Vergleiche den tatsächlichen Wert aus dem Auslöser mit dem Kontaktfeld und prüfe das Format Zeichen für Zeichen.

Die Suche findet bei mehreren Feldern keinen Kontakt.

Mindestens eines der zusätzlichen Felder passt nicht zum selben Kontakt.

Entferne das unzuverlässige Feld oder korrigiere die Daten, bevor der Workflow startet.

Ein Kontakt wird zu breit zugeordnet.

Die Suche nutzt ein nicht eindeutiges Feld, etwa einen Namen.

Verwende E-Mail-Adresse, Telefonnummer oder eine stabile eigene Kennung.

Eine zusätzliche Adresse führt nicht zum Treffer.

Die Zusatzsuche ist nicht aktiviert oder der Wert wurde nicht beim Kontakt gepflegt.

Aktiviere die passende Option in der Aktion und prüfe die zusätzlichen Kontaktdaten.

Der Workflow hat einen unbekannten Vorgang verarbeitet, aber keinen Kontakt angelegt.

Der Weg Kontakt nicht gefunden enthält keine Aktion zum Anlegen oder Prüfen.

Baue für den Nichttrefferweg einen klaren Folgeschritt ein und teste ihn separat.

Wichtige Grenzen

  • Die Aktion sucht nur anhand der von dir gewählten Felder und Werte. Sie errät keine fehlenden Angaben.

  • Sie erstellt, aktualisiert oder führt keine Kontakte selbst zusammen. Dafür brauchst du bewusst ergänzte Folgeaktionen.

  • Mehrere Suchfelder machen die Suche strenger, nicht großzügiger: Alle müssen beim selben Kontakt passen.

  • Die Aktion unterscheidet Treffer und Nichttreffer, löst aber kein Qualitätsproblem in den zugrunde liegenden Daten. Prüfe regelmäßig, ob Kennungen, E-Mail-Adressen und Telefonnummern einheitlich gepflegt werden.

Praxisbeispiel: Neue Anfrage richtig zuordnen

Ein Formularsystem übergibt für jede Anfrage eine E-Mail-Adresse, aber keinen bereits zugeordneten Kontakt.

  1. Der Workflow startet mit der eingegangenen E-Mail-Adresse.

  2. Die Aktion Kontakt finden sucht über das Feld E-Mail-Adresse nach einem bestehenden Kontakt.

  3. Bei Kontakt gefunden ergänzt der Workflow die Angabe „letzte Anfrage“ am vorhandenen Kontakt und erstellt eine interne Aufgabe für das Team.

  4. Bei Kontakt nicht gefunden legt der Workflow einen neuen Kontakt mit der eingegangenen E-Mail-Adresse an und kennzeichnet ihn für die erste Prüfung.

  5. Das Team testet einmal mit einer vorhandenen und einmal mit einer unbekannten E-Mail-Adresse. Erst wenn beide Wege im Ausführungsprotokoll nachvollziehbar sind, wird der Ablauf veröffentlicht.

← Zur Artikelübersicht