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 oder Nicht importieren. Überprüfen Sie die Zuordnung jeder Spalte und korrigieren Sie fehlerhafte Zuweisungen über das Auswahlmenü daneben. Eine Vorschautabelle zeigt die ersten Zeilen genau so an, wie sie importiert werden.
    • Eine Telefonnummern-Spalte ist erforderlich – Sie können ohne diese Zuordnung nicht fortfahren.
    • Eine Spalte, die Tags zugeordnet ist, wird bei jedem Kontakt als echtes Tag gespeichert. Mehrere Tags in einer Zelle sind kein Problem – trennen Sie diese einfach durch ein Komma oder Semikolon (vip; newsletter; hotmart). Tags, die noch nicht existieren, werden automatisch erstellt; bereits vorhandene Tags werden wiederverwendet, wobei die Groß-/Kleinschreibung ignoriert wird.
  1. Überprüfen. 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 bestehende 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.
    • Bestehende Kontakte aktualisieren – standardmäßig deaktiviert. Wenn deaktiviert, werden Zeilen, die mit einem bereits vorhandenen Kontakt übereinstimmen (gleiche Telefonnummer), als Duplikate übersprungen: Am Kontakt ändert sich nichts und er wird nicht zur Liste hinzugefügt. Wenn aktiviert, aktualisieren diese Zeilen den Kontakt stattdessen: 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 ausgewählten Liste hinzugefügt. So importieren Sie eine Datei erneut, 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 (wenn diese Option aktiviert ist) und, falls Zeilen übersprungen wurden, eine Aufschlüsselung der Gründe (ungültige Telefonnummer, fehlende Telefonnummer, Duplikat, Kontaktlimit erreicht usw.).

Details zur Spaltenzuordnung

  • Telefon ist die einzige erforderliche Spalte. Zeilen ohne Telefonnummer werden vor dem Import verworfen und im 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; wenn 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).
  • Es gibt derzeit keine Spaltenzuordnung für beliebige benutzerdefinierte Felder (wie die custom_<fieldname>-Spalten der klassischen Version) – siehe Bulk-Loading Custom Fields für den aktuellen Workaround.

Tipps

  • Überprüfen Sie unbedingt, ob die Telefonnummern die Ländervorwahl enthalten. Ohne diese werden Nachrichten nicht zugestellt – und Zeilen ohne 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 Ländervorwahl.
  • Dateien werden vollständig in Ihrem Browser verarbeitet, daher gibt es vom Assistenten selbst kein festes Limit für die Upload-Größe – Ihre Gesamtzahl an Kontakten ist jedoch weiterhin durch Ihren Plan begrenzt. Wenn ein Import dazu führen würde, dass Sie das Limit Ihres Plans überschreiten, werden diese Zeilen abgelehnt und im Ergebnisbildschirm als contact_limit_reached angezeigt.
  • Wenn bereits ein Kontakt mit derselben Telefonnummer existiert, wird diese Zeile standardmäßig übersprungen – sie erscheint als duplicate auf dem Ergebnisbildschirm. Der Import erstellt niemals eine zweite Kopie einer Person. Um Kontakte, die Sie bereits haben, in großen Mengen zu bearbeiten (Namen oder E-Mails korrigieren, Tags hinzufügen, einer Liste hinzufügen), aktivieren Sie im Schritt „Überprüfen“ 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. Der automatische Abgleich des Assistenten erkennt nur Kopfzeilen für Name/Telefon/E-Mail/Tags/Notizen; alles andere wird standardmäßig auf Nicht importieren gesetzt. Daher wird eine custom_company-Spalte das benutzerdefinierte Feld company nicht von selbst befüllen. Fügen Sie die Werte anschließend über Benutzerdefinierte Felder oder über die API hinzu.

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