Kontakte aus Excel oder CSV importieren (mit Einwilligung)

Kontakte → Importieren (/app/contacts/import) übernimmt eine ganze Kundenliste aus einer Datei. Kontakt hinzufügen auf der Seite Kontakte fügt eine Person manuell hinzu. Es wird nichts gespeichert, bis Sie die Datei geprüft und auf die Import-Schaltfläche geklickt haben.

Bevor Sie beginnen

• Zum Importieren ist die Aufgabe Kontakte importieren erforderlich (standardmäßig Inhaber und Administratoren; ein Inhaber oder Administrator kann sie jedem mit Zugriff bearbeiten unter Einstellungen → Mitglieder erteilen, siehe Rollen und Aufgaben). Ohne sie ist die Schaltfläche Importieren ausgeblendet, und die Seite zeigt Zum Importieren von Kontakten benötigen Sie die Aufgabe „Kontakte importieren“. Fragen Sie einen Inhaber oder Administrator.
• Kontakt hinzufügen erfordert die Aufgabe Kontakte verwalten (standardmäßig Inhaber, Administratoren und Editoren).
• Die Datei: CSV (UTF-8, UTF-16 oder Windows Arabisch; Kommas, Semikolon oder Tabus) oder Excel .xlsx (das erste Blatt). Bis zu 20 MB, 100.000 Zeilen und 200 Spalten. Ein altes Excel- .xls wird abgelehnt: In Excel wählen Sie Datei > Als Speichern > Excel-Arbeitsbuch (.xlsx) oder CSV UTF-8.
• Die erste Zeile muss die Spalten benennen, zum Beispiel Name, Phone, Email oder الاسم، الجوال، البريد الإلكتروني. Jede Person benötigt eine Telefonnummer oder eine E-Mail-Adresse.
• Um benutzerdefinierte Angaben (Mitgliedsstufe, Geburtstag...) zu importieren, legen Sie die Felder zuerst unter Benutzerdefinierte Kontaktfelder an.

Schritt für Schritt: eine Datei importieren

1. Klicken Sie unter Kontakte auf Importieren.
2. Datei: Klicken Sie auf Datei auswählen, wählen Sie sie aus und klicken Sie auf Hochladen. Sie sehen Datei wird gelesen… und dann die Spalten.
3. Spalten: Unter Spalten zuordnen hat jede Spalte Ihrer Datei ein Feld Importieren als. Wir leiten die Zuordnung aus den Kopfzeilen in den zehn Sprachen der App ab, mit oder ohne Akzente (الجوال, Téléphone, Handy oder Cep telefonu → Telefon (WhatsApp), الاسم, Nom complet oder Nama → Name, eine Kopfzeile, die einem benutzerdefinierten Feld entspricht → dieses Feld). Neben einer Vornamenspalte wird ein bloßes Nom oder Name als Nachname gewertet; neben einer Nachnamenspalte Nome oder Nombre als Vorname. Setzen Sie Spalten, die Sie nicht brauchen, auf Nicht importieren. Beispiel zeigt einen Wert aus der Datei. Wenn eine Spalte, die auf Nicht importieren gesetzt ist, wie Telefonnummern oder E-Mail-Adressen aussieht (und keine andere Spalte darauf gesetzt ist), steht darunter eine gelbe Zeile, zum Beispiel Diese Spalte sieht wie Telefonnummern aus, ist aber auf „Nicht importieren“ gesetzt, daher werden sie nicht importiert. Wählen Sie „Telefon (WhatsApp)“, um sie zu importieren.
4. Unter Optionen:

• Land für lokale Nummern: Zahlen, die ohne Ländercode geschrieben werden ('07400 123456' oder '7400 123456', als Excel die Null weggelassen hat), werden als Zahlen dieses Landes gelesen. Arabische Ziffern (٠٥٠...) sind in Ordnung. Eine Land-Spalte in der Datei gewinnt für ihre Zeile. Sie beginnt als das Land Ihres Unternehmens (ohne Zeichen für Wählen Sie ein Land, und es werden nur Zahlen mit ihrem Ländercode gelesen); die Liste enthält jedes Land, das in Ihrer Sprache benannt ist, alphabetisch unter Alle Länder (das Land, in dem Ihr Browser angibt, dass Sie sich befinden, steht zuerst unter Vorgeschlagen

• Personen, die bereits in den Kontakten sind (gleiche Telefonnummer oder E-Mail): Mit den Werten aus der Datei aktualisieren (gefüllte Zellen ersetzen, was der Kontakt hatte, leere Zellen löschen nie etwas, Tags werden hinzugefügt, eine Telefonnummer oder E-Mail wird nur hinzugefügt, wenn der Kontakt keine hat) oder Überspringen.
• Zusätzliche Tags für alle Importierten (durch Kommas getrennt): bis zu 10 Tags, jedes bis zu 50 Zeichen lang (ein führendes # wird ignoriert). Bei mehr erscheint unter dem Feld Add at most 10 extra tags. Remove some, or add them later with Add tags., und bei einem längeren Tag A tag can be at most 50 characters. Shorten it, or split it with a comma.; Weiter wartet, bis das Feld stimmt.

5. Klicken Sie auf Weiter.
6. Einwilligung: Wählen Sie Nein - sie haben nicht zugestimmt, oder ich weiß es nicht oder Ja - sie haben zugestimmt, und ich kann angeben, wie. Bei Ja aktivieren Sie die Kanäle, denen zugestimmt wurde (WhatsApp, SMS, E-Mail), wählen Wo wurde zugestimmt?, beschreiben Wie haben diese Personen zugestimmt? (mindestens 10 Zeichen, zum Beispiel "Sie haben beim Beitritt zu unserem Treueprogramm Angebote per WhatsApp angekreuzt"), füllen Wann zugestimmt wurde (optional) aus, wenn Sie es wissen, und aktivieren Ich bestätige, dass diese Personen diese Einwilligung erteilt haben und ich auf Anfrage einen Nachweis vorlegen kann.
7. Klicken Sie auf Datei prüfen. Die Prüfung liest jede Zeile und speichert nichts (n von N Zeilen werden geprüft…).
8. Ergebnis der Prüfung zeigt Bereit zum Import, Mit Problemen, Neue Kontakte, Bereits in den Kontakten und In der Datei wiederholt sowie die Erste Zeilen mit Problemen mit Begründung. Einstellungen ändern führt Sie zurück; errors.csv herunterladen liefert jede Problemzeile. Ein Kontakt hat höchstens 20 Tags: Würden einige Personen dieses Limit überschreiten, sagt die Prüfung das, zum Beispiel 3 contacts would pass the limit of 20 tags. They keep their tags and get this import's own tag; the other new tags are added only while there is room. Eine mit CSV exportieren erstellte Datei lässt sich unverändert importieren: Der Apostroph vor einer Nummer wie '+447400123456 wird entfernt.
9. Klicken Sie auf n Kontakte importieren. n von N werden importiert… zeigt den Fortschritt. Sie können die Seite verlassen: Der Import läuft weiter, und Kontakte → Importieren → Letzte Importe öffnet ihn wieder (Öffnen). Eine hochgeladene Datei, die Sie vor dem Import verlassen haben (bei Spalten, Einwilligung oder nach Datei prüfen), steht unter Letzte Importe als Nicht abgeschlossen, mit Fortsetzen (zurück dorthin, wo Sie aufgehört haben) und Verwerfen. Verwerfen fragt „Die hochgeladene Datei „(Datei)“ verwerfen? Daraus wurde nichts importiert. Ihre Zeilen und die gespeicherte Datei werden gelöscht.“ und entfernt sie aus der Liste. Uploads, die 7 Tage lang nicht abgeschlossen werden, werden automatisch verworfen; in beiden Fällen ändert sich nichts an Ihren Kontakten.
10. Wenn Sie Import abgeschlossen. sehen, drücken Sie Importierte Kontakte ansehen , um die Liste zu sehen, oder errors.csv herunterladen (angezeigt mit der Die nicht importierten Zeilen mit dem Grund, in den Spalten der Datei selbst., nur wenn einige Zeilen nicht importiert wurden). Unter den Gesamtwerten steht Alle, die dieser Import erstellt oder aktualisiert hat, in der Liste "Import – customers.csv – 2026-09-24" (n Personen). Benennt die Liste, die der Import erstellt hat; Liste öffnen unter Contacts → Audiences (siehe nächsten Abschnitt).

Die Liste des Imports

Wenn ein Import abgeschlossen ist, kommen alle, die er erstellt oder aktualisiert hat, auf eine neue Liste (eine statische Zielgruppe) mit dem Namen Import – <file name> – <date>, zum Beispiel Import – customers.csv – 2026-09-24. Verwenden Sie sie wie jede Liste: Wählen Sie sie als Zielgruppe eines WhatsApp-Broadcasts, öffnen Sie sie unter Kontakte → Zielgruppen, fügen Sie Personen hinzu oder entfernen Sie sie (Zielgruppen).

• Übersprungene Personen (bereits in den Kontakten, mit Überspringen), Zeilen mit Problemen und Zeilen, die nicht gespeichert werden konnten, stehen nicht darauf.
• Das Datum ist der Tag, an dem der Import abgeschlossen wurde. Importieren Sie dieselbe Datei am selben Tag erneut, kommen ihre Personen auf dieselbe Liste; an einem anderen Tag erhalten Sie eine neue Liste.
• Ein abgebrochener Import erhält keine Liste. Die Personen, die er bereits importiert hatte, behalten das Tag des Imports, sodass Sie sie trotzdem finden.
• Ein Arbeitsbereich führt bis zu 500 Zielgruppen. Hat er bereits 500, wird der Import ohne Liste abgeschlossen und meldet Für diesen Import wurde keine Liste erstellt: Der Arbeitsbereich führt bereits 500 Zielgruppen. Archivieren Sie nicht mehr benötigte Listen unter Kontakte → Zielgruppen; das Tag kennzeichnet weiterhin alle aus der Datei.

Wie Personen abgeglichen werden (keine Duplikate)

• Eine Zeile ist dieselbe Person wie ein Kontakt, wenn ihre Telefonnummer (nachdem sie als +Ländervorwahl und Nummer geschrieben wurde) oder ihre E-Mail-Adresse in diesem Arbeitsbereich bereits vorhanden ist, auf einem beliebigen Kanal. Ein zusammengeführter Kontakt wird als eine Person aktualisiert.
• Zwei Zeilen mit derselben Nummer oder E-Mail-Adresse in einer Datei werden zu einem Kontakt: Die erste erstellt ihn, die späteren aktualisieren ihn (oder werden übersprungen, wenn Sie Überspringen gewählt haben).
• Ein neuer Kontakt mit Telefonnummer wird als WhatsApp-Kontakt dieser Person angelegt, sodass ihre Nachrichten auf derselben Karte ankommen, wenn sie Ihnen schreibt. Seine Quelle ist Importieren.
• Jeder importierte Kontakt erhält das eigene Tag des Imports, import: plus Datum und Dateiname (zum Beispiel import:2026-09-24-customers-3f9a), sodass Sie ihn neben der oben genannten Liste des Imports auch auf der Seite Kontakte wiederfinden (nach dem Tag filtern).

Einwilligung: was erfasst wird

• Mit Ja erhält jede Person pro aktiviertem Kanal einen Einwilligungseintrag, mit der Quelle Importieren und Ihrer Erklärung, dem Ort, dem Datum und dem Dateinamen als Nachweis sowie der Person, die den Import gestartet hat. Er erscheint beim Kontakt unter Einwilligungsverlauf (Einwilligung und Abmeldung).
• Nur Kanäle, für die die Zeile eine Adresse hat: WhatsApp und SMS benötigen eine Telefonnummer, E-Mail benötigt eine E-Mail-Adresse.
• Eine Spalte Marketing-Einwilligung (Ja / Nein) in der Datei: Nur Zeilen mit Ja (yes, y, 1, نعم, موافق) erhalten eine Einwilligung; Zeilen mit Nein oder leere Zeilen erhalten keine. Eine solche Spalte erfordert die Erklärung (Ja) oder muss auf Nicht importieren gesetzt werden.
• Personen, die widerrufen oder mit STOP geantwortet haben, behalten ihre Entscheidung (gezählt als Früheres Nein beibehalten). Ein Import überschreibt sie nie; das kann nur die Person selbst oder ein Teammitglied, das ihre neue Zustimmung mit Einwilligung erfassen erfasst.
• Mit Nein erhält niemand eine Marketing-Einwilligung. Die Personen können weiterhin Antworten im 24-Stunden-Fenster und Utility-Nachrichten erhalten.

Wenn etwas schiefgeht

• Dies ist eine alte Excel-Datei (.xls)... → speichern Sie sie als .xlsx oder CSV UTF-8 und laden Sie sie erneut hoch.
• Die erste Zeile muss die Spalten benennen → fügen Sie eine Kopfzeile hinzu. Die Datei hat Spaltennamen, aber keine Reihen von Personen. → die Datei hat eine Kopfzeile und nichts darunter (oder nur leere Zeilen); fügen Sie unter den Spaltennamen eine Zeile pro Person hinzu und laden Sie die Datei erneut hoch. Die Datei ist leer. bedeutet, dass in der Datei überhaupt nichts gefunden wurde.
• Die Datei hat mehr als 100.000 Zeilen oder Die Datei ist größer als 20 MB → teilen Sie sie auf. Die zweite Meldung erscheint auch bei einer kleinen Datei, die geöffnet Millionen gefüllter Zellen enthält.
• Die Datei hat mehr als 200 Spalten. → löschen Sie die Spalten, die Sie nicht brauchen. Ein Wert weit rechts zählt, auch in einer sonst leeren Spalte; leere Zellen zählen nicht.
• Ordnen Sie eine Telefon- oder E-Mail-Spalte zu. → setzen Sie eine Spalte auf Telefon (WhatsApp) oder E-Mail.
• Zwei Spalten sind auf "…" gesetzt → setzen Sie eine davon auf Nicht importieren.
• Zeilen in errors.csv, mit dem Grund: Keine gültige Telefonnummer (prüfen Sie die Ländervorwahl) (prüfen Sie Land für lokale Nummern), Keine Telefonnummer oder E-Mail, Keine gültige E-Mail-Adresse, Unbekanntes Land, Unbekannte Sprache, Unbekannte Zeitzone, Ein Wert passt nicht zum benutzerdefinierten Feld (das Feld wird im Detail genannt: Eine Auswahl muss eine seiner Optionen sein, ein Datum JJJJ-MM-TT oder Tag/Monat/Jahr, eine Zahl nur aus Ziffern), Die Einwilligungsspalte muss Ja oder Nein enthalten, Bereits ein Kontakt - übersprungen, Konnte nicht gespeichert werden (versuchen Sie, diese Zeile erneut zu importieren). errors.csv hat die eigenen Spalten der Datei, sodass Sie die Zeilen korrigieren und als neue Datei importieren können. Sie kommt in der Sprache, in der Sie die App verwenden: Die ersten vier Spalten (Zeile, Status, Grund, Detail), der Status jeder Zeile und der Grund sind in dieser Sprache.
• Import abbrechen stoppt vor den nächsten 1.000 Zeilen; bereits importierte Kontakte bleiben erhalten.
• Die Zeilen und die gespeicherte Kopie der Datei werden 30 Tage nach dem Hochladen gelöscht; danach ist errors.csv nicht mehr verfügbar (Die Zeilen dieser Datei wurden 30 Tage nach dem Hochladen gelöscht.). Die Summen des Imports und die Einwilligungserklärung bleiben erhalten.

Einen Kontakt hinzufügen

1. Klicken Sie unter Kontakte auf Kontakt hinzufügen.
2. Name (bis zu 120 Zeichen) und mindestens eines: Telefon (WhatsApp)) (mit Ländercode oder einer lokalen Nummer des gewählten Land), E-Mail oder Handle auf einer anderen Plattform mit deren Plattform. Land beginnt als das Land Ihres Unternehmens (Einstellungen → Unternehmen) und listet jedes Land auf, das in Ihrer Sprache benannt ist; ohne angegebene Zeichen lautet Wählen Sie ein Land. Ziffern, die auf einer arabischen Tastatur (٠٥٥...) eingegeben werden, werden in Telefon (WhatsApp) beim Tippen zu 0-9, sodass die Zahl in der üblichen Reihenfolge von links nach rechts gelesen wird.
3. Optional: Tags (durch Kommas getrennt), Notizen und unter Marketing-Einwilligung (optional) die Kanäle, denen die Person zugestimmt hat, sowie Wie wurde zugestimmt?
4. Klicken Sie auf Kontakt hinzufügen. Sie sehen [Name] wurde hinzugefügt., und der Kontakt öffnet sich.
5. Diese Person ist bereits in den Kontakten. → die Nummer oder E-Mail gehört schon zu jemandem; drücken Sie Kontakt öffnen. Wenn ein Feld das Problem ist, erscheint der Grund rot unter diesem Feld, das Feld wird rot und der Cursor springt hinein. Zum Beispiel Das ist keine gültige Telefonnummer für das gewählte Land. Geben Sie eine Ortsnummer dieses Landes ein oder die vollständige Nummer mit + und Ländervorwahl. unter Telefon (WhatsApp) (ohne gewähltes Land: Das ist keine gültige Telefonnummer. Prüfen Sie die Ziffern nach dem + und der Ländervorwahl, oder wählen Sie unten das Land und geben Sie eine Ortsnummer ein.), Wählen Sie die Plattform des Handles. unter Plattform (immer wenn ein Handle eingegeben wird, auch mit einem Telefon oder einer E-Mail), WhatsApp- oder SMS-Einwilligung benötigt eine Telefonnummer. Geben Sie die Nummer ein oder deaktivieren Sie WhatsApp und SMS. unter Telefon (WhatsApp), Für die E-Mail-Zustimmung ist eine E-Mail-Adresse erforderlich. Geben Sie die Adresse ein oder deaktivieren Sie E-Mail. oder Geben Sie eine E-Mail-Adresse wie name@example.com ein. unter E-Mail oder Geben Sie an, wie die Person zugestimmt hat (mindestens 3 Zeichen). unter Wie wurde zugestimmt? Jeder Grund ist in Ihrer Sprache. Beheben Sie es und drücken Sie erneut Kontakt hinzufügen. Eine Meldung zum Formular als Ganzes (Geben Sie eine Telefonnummer, eine E-Mail-Adresse oder ein Handle an.) erscheint unten.

Ein nur über ein Handle hinzugefügter Kontakt erhält eine eigene Karte; wenn die Person Ihnen über diese Plattform schreibt, führen Sie die beiden mit Zusammenführen mit… zusammen (Kontakte).

Entwickler (API)

'POST /workspaces/{workspaceId}/contacts' fügt einen Kontakt hinzu ('name', 'phone', 'email', 'handle' + 'platform', 'country', 'tags', 'notes', 'attributes', 'consent: {channels, evidence}'); 409 liefert das bestehende 'contactId'. Importe: 'POST .../contacts/imports' (mehrteiliges 'file'), 'GET .../contacts/imports/{id}', 'PATCH' '{mapping, options}', 'POST .../validate', 'POST .../run', 'POST .../cancel', 'GET .../errors.csv?lang=ar' ('lang': en, ar, fr, es, pt, de, tr, id, hi oder your). Das 'GET' eines fertigen Imports gibt 'audience' ('id', 'name', 'memberCount') zurück – die obige Liste.

Verwandt

• Kontakte
• Listen und Segmente (Zielgruppen)
• Einwilligung und Abmeldung
• Benutzerdefinierte Kontaktfelder
• WhatsApp-Broadcasts