> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/automatisierung/workflows/unternehmen-und-zugeordnete-kontakte-im-workflow-pflegen.md). # Unternehmen und zugeordnete Kontakte im Workflow pflegen Lege in Workflows Unternehmen und zugeordnete Kontakte an oder aktualisiere sie anhand vorhandener Workflow-Daten, ohne Beziehungen manuell nachzupflegen. ## Das Ergebnis Mit Unternehmens-Workflows kannst du einen Unternehmensdatensatz anlegen, einen zugeordneten Kontakt erzeugen oder bestehende Daten aktualisieren. Die Aktion übernimmt dabei Werte aus dem Workflow, etwa aus einem Formular, einem Webhook, Unternehmensfeldern oder fest eingetragenem Text. Wähle die Aktion nach dem gewünschten Ergebnis: **anlegen** erstellt einen neuen Datensatz, **aktualisieren** ändert nur einen bestehenden. Ein falscher Einsatz kann doppelte Unternehmen oder ungewollt überschriebene Daten erzeugen. ## Voraussetzung: passenden Workflowtyp wählen * **Unternehmensbasierter Workflow:** Kann ein Unternehmen oder einen bereits zugeordneten Kontakt anlegen beziehungsweise aktualisieren. * **Kontaktbasierter Workflow:** Kann ein neues Unternehmen anlegen und direkt mit dem auslösenden Kontakt verknüpfen. Prüfe vor dem Aufbau, welches Objekt den Workflow auslöst. Eine Aktion für Unternehmensdaten ist nicht automatisch in einem kontaktbasierten Ablauf verfügbar. ## Neues Unternehmen oder zugeordneten Kontakt anlegen In einem unternehmensbasierten Workflow wählst in der Aktion, ob ein neues Unternehmen oder ein neuer, zu diesem Unternehmen gehörender Kontakt angelegt werden soll. 1. Füge die Aktion zum Unternehmens-Workflow hinzu. 2. Vergib bei **Aktionsname** eine kurze interne Bezeichnung, zum Beispiel „Unternehmen aus Anfrage anlegen“. Sie hilft dir später beim Prüfen des Workflowverlaufs. 3. Wähle beim Pflichtfeld für den zu erstellenden Datensatz: **Unternehmen** oder **zugeordneter Kontakt**. 4. Wähle in der ersten Feldzeile das Zielfeld und ordne ihm den passenden Wert zu. 5. Ergänze weitere Feldzeilen über **Feld hinzufügen**. 6. Entferne eine versehentliche oder nicht mehr benötigte Feldzeile über das **X** am Ende der Zeile. 7. Speichere die Aktion und teste sie mit einem eindeutig gekennzeichneten Unternehmen. Wählst du einen zugeordneten Kontakt, wird er automatisch mit dem Unternehmen verknüpft, das den Workflow ausgelöst hat. Die Beziehung erscheint anschließend in den Unternehmens- und Kontaktdetails. ## Unternehmen für einen Kontakt anlegen und zuordnen In einem kontaktbasierten Workflow erstellt die Aktion ein neues Unternehmen und verknüpft es direkt mit dem auslösenden Kontakt. 1. Füge die Aktion zum kontaktbasierten Workflow hinzu. 2. Vergib bei **Aktionsname** eine klare interne Bezeichnung. 3. Wähle in der ersten Feldzeile mindestens den Unternehmensnamen. 4. Trage einen festen Wert ein oder nutze den Werte-Picker, um eine Angabe aus Kontaktfeldern, Workflow-Daten oder einem eingehenden Webhook einzusetzen. 5. Ergänze bei Bedarf Domain, Branche oder eigene Unternehmensfelder über **Feld hinzufügen**. Entferne eine nicht benötigte Zeile über das **X**. 6. Speichere die Aktion und teste die Ausführung an einem Testkontakt. 7. Öffne danach sowohl Kontakt als auch Unternehmen und kontrolliere die Beziehung. > **Wichtig:** Hat der Kontakt bereits ein zugeordnetes Unternehmen, erstellt diese Aktion laut geprüfter Quelle trotzdem ein weiteres Unternehmen. Dieses zusätzliche Unternehmen wird dabei nicht automatisch mit dem auslösenden Kontakt verknüpft. Prüfe daher vorab, ob ein vorhandenes Unternehmen gesucht oder aktualisiert werden muss. ## Bestehende Daten aktualisieren Die Aktualisierungsaktion verändert einen vorhandenen Unternehmensdatensatz oder einen damit verknüpften Kontakt. Sie erstellt keine neuen Datensätze. 1. Füge die Aktualisierungsaktion in einen unternehmensbasierten Workflow ein. 2. Vergib bei **Aktionsname** eine eindeutige interne Bezeichnung, damit der Schritt im Workflowverlauf erkennbar bleibt. 3. Wähle beim Pflichtfeld für den zu aktualisierenden Datensatz **Unternehmen** oder **zugeordneter Kontakt**. 4. Füge über **Feld hinzufügen** nur die Felder hinzu, die wirklich geändert werden sollen, und ordne die passenden Werte zu. 5. Speichere und teste die Aktion. 6. Kontrolliere im Workflowverlauf und im Datensatz, ob nur die erwarteten Werte geändert wurden. Wenn keine passenden zugeordneten Kontakte existieren, wird die Aktualisierungsaktion für diese Kontakte übersprungen. Das ist kein automatisches Anlegen eines neuen Kontakts. ## Feldwerte sauber zuordnen Du kannst Werte aus folgenden Quellen nutzen: | Quelle | Geeignet für | | ----------------------------------- | ---------------------------------------------------- | | Daten aus einem eingehenden Webhook | strukturierte Informationen aus einem anderen System | | Unternehmens- oder Kontaktfelder | bereits gepflegte Standortdaten | | Workflow-Werte | Ergebnis vorheriger Schritte | | Fester Text | einheitliche Status- oder Herkunftsangabe | Jede Zeile in der Feldzuordnung verbindet genau ein Zielfeld mit einem Wert. Prüfe Feldtyp und Datumsformat sorgfältig. Ein falsch zugeordnetes Feld kann vorhandene, wichtige Daten überschreiben. ## Test und Ergebnis prüfen 1. Verwende einen Testkontakt oder ein Testunternehmen mit eindeutigem Namen. 2. Starte den Workflow einmal mit vollständigen Daten und einmal mit fehlenden Angaben. 3. Prüfe neue oder aktualisierte Felder im Unternehmensprofil. 4. Prüfe die Beziehung zwischen Kontakt und Unternehmen. 5. Wiederhole den Test mit einem bereits zugeordneten Kontakt, wenn die Aktion ein Unternehmen anlegt. 6. Kontrolliere den Workflowverlauf auf übersprungene oder fehlgeschlagene Schritte. ## Praxisbeispiel Ein B2B-Formular übermittelt Unternehmensname, Domain und Ansprechpartner. Ein kontaktbasierter Workflow legt daraus ein Unternehmen an und verknüpft es mit dem Kontakt. Später erhält das Team über einen Webhook eine neue Branche und Telefonnummer. Ein unternehmensbasierter Workflow aktualisiert nur diese vorhandenen Felder. Bevor beide Abläufe aktiv werden, testet das Team einen vollständigen Datensatz, fehlende Daten und einen Kontakt, der bereits einem Unternehmen zugeordnet ist. ## Häufige Fehler ### Doppelte Unternehmen entstehen Die Aktion zum Anlegen prüft nicht automatisch, ob der Kontakt bereits mit einem Unternehmen verbunden ist. Suche oder prüfe vorhandene Daten vor dem Anlegen. ### Bestehende Werte werden überschrieben Begrenze die Feldzuordnung auf wirklich notwendige Felder und teste mit einem kopierten Testdatensatz. ### Ein zugeordneter Kontakt wird nicht aktualisiert Prüfe, ob der Workflow unter dem richtigen Unternehmen läuft und ob tatsächlich ein verknüpfter Kontakt existiert. Ohne passende Beziehung wird die Aktualisierung übersprungen. ## Verknüpftes Unternehmen im kontaktbasierten Workflow aktualisieren Ein kontaktbasierter Workflow kann das **primär zugeordnete Unternehmen** des auslösenden Kontakts ändern. Das ist sinnvoll, wenn neue Angaben am Kontakt eingehen, zum Beispiel über ein Formular oder einen Webhook, und die entsprechenden Unternehmensfelder mitgezogen werden sollen. 1. Öffne einen kontaktbasierten Workflow. 2. Füge die Aktion **Zugeordnetes Unternehmen aktualisieren** hinzu. 3. Wähle das Unternehmensfeld, das geändert werden soll. 4. Ordne einen Wert aus Kontaktfeldern, Workflow-Daten, eingehenden Webhook-Daten oder festem Text zu. 5. Ergänze weitere Feldzuordnungen nur für Werte, die tatsächlich geändert werden sollen. 6. Speichere die Aktion und teste sie mit einem Kontakt, der eindeutig einem Unternehmen zugeordnet ist. Die Aktion ändert nur einen vorhandenen, primär verknüpften Unternehmensdatensatz. Sie legt kein neues Unternehmen an. Hat der Kontakt keine Unternehmenszuordnung, wird dieser Schritt übersprungen. Das ist besonders wichtig bei Formularen: Prüfe vorab, ob jeder erwartete Kontakt tatsächlich mit einem Unternehmen verbunden ist. Die Feldwerte können aus Kontaktfeldern, Workflow-Daten, eingehenden Webhook-Daten oder festem Text stammen. Wenn du das Feld **Domain** pflegst, kann eine E-Mail-Adresse aus dem Kontakt als Quelle dienen; daraus wird die Domain abgeleitet. Prüfe dieses Ergebnis mit einem Testkontakt, besonders bei unvollständigen oder ungewöhnlichen E-Mail-Adressen. ### Praxisbeispiel: Unternehmensdaten aus einer Anfrage ergänzen Ein Ansprechpartner sendet ein Formular ab und ergänzt die Unternehmensdomain. Der kontaktbasierte Workflow übernimmt ausschließlich die Domain in das zugeordnete Unternehmen. Ein Test mit einem Kontakt ohne Zuordnung zeigt, dass dort kein neuer Unternehmensdatensatz entsteht und der Schritt ordnungsgemäß übersprungen wird. ## Felder des zugeordneten Unternehmens in Kontakt-Workflows leeren Mit **Felder des zugeordneten Unternehmens leeren** entfernst du gezielt Werte aus dem primär verknüpften Unternehmen eines Kontakts. Das eignet sich für veraltete Statusangaben oder zeitlich begrenzte Informationen. 1. Erstelle oder öffne einen kontaktbasierten Workflow. 2. Füge die Aktion zum Leeren von Unternehmensfeldern hinzu. 3. Wähle ein oder mehrere bearbeitbare Standard- oder eigene Unternehmensfelder. 4. Speichere die Aktion. 5. Teste den Ablauf mit einem Testkontakt und prüfe das Unternehmensprofil. Die Aktion leert nur die ausgewählten Feldwerte. Sie löscht weder das Unternehmen noch die Zuordnung zwischen Kontakt und Unternehmen. Sie betrifft ausschließlich Unternehmensfelder, nicht Felder des Kontakts. Ohne Unternehmenszuordnung wird sie übersprungen. Hat ein Kontakt mehrere Unternehmenszuordnungen, bearbeitet die Aktion das primär verknüpfte Unternehmen. ## Unternehmens- oder Kontaktfelder im Unternehmens-Workflow leeren In einem unternehmensbasierten Workflow kannst du Werte entweder am auslösenden Unternehmen oder an den damit verknüpften Kontakten zurücksetzen. 1. Füge die Aktion **Unternehmens- oder zugeordnete Kontaktfelder leeren** hinzu. 2. Wähle als Ziel **Unternehmen** oder **zugeordneter Kontakt**. 3. Wähle die zu leerenden Standard- oder eigenen Felder aus; über **Feld hinzufügen** kannst du mehrere Felder wählen. 4. Speichere und starte einen Testlauf. 5. Kontrolliere die erwarteten Felder in den betroffenen Datensätzen. Wählst du zugeordnete Kontakte, werden die ausgewählten Felder bei allen zugeordneten Kontakten geleert. Gibt es keine zugeordneten Kontakte, überspringt der Workflow diesen Teil. Auch hier bleiben Datensätze und Beziehungen bestehen; nur die ausgewählten Werte werden entfernt. > **Sicher arbeiten:** Leere Felder zuerst in einem Testdatensatz. Ein einmal geleerter Wert wird durch diese Aktion nicht automatisch wiederhergestellt. ## Gegenseitige Aktualisierungen ohne Schleife aufbauen Ein Unternehmens-Workflow kann zugeordnete Kontakte ändern; ein kontaktbasierter Workflow kann wiederum ein zugeordnetes Unternehmen ändern. Ohne Schutz kann eine Änderung den jeweils anderen Ablauf erneut starten. Lege deshalb eine eindeutige Richtung fest oder verwende ein eigenes Kontrollfeld, zum Beispiel **Durch Automatisierung aktualisiert**. Prüfe dieses Feld als Bedingung, bevor ein Folgeablauf startet, und setze oder entferne es kontrolliert. Teste mindestens diese Fälle: Änderung am Unternehmen, Änderung am Kontakt und eine erneute Ausführung mit unverändertem Wert. So bleibt nachvollziehbar, welcher Ablauf Daten ändern darf. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/automatisierung/workflows/unternehmen-und-zugeordnete-kontakte-im-workflow-pflegen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.