Your AI Connector Docs

Kontakte aus einer Datei importieren

Wenn Sie eine Kontaktliste in einer Tabellenkalkulation haben, können Sie diese alle auf einmal hochladen, anstatt sie einzeln hinzuzufügen. Die App verwendet einen 3-stufigen Assistenten — Hochladen → Spalten zuordnen → Überprüfen —, der mit Ihrer vorhandenen CSV-Datei funktioniert, ohne dass Sie zuerst eine Vorlage herunterladen müssen.

So importieren Sie Kontakte

  1. Klicken Sie in der linken Seitenleiste auf Kontakte und dann oben auf der Seite auf Importieren.
  2. Hochladen. Ziehen Sie Ihre CSV-Datei in den Drop-Bereich oder klicken Sie darauf, um sie zu suchen. Es muss keine Vorlage heruntergeladen werden – verwenden Sie einfach die Datei, die Sie bereits haben.
  1. Spalten zuordnen. Der Assistent liest die Kopfzeile Ihrer Datei und versucht, jede Spalte automatisch einem Zielfeld zuzuordnen: Vorname, Nachname, Telefon, E-Mail, Tags, Notizen, eines Ihrer benutzerdefinierten Felder oder Nicht importieren. Überprüfen Sie die Zuordnung für jede Spalte und korrigieren Sie fehlerhafte Zuweisungen über das Auswahlmenü daneben. Eine Vorschautabelle zeigt die ersten paar Zeilen genau so an, wie sie importiert werden.
    • Eine Spalte, deren Kopfzeile dem Namen eines Ihrer benutzerdefinierten Felder entspricht, wird automatisch diesem Feld zugeordnet. Groß-/Kleinschreibung und Akzente spielen dabei keine Rolle, sodass eine CPF-Spalte ein Feld namens cpf findet. Sie können auch manuell ein beliebiges benutzerdefiniertes Feld für jede Spalte auswählen.
    • Eine Spalte, die noch keinem Ihrer benutzerdefinierten Felder entspricht, kann zu einem solchen werden: Wählen Sie im Auswahlmenü Neues benutzerdefiniertes Feld: , und das Feld wird beim Importieren erstellt.
    • Wenn ein benutzerdefiniertes Feld einen bestimmten Typ hat (Zahl, Kontrollkästchen, Dropdown) und einige Werte der Spalte nicht dazu passen, warnt Sie der Assistent vor dem Import, wie viele Zeilen davon betroffen sind. Diese Zeilen werden vollständig übersprungen, einschließlich Name und E-Mail. Klicken Sie in der Warnmeldung auf in Text umwandeln, um den Feldtyp in einem Schritt zu ändern, die Werte zu korrigieren oder die Spalte auf Nicht importieren zu setzen.
    • Eine Telefonnummern-Spalte ist erforderlich – Sie können ohne die Zuordnung einer solchen Spalte nicht fortfahren.
    • Eine Spalte, die Tags zugeordnet ist, wird bei jedem Kontakt in echte Tags umgewandelt. Mehrere Tags in einer Zelle sind möglich – trennen Sie diese einfach durch ein Komma oder Semikolon (vip; newsletter; hotmart). Tags, die noch nicht existieren, werden für Sie erstellt; bereits vorhandene Tags werden wiederverwendet, wobei die Groß-/Kleinschreibung ignoriert wird.
  1. Überprüfung. Wählen Sie:
    • Standardkanal — WhatsApp Business, WhatsApp Web oder SMS. Dies gilt für jeden importierten Kontakt, für den noch kein Kanal festgelegt wurde.
    • Liste — Wählen Sie eine vorhandene Liste aus dem Dropdown-Menü oder geben Sie einen Namen ein, um direkt eine neue zu erstellen. Sie können nur eine der beiden Optionen wählen, nicht beide. Wenn Sie den Import öffnen, während auf der Seite „Kontakte“ eine Ihrer Listen angezeigt wird, ist diese bereits für Sie vorausgewählt; entfernen Sie sie, falls Sie dies nicht möchten.
    • Bestehende Kontakte aktualisieren — standardmäßig deaktiviert. Wenn deaktiviert, werden Zeilen, die einem bereits vorhandenen Kontakt entsprechen (gleiche Telefonnummer), als Duplikate übersprungen: Am Kontakt ändert sich nichts, obwohl der bereits vorhandene Kontakt der von Ihnen gewählten Liste hinzugefügt wird, falls Sie eine ausgewählt haben. Wenn aktiviert, werden diese Zeilen stattdessen aktualisiert: Name, E-Mail und Notizen in Ihrer Datei überschreiben die vorhandenen Daten (leere Zellen lassen den aktuellen Wert unverändert), alle Tags in der Zeile werden hinzugefügt und der Kontakt wird der von Ihnen gewählten Liste hinzugefügt. Auf diese Weise können Sie eine Datei erneut importieren, um bereits vorhandene Kontakte zu korrigieren oder zu ergänzen.
  1. Klicken Sie auf [count] importieren. Sie gelangen zu einem Ergebnisbildschirm, der anzeigt, wie viele Kontakte erstellt wurden, wie viele bestehende Kontakte aktualisiert wurden (sofern diese Option aktiviert war), wie viele Ihrer bereits vorhandenen Kontakte der ausgewählten Liste hinzugefügt wurden und – falls Zeilen übersprungen wurden – eine Aufschlüsselung der Gründe (ungültige Telefonnummer, fehlende Telefonnummer, Duplikat, Kontaktlimit erreicht usw.). Wenn Bestehende Kontakte aktualisieren deaktiviert war und einige Zeilen mit bereits vorhandenen Kontakten übereinstimmten, weist der Ergebnisbildschirm darauf hin und bietet Diese Kontakte aktualisieren an: Mit einem Klick werden nur diese Zeilen mit aktivierter Option erneut gesendet, sodass Sie die Datei nicht erneut importieren müssen.

Details zur Spaltenzuordnung

  • Telefon ist die einzige erforderliche Spalte. Zeilen ohne Telefonnummer werden vor dem Import verworfen und auf dem Ergebnisbildschirm separat gezählt.
  • Vorname / Nachname / E-Mail werden direkt den grundlegenden Kontaktfeldern zugeordnet.
  • Notizen werden dem Feld Notizen / Lead-Profil des Kontakts zugeordnet.
  • Tags erstellt (oder verwendet) echte Tags und weist sie dem Kontakt zu — dieselben Tags, nach denen Sie filtern, für die Sie Broadcasts ausrichten und von denen aus Sie Webhooks auslösen können. Fügen Sie mehrere Tags in eine Zelle ein, getrennt durch Kommas oder Semikolons. Vor dem 19. August 2026 wurde diese Spalte stattdessen als benutzerdefiniertes Feld namens tags gespeichert; falls Sie vor diesem Datum importiert haben, importieren Sie die Datei erneut mit aktivierter Option Bestehende Kontakte aktualisieren, damit die Tags korrekt angewendet werden (das verbleibende benutzerdefinierte Feld tags schadet nicht; kontaktieren Sie den Support, wenn es von allen Kontakten entfernt werden soll).
  • Benutzerdefinierte Felder — jedes Ihrer benutzerdefinierten Felder ist ein eigenes Ziel. Eine Kopfzeile, die mit einem Feldnamen übereinstimmt, wird automatisch für Sie ausgewählt; der Wert wird exakt so gespeichert, wie er in der Datei steht (ein Zahlen-, Datums-, Kontrollkästchen- oder Dropdown-Feld konvertiert erkennbare Formate wie 19,99, 01/02/1990 oder yes). Wählen Sie Neues benutzerdefiniertes Feld, um ein Feld aus einer Spalte zu erstellen. Wenn Bestehende Kontakte aktualisieren aktiviert ist, aktualisieren Werte für benutzerdefinierte Felder in der Datei auch Ihre vorhandenen Kontakte; leere Zellen lassen den aktuellen Wert unverändert.
  • Eine Spalte, die Identifikatoren mit Punkten, Bindestrichen oder führenden Nullen enthält (z. B. eine CPF, Steuernummer, Postleitzahl), gehört in ein Text-Feld. In einem Zahlenfeld passen diese Werte nicht, und die Zeile wird übersprungen.

Tipps

  • Überprüfen Sie unbedingt, ob die Telefonnummern die Landesvorwahl enthalten. Ohne diese werden Nachrichten nicht zugestellt – und Zeilen ohne eine verwendbare Telefonnummer werden vollständig übersprungen.
  • Sie müssen keine Leerzeichen, Bindestriche oder Klammern aus den Telefonnummern entfernen – der Importeur toleriert gängige Formatierungen, benötigt aber dennoch die Landesvorwahl.
  • Dateien werden vollständig in Ihrem Browser analysiert, daher gibt es kein festes Upload-Größenlimit durch den Assistenten selbst – aber Ihre Gesamtzahl an Kontakten ist weiterhin durch Ihren Tarif begrenzt. Wenn ein Import dazu führen würde, dass Sie das Limit Ihres Tarifs überschreiten, werden diese Zeilen abgelehnt und auf dem Ergebnisbildschirm als contact_limit_reached angezeigt.
  • Wenn ein Kontakt mit derselben Telefonnummer bereits existiert, wird diese Zeile standardmäßig übersprungen – sie erscheint als duplicate auf dem Ergebnisbildschirm. Der Import erstellt niemals eine zweite Kopie einer Person. Das Auswählen einer Liste funktioniert bei diesen Zeilen dennoch: Der bereits vorhandene Kontakt wird der Liste hinzugefügt und auf dem Ergebnisbildschirm separat gezählt. Das erneute Importieren derselben Datei ist also die Methode, um eine Liste mit Personen zu füllen, die bereits in Ihrem Konto vorhanden sind. Um zusätzlich deren Felder zu aktualisieren (Namen oder E-Mails korrigieren, Tags hinzufügen), aktivieren Sie im Schritt „Überprüfung“ die Option Bestehende Kontakte aktualisieren und importieren Sie die Datei erneut.

Häufig gestellte Fragen

Meine CSV-Datei enthält eine custom_company-Spalte aus einem alten Export — wird diese korrekt zugeordnet? Nicht automatisch, da die Kopfzeile nicht exakt company lautet. Wählen Sie im Auswahlmenü der Spalte Benutzerdefiniertes Feld: company, damit der Import in das Feld company erfolgt. Wenn Sie die Kopfzeile vor dem Hochladen in company umbenennen, erkennt der Assistent die Zuordnung automatisch.

Einige Zeilen wurden mit dem Hinweis „Ein Wert eines benutzerdefinierten Feldes passt nicht zum Typ des Feldes“ übersprungen – warum? Die Spalte ist einem typisierten benutzerdefinierten Feld zugeordnet (z. B. Zahl), aber diese Zeilen enthalten etwas anderes, wie z. B. 001.576.401-08 in einem Zahlenfeld. Klicken Sie im Schritt „Spalten zuordnen“ in der Warnmeldung auf in Text umwandeln (oder ändern Sie den Typ unter „Benutzerdefinierte Felder“) und importieren Sie die Datei erneut mit aktivierter Option Bestehende Kontakte aktualisieren.

Wo ist der „Vorlage herunterladen“-Button hin? Er ist weg – der Assistent arbeitet direkt mit der CSV-Datei, die Sie bereits haben, und lässt Sie im Schritt „Zuordnen“ fehlerhafte Spaltenzuordnungen korrigieren.

Ich habe meine Kontakte bereits importiert – wie kann ich für alle gleichzeitig Tags hinzufügen oder Felder korrigieren? Importieren Sie dieselbe Datei (oder eine aktualisierte Version) erneut, wobei Sie im Schritt „Überprüfen“ die Option Bestehende Kontakte aktualisieren aktivieren. Zeilen, die mit einer bestehenden Telefonnummer übereinstimmen, aktualisieren den jeweiligen Kontakt – Name, E-Mail, Notizen, Tags und Liste – anstatt übersprungen zu werden. Da nur die Telefonnummern für den Abgleich verwendet werden, behalten Sie diese Spalte bitte genau so bei, wie sie war.

Kann ich Instagram- oder Messenger-Kontakte aus einer Datei importieren? Nein. Der Import unterstützt nur WhatsApp Business, WhatsApp Web und SMS, da diese Kanäle Personen über ihre Telefonnummer erreichen. Instagram und Messenger identifizieren Personen stattdessen über ihr soziales Konto. Daher werden diese Kontakte automatisch erstellt, sobald Ihnen jemand über diesen Kanal eine Nachricht sendet.

Kann ich Kontakte als „Bot inaktiv“ importieren? Es gibt dafür keine spaltenbasierte Option pro Zeile. Importieren Sie den Stapel zuerst und verwenden Sie dann die Massenaktion Bot aus für die importierten Kontakte – siehe Kontakte vom KI-Bot ausschließen.

Nächste Schritte