Firmenstammdaten im CRM von Hand nachzuschlagen kostet Zeit. Mit dem neuen Twenty-Connector kannst du firmafind-Abfragen in deine Twenty-Workflows einbauen und die Ergebnisse direkt im zugehörigen Firmendatensatz verwenden.
Der Connector besteht aus Code-Bausteinen und einer Einrichtungsanleitung. Du ordnest die Felder deines Workspaces zu und nutzt Twentys native Schritte zum Suchen, Aktualisieren und Anlegen von Datensätzen.
Zwei Wege zur Anreicherung
Für bestehende Firmen kannst du einen manuellen Workflow einrichten: Eine hinterlegte Firmenbuchnummer wird über firmafind abgefragt, anschließend werden Firmenname und Geschäftsführerübersicht im selben Twenty-Firmendatensatz aktualisiert.
Der zweite Workflow startet, wenn eine neue Company angelegt wird:
- Unternehmen zuordnen: Der eingetragene Firmenname wird mit der firmafind-Suche abgeglichen. Der Workflow fährt nur bei einer eindeutigen Namenszuordnung fort.
- Registerdaten abrufen: Die Firmenbuchnummer wird geprüft und die Geschäftsführer werden aus den Registerdaten übernommen. Inaktive Firmen werden übersprungen.
- Company ergänzen: Firmenbuchnummer und Geschäftsführerübersicht werden im ausgelösten Datensatz hinterlegt.
- Personen verknüpfen: Geschäftsführer können als People angelegt und mit der Company verbunden werden. Bereits verknüpfte Personen mit übereinstimmendem Namen werden übersprungen.
Ohne eindeutigen Treffer bleibt der Datensatz unverändert. Der Abgleich bestehender Personen erfolgt über Namen innerhalb derselben Firma; abweichende Schreibweisen können eine manuelle Prüfung erfordern.
Was übernommen wird
Der Connector verwendet die im Register ausgewiesenen Geschäftsführerrollen. Prokuristen, Gesellschafter und Vorstände werden dabei nicht als Geschäftsführer eingeordnet. Bei einer AG kann die Geschäftsführerliste deshalb leer sein.
Es werden keine E-Mail-Adressen oder Telefonnummern ergänzt. Der Registername bleibt als vollständiger Name erhalten, ohne Vor- und Nachnamen automatisch zu erraten.
Einrichtung und Credits
Du brauchst einen firmafind API-Key, passende Company-Felder und einen Twenty-Workflow. Die Bausteine laufen als Code-Schritte; ein zusätzlicher Connector-Server oder Twenty-API-Key ist dafür nicht erforderlich. Hinterlege deinen firmafind-Key in einer geschützten Konfiguration deines Workspaces.
Ein Abruf über eine bekannte Firmenbuchnummer kostet regulär einen Credit. Die automatische Zuordnung über den Namen mit anschließendem Detailabruf benötigt normalerweise zwei Credits. Auch eine Namenssuche ohne eindeutigen Treffer verbraucht einen Suchabruf.
Die Anleitung und Code-Bausteine für Twenty enthalten die Feldzuordnungen und Prüfschritte. Es handelt sich um eine manuell einzurichtende Workflow-Integration; teste sie vor der Aktivierung mit deiner Twenty-Version und deinem Workspace-Schema.
Wenn du Fragen zur Einrichtung hast, schreib uns an [email protected].