Zum Inhalt springen

Kunden importieren

Für: Kontoinhaber, Customer-Success-Teams und Entwickler, die Kundendaten vorbereitenVoraussetzung: Die Rolle Admin (Vorlage herunterladen, Vorschau und Import erfordern sie)Screenshots zeigen Beispieldaten

Die Seite Kunden aus CSV importieren legt viele Kunden auf einmal aus einer CSV-Datei an oder aktualisiert sie: E-Mail, Unternehmen, Rolle darin, eine PIN oder ein Passwort und optional ihre Anmeldedaten für Ihre Toolkits. Jede Zeile wird geprüft, bevor etwas gespeichert wird, und der Import speichert alle Zeilen oder keine. Sie öffnen die Seite unter CRMKunden mit Aus CSV importieren oben rechts.

  • Mit einer Vorlage beginnen. Vorlage herunterladen liefert eine CSV-Datei mit allen unterstützten Spalten und drei Beispielzeilen. Die Datei vorbereiten.
  • Toolkit-Anmeldedaten mitliefern. Haken Sie Toolkits unter Server-Anmeldedaten vorausfüllen (optional) an, und die Vorlage erhält eine Spalte für die Anmeldedaten jedes Kunden. Toolkit-Anmeldedaten mitliefern.
  • Die Datei prüfen, ohne zu speichern. Vorschau führt alle Prüfungen aus und speichert nichts. Den Import in der Vorschau prüfen.
  • Alles auf einmal importieren. Import bestätigen speichert alle Zeilen zusammen; scheitert eine, wird keine gespeichert. Den Import abschließen.
  • Kunden ändern, die es schon gibt. Ist Bestehende Kunden aktualisieren angehakt, aktualisiert eine Zeile mit einer vorhandenen ID diesen Kunden, etwa um ihn in ein anderes Unternehmen zu verschieben oder eine vergessene PIN zu ersetzen; ist es nicht angehakt, werden bestehende Kunden übersprungen und nicht verändert. Bestehende Kunden aktualisieren · Kundenrollen und Zugriff.
  • Eine große Datei in Teilen importieren. Ein Upload umfasst bis zu 1.000 Kunden und 5 MB; eine größere Datei wird nach Ihrer Zustimmung in Teile aufgeteilt, die nacheinander geprüft und importiert werden. Den Import abschließen.
Die Seite „Kunden aus CSV importieren“, erreichbar über die Kundenliste. Die Einleitung nennt die CSV-Spalten CustomerId, CustomerEmail, CustomerCompanyId, CustomerCompanyName, Pin, Password und Role, erlaubt pro Zeile höchstens Pin oder Password und nennt Admin als Standardrolle. Das Feld „Server-Anmeldedaten vorausfüllen (optional)“ listet drei Toolkits mit Kontrollkästchen. Eine Zeile nennt bis zu 1000 Kunden und 5.0 MB pro Upload, und „Bestehende Kunden aktualisieren“ ist nicht angehakt. Darunter folgen die Dateiauswahl, die hervorgehobene Schaltfläche „Vorlage herunterladen“ und die noch deaktivierte Schaltfläche „Vorschau“.Die Seite „Kunden aus CSV importieren“, erreichbar über die Kundenliste. Die Einleitung nennt die CSV-Spalten CustomerId, CustomerEmail, CustomerCompanyId, CustomerCompanyName, Pin, Password und Role, erlaubt pro Zeile höchstens Pin oder Password und nennt Admin als Standardrolle. Das Feld „Server-Anmeldedaten vorausfüllen (optional)“ listet drei Toolkits mit Kontrollkästchen. Eine Zeile nennt bis zu 1000 Kunden und 5.0 MB pro Upload, und „Bestehende Kunden aktualisieren“ ist nicht angehakt. Darunter folgen die Dateiauswahl, die hervorgehobene Schaltfläche „Vorlage herunterladen“ und die noch deaktivierte Schaltfläche „Vorschau“.
Beginnen Sie mit der Vorlage; sie enthält alle unterstützten Spalten und drei Beispielzeilen.
Was dieser Screenshot zeigt
Ansicht
Kunden aus CSV importieren (/admin/customers-import)
Hervorgehoben
button “Vorlage herunterladen”, actions-right, enabled. downloads customers-import-template.csv
Außerdem sichtbar
Column list and Role default Admin; Pre-fill server credentials with Demo Billing API, Accounts API and Reporting API; Preview disabled until a file is chosen
Zweck
starting a customer import
BereichWas er zeigtWas Sie dort tun
KopfzeileZurück, den Titel Kunden aus CSV importieren und CSV-Spalten: CustomerId, CustomerEmail, CustomerCompanyId, CustomerCompanyName, Pin, Password, Role. Höchstens eines von Pin/Password pro Zeile. Role ist standardmäßig Admin.Zur Kundenliste zurückkehren
Vorausfüll-Box (optional)Server-Anmeldedaten vorausfüllen (optional) mit einem Kontrollkästchen pro ToolkitDer Vorlage Spalten für Anmeldedaten hinzufügen
DateizeileDie Dateiauswahl, Vorlage herunterladen und VorschauVorlage holen, Datei wählen, Vorschau starten
ErgebnisseVorschau-Ergebnisse oder Übermittlungsergebnisse: Zahlen, neue Unternehmen, eine Zeile pro DateizeileDie Prüfungen lesen, dann Import bestätigen
  1. Wählen Sie Vorlage herunterladen. Eine Datei namens customers-import-template.csv wird heruntergeladen.
  2. Ersetzen Sie die Beispielzeilen durch Ihre Kunden, einen pro Zeile, und behalten Sie die Kopfzeile.
  3. Speichern Sie sie als CSV mit Kommas zwischen den Werten, in UTF-8.
SpaltePflichtInhalt
CustomerIdJaDie Benutzer-ID, die Ihr Produkt für diese Person an das Widget übergibt, etwa cus_48712. Innerhalb der Datei eindeutig, ohne Rücksicht auf Groß- und Kleinschreibung.
CustomerEmailNeinIhre E-Mail-Adresse
CustomerCompanyIdNeinDie interne ID eines bestehenden Unternehmens: die lange Kennung in der Adresse der Unternehmensseite, nicht die beim Unternehmen angezeigte Unternehmens-ID. Hat Vorrang vor CustomerCompanyName.
CustomerCompanyNameNeinDer Name des Unternehmens. Ein bestehendes Unternehmen mit diesem Namen wird verwendet, ohne Rücksicht auf Schreibweise und zusätzliche Leerzeichen; sonst wird das Unternehmen beim Abschließen angelegt.
PinNein4–8 Ziffern
PasswordNeinMindestens 8 Zeichen. Nutzen Sie Pin oder Password, nicht beides.
RoleNeinAdmin oder Member, in beliebiger Schreibweise. Leer bedeutet Admin.
ServerAuthorizationsJsonNeinToolkit-Anmeldedaten, nur wenn Sie sie in der Vorlage vorausgefüllt haben

Die Spalten dürfen in beliebiger Reihenfolge stehen, ihre Namen ohne Rücksicht auf Groß- und Kleinschreibung. Werte werden an den Rändern bereinigt, leere Zeilen übersprungen, und ein Wert mit Komma muss in doppelten Anführungszeichen stehen. Ein Wert darf nicht über mehrere Zeilen gehen.

Ihre ZeileErgebnis
cus_48712, morgan.hayes@example.com, , Example Studios, 4821, , MemberNeues Member von Example Studios mit der PIN 4821
cus_48749, …, Example Studios, 482, , AdminFehler: “Pin must be 4-8 numeric digits.”
cus_48786, …, Fairbanks Joinery Ltd, , , OwnerFehler: “Unknown role ‘Owner’. Use Admin or Member.”
cus_48823, …, Fairbanks Joinery Ltd, , kestrel-ridge-42, Neuer Admin; Warnung, dass Fairbanks Joinery Ltd angelegt wird
Eine Zeile ohne PIN und ohne PasswortDer Kunde wird ohne Anmeldedaten angelegt; wie sich Kunden anmelden, erklärt Anmeldung für Endkunden
Das Feld „Server-Anmeldedaten vorausfüllen (optional)“ auf der Seite „Kunden aus CSV importieren“. Der Text erklärt, dass die heruntergeladene Vorlage dann eine Beispielzelle ServerAuthorizationsJson passend zu den Auth-Headern jedes gewählten Servers enthält. Das Kontrollkästchen für „Demo Billing API“ (CustomToken, Header X-Demo-Api-Key) ist angehakt und hervorgehoben; „Demo Accounts API“ (BasicAuth) und „Demo Reporting API“ (CustomToken, Header X-Api-Key und X-Account-Id) bleiben leer.Das Feld „Server-Anmeldedaten vorausfüllen (optional)“ auf der Seite „Kunden aus CSV importieren“. Der Text erklärt, dass die heruntergeladene Vorlage dann eine Beispielzelle ServerAuthorizationsJson passend zu den Auth-Headern jedes gewählten Servers enthält. Das Kontrollkästchen für „Demo Billing API“ (CustomToken, Header X-Demo-Api-Key) ist angehakt und hervorgehoben; „Demo Accounts API“ (BasicAuth) und „Demo Reporting API“ (CustomToken, Header X-Api-Key und X-Account-Id) bleiben leer.
Haken Sie ein Toolkit vor dem Herunterladen an, um auch die API-Anmeldedaten jedes Kunden dafür zu importieren.
Was dieser Screenshot zeigt
Ansicht
Server-Anmeldedaten vorausfüllen (optional) (/admin/customers-import)
Hervorgehoben
checkbox “”, prefill-box, checked. adds a ServerAuthorizationsJson column for this toolkit to the template
Außerdem sichtbar
Three toolkits with their auth type and header names
Zweck
importing per-customer toolkit credentials

Die Box Server-Anmeldedaten vorausfüllen (optional) listet Ihre Toolkits, die für ein Widget gewählt sind und Anmeldedaten brauchen, mit Autorisierungstyp und Header-Namen. Wählen Sie die Server aus, für die Sie Anmeldedaten mitliefern möchten. Die heruntergeladene Vorlage enthält eine Beispielzelle ServerAuthorizationsJson, die an die Auth-Header jedes ausgewählten Servers angepasst ist — ersetzen Sie die Platzhalter vor dem Import durch echte Werte.

Haken Sie jedes Toolkit an und wählen Sie dann Vorlage herunterladen. Ersetzen Sie in der Zelle ServerAuthorizationsJson jeder Zeile die Platzhalter, etwa Bearer <your-token>, durch die echten Werte dieses Kunden. Der Assistent verwendet sie dann, wenn er dieses Toolkit für den Kunden aufruft. Siehe Den Assistenten Ihre API im Namen des Nutzers aufrufen lassen.

StrikeUp speichert die importierten Anmeldedaten pro Kunde verschlüsselt, genauso wie Anmeldedaten, die Kunden im Chat eingeben. Entschlüsselt werden sie nur auf dem Server, wenn ein Tool-Aufruf sie braucht.

Meldung in einer ZeileBedeutung
“ServerId is required.”Die Zelle ist kein gültiges JSON, oder einem Eintrag fehlt die Toolkit-ID
“Duplicate ServerId within this row.”Dasselbe Toolkit steht zweimal in einer Zelle
“Server … does not belong to this company or is not mapped to any widget.”Die Toolkit-ID ist falsch, oder das Toolkit ist für kein Widget gewählt
“Server ’…’ has AuthorizationType=‘None’ — no credentials are accepted.”Dieses Toolkit braucht keine Anmeldedaten
“AuthData must contain at least one header.” / “AuthData keys must be non-empty and values non-null.”Die Header-Werte fehlen
Die Seite „Kunden aus CSV importieren“ nach der Dateiauswahl. Neben der Dateiauswahl erscheint der Name example-customers.csv, darunter wiederholt mit der Größe „(0 KB)“. Rechts liegt „Vorlage herunterladen“, die Schaltfläche „Vorschau“ ist jetzt aktiv und hervorgehoben. Die Vorschau prüft jede Zeile der Datei, ohne etwas zu speichern. Darüber bleibt das Feld zum Vorausfüllen mit den drei Toolkits, alle ohne Haken.Die Seite „Kunden aus CSV importieren“ nach der Dateiauswahl. Neben der Dateiauswahl erscheint der Name example-customers.csv, darunter wiederholt mit der Größe „(0 KB)“. Rechts liegt „Vorlage herunterladen“, die Schaltfläche „Vorschau“ ist jetzt aktiv und hervorgehoben. Die Vorschau prüft jede Zeile der Datei, ohne etwas zu speichern. Darüber bleibt das Feld zum Vorausfüllen mit den drei Toolkits, alle ohne Haken.
Die Vorschau ist ein Probelauf; gespeichert wird erst beim Bestätigen.
Was dieser Screenshot zeigt
Ansicht
Kunden aus CSV importieren (/admin/customers-import)
Hervorgehoben
button “Vorschau”, actions-right, enabled. uploads the file for a dry-run validation (POST /api/customer-import/preview)
Außerdem sichtbar
Chosen file example-customers.csv (0 KB)
Zweck
checking a CSV before importing
  1. Wählen Sie Ihre Datei. Vorschau wird verfügbar.
  2. Wählen Sie Vorschau. StrikeUp prüft jede Zeile und speichert nichts.
  3. Lesen Sie Vorschau-Ergebnisse.
Die Vorschau-Ergebnisse für example-customers.csv. Kacheln zeigen 5 Gesamtzeilen, 4 Neu, 0 Aktualisierungen, 1 Übersprungen und 2 Fehler in Rot; „Unternehmen, die erstellt werden:“ nennt Fairbanks Joinery Ltd. Die Zeilentabelle mit englischen Spaltenköpfen zeigt für Zeile 4 „Pin must be 4-8 numeric digits.“ und für Zeile 5 die hervorgehobene Meldung „Unknown role 'Owner'. Use Admin or Member.“, beide als Error markiert. Zeile 2 zeigt Create, Zeile 3 Skip (ein bestehender Kunde, weil „Bestehende Kunden aktualisieren“ aus ist) und Zeile 6 Create mit Hinweis. „Import bestätigen“ ist deaktiviert.Die Vorschau-Ergebnisse für example-customers.csv. Kacheln zeigen 5 Gesamtzeilen, 4 Neu, 0 Aktualisierungen, 1 Übersprungen und 2 Fehler in Rot; „Unternehmen, die erstellt werden:“ nennt Fairbanks Joinery Ltd. Die Zeilentabelle mit englischen Spaltenköpfen zeigt für Zeile 4 „Pin must be 4-8 numeric digits.“ und für Zeile 5 die hervorgehobene Meldung „Unknown role 'Owner'. Use Admin or Member.“, beide als Error markiert. Zeile 2 zeigt Create, Zeile 3 Skip (ein bestehender Kunde, weil „Bestehende Kunden aktualisieren“ aus ist) und Zeile 6 Create mit Hinweis. „Import bestätigen“ ist deaktiviert.
Jede fehlerhafte Zeile blockiert den gesamten Import; korrigieren Sie die Datei und prüfen Sie erneut, bis Fehler 0 ist.
Was dieser Screenshot zeigt
Ansicht
Vorschau-Ergebnisse (/admin/customers-import)
Hervorgehoben
cell “”, rows-table, error. none; fix the Role value in the file
Außerdem sichtbar
5 total, 4 new, 1 update, 2 errors; New company Fairbanks Joinery Ltd; Commit import disabled
Zweck
reading validation errors before importing
TeilWas er zeigt
Gesamtzeilen, Neu, Aktualisierungen, Übersprungen, FehlerWie viele Zeilen, wie viele einen Kunden anlegen, aktualisieren oder überspringen, wie viele Fehler haben (in Rot). Übersprungen erscheint nur, wenn eine Zeile übersprungen wird.
Unternehmen, die erstellt werden:Unternehmen, die der Import anlegt
Zeilentabelle„#“, „CustomerId“, „Action“, „CustomerCompany“ und „Messages“, auf Englisch. Die Zeilennummern zählen die Kopfzeile als Zeile 1.

In der Spalte „Action“ bedeutet „Error“, dass die Zeile nicht importiert werden kann. Sonst zeigt sie „Create“ für eine Zeile, die einen Kunden anlegt, „Update“ für eine, die einen bestehenden Kunden aktualisiert, und „Skip“ für einen bestehenden Kunden, der unverändert bleibt, weil Bestehende Kunden aktualisieren nicht angehakt ist. Orange markiert eine Zeile mit Warnung. Meldungen beginnen mit ❌ für einen Fehler und ⚠️ für eine Warnung.

Beheben Sie jeden Fehler in der Datei, wählen Sie sie erneut und starten Sie die Vorschau wieder, bis Fehler 0 ist. Eine andere Datei zu wählen, löscht die Ergebnisse.

Die Vorschau-Ergebnisse nach dem Korrigieren der Datei: 5 Gesamtzeilen, 4 Neu, 0 Aktualisierungen, 1 Übersprungen und 0 Fehler. Unter „Unternehmen, die erstellt werden:“ steht Fairbanks Joinery Ltd. In der Zeilentabelle ist keine Zeile als Error markiert; die Zeilen 5 und 6 tragen den Hinweis „CustomerCompany 'Fairbanks Joinery Ltd' will be created on commit.“ Unten rechts ist „Import bestätigen“ jetzt aktiv und hervorgehoben; damit werden alle Zeilen in einem Schritt gespeichert.Die Vorschau-Ergebnisse nach dem Korrigieren der Datei: 5 Gesamtzeilen, 4 Neu, 0 Aktualisierungen, 1 Übersprungen und 0 Fehler. Unter „Unternehmen, die erstellt werden:“ steht Fairbanks Joinery Ltd. In der Zeilentabelle ist keine Zeile als Error markiert; die Zeilen 5 und 6 tragen den Hinweis „CustomerCompany 'Fairbanks Joinery Ltd' will be created on commit.“ Unten rechts ist „Import bestätigen“ jetzt aktiv und hervorgehoben; damit werden alle Zeilen in einem Schritt gespeichert.
Ohne Fehler speichert „Import bestätigen“ alle Zeilen auf einmal; schlägt etwas fehl, wird nichts gespeichert.
Was dieser Screenshot zeigt
Ansicht
Vorschau-Ergebnisse (/admin/customers-import)
Hervorgehoben
button “Import bestätigen”, card-footer-right, enabled. imports all rows in one transaction (all or nothing)
Außerdem sichtbar
5 total, 4 new, 1 update, 0 errors; Warning: Fairbanks Joinery Ltd will be created on commit
Zweck
the import ready to commit

Import bestätigen ist nur verfügbar, wenn keine Zeile einen Fehler hat. Wählen Sie es: StrikeUp prüft die Datei erneut und speichert alle Zeilen in einem Zug. Sie sehen Übermittlungsergebnisse mit Erstellt, Aktualisiert, Übersprungen und Fehler sowie Import übermittelt..

Scheitert beim Abschließen irgendetwas, wird nichts gespeichert: Die Überschrift lautet Übermittlung zurückgesetzt – Fehler beheben und erneut versuchen, und Übermittlung wegen Fehlern zurückgesetzt. erscheint. Korrigieren Sie die Datei und versuchen Sie es erneut.

Eine Datei mit mehr als 1.000 Kunden oder über 5 MB wird in Teilen importiert. Wenn Sie sie wählen, nennt die Seite die Zahl der Kunden und bietet In {{parts}} Teilen hochladen an; stimmen Sie zu, laufen Vorschau und Abschluss Teil für Teil, und die Seite zeigt, welcher Teil gerade gesendet wird. Die Teile sind eigene Importe: Scheitert einer, bleiben die Teile davor importiert, die restlichen werden nicht hochgeladen, und das Ergebnis lautet Import unterwegs angehalten. Beheben Sie das Problem und importieren Sie dieselbe Datei erneut; ist Bestehende Kunden aktualisieren nicht angehakt, werden die bereits importierten Kunden übersprungen. Dieselbe CustomerId zweimal in einer Datei ist ein Fehler, auch wenn die beiden Zeilen in verschiedenen Teilen landen.

Haken Sie Bestehende Kunden aktualisieren über der Dateiauswahl an, bevor Sie die Vorschau starten. Dann aktualisiert eine Zeile, deren CustomerId zu einem bestehenden Kunden passt (ohne Rücksicht auf Groß- und Kleinschreibung), diesen Kunden:

Spalte in der ZeileWirkung auf den bestehenden Kunden
CustomerEmail gefülltE-Mail wird ersetzt
Eine Unternehmensspalte gefülltIn dieses Unternehmen verschoben
Role gefülltRolle wird geändert. Der letzte Admin eines Unternehmens ist dabei nicht geschützt.
Pin oder Password gefülltAnmeldedaten werden ersetzt und eine Sperre aufgehoben. Der Kunde wird bei seiner nächsten Anfrage abgemeldet.
Eine Spalte leer gelassenDieser Wert bleibt erhalten

Ist Bestehende Kunden aktualisieren nicht angehakt, die Voreinstellung, wird eine solche Zeile übersprungen: Die Vorschau zeigt „Skip“ in der Spalte „Action“, zählt sie unter Übersprungen, und der Kunde bleibt genau so, wie er ist.

Wo

Zurück oben links.

Was

Kehrt zur Kundenliste zurück. Von einem unfertigen Import wird nichts gespeichert.

Warum

Die Importseite hat keinen Eintrag in der Seitenleiste.

Wo

Die Box Server-Anmeldedaten vorausfüllen (optional), nur sichtbar, wenn mindestens ein für ein Widget gewähltes Toolkit Anmeldedaten braucht.

Was

Ein Kontrollkästchen pro Toolkit, mit Autorisierungstyp und Header. Angehakte Toolkits fügen der Vorlage eine Spalte ServerAuthorizationsJson hinzu.

Warum

Jedem importierten Kunden ab dem ersten Chat funktionierenden Zugang zu Ihrer API geben.

Wo

Vorlage herunterladen neben der Dateiauswahl.

Was

Lädt customers-import-template.csv mit allen Spalten und drei Beispielzeilen herunter: eine mit PIN und Admin, eine mit Passwort und Member, eine ohne Anmeldedaten.

Warum

Eine aus der Vorlage gebaute Datei hat die Spaltennamen, die StrikeUp erwartet.

Wo

Das Kontrollkästchen über der Dateiauswahl. Es gilt für die nächste Vorschau und den nächsten Abschluss.

Was

Standardmäßig aus: Zeilen für bereits vorhandene Kunden werden übersprungen und bleiben unverändert. An: E-Mail, Unternehmen und Rolle werden aus der Datei überschrieben, und eine PIN oder ein Passwort aus der Datei ersetzt das bisherige, hebt eine Anmeldesperre auf und meldet den Kunden ab.

Warum

Wer versehentlich einen Export erneut importiert, soll nicht die Daten aller überschreiben und alle abmelden; haken Sie es nur an, wenn die Datei bestehende Kunden ändern soll.

Wo

Die Dateiauswahl links in der Dateizeile.

Was

Nimmt .csv-Dateien an. Eine neue Datei zu wählen, löscht frühere Ergebnisse. Eine leere Datei wird mit “CSV file is required.” abgelehnt.

Warum

Die Datei wählen, die geprüft und importiert werden soll.

Wo

Vorschau, verfügbar, sobald eine Datei gewählt ist.

Was

Prüft jede Zeile und zeigt die Ergebnisse. Speichert nichts. Scheitert die Prüfung selbst, erscheint Vorschau fehlgeschlagen..

Warum

Jedes Problem der Datei sehen, bevor sich etwas ändert.

Wo

Import bestätigen unter den Ergebnissen, nur ohne Fehler verfügbar.

Was

Prüft die Datei erneut und speichert alle Zeilen zusammen oder keine. Zeigt währenddessen Wird übermittelt… und bei einem Serverfehler Übermittlung fehlgeschlagen..

Warum

Ein Alles-oder-nichts-Import hinterlässt nie einen halben Kundenstamm.

Teil der AnsichtWer ihn nutzen kann
Die SeiteJede angemeldete Person kann sie öffnen
Vorlage herunterladen, Vorschau und Import bestätigenPersonen mit der Rolle Admin. Bei allen anderen schlagen sie fehl
ThemaFakt
Alles oder nichtsEine fehlerhafte Zeile oder ein Fehler beim Abschließen speichert nichts.
StandardrolleAdmin, wenn Role leer ist. Setzen Sie Member für alle, die das Unternehmen nicht verwalten sollen.
PIN und PasswortPIN 4–8 Ziffern, Passwort mindestens 8 Zeichen, eines von beiden pro Zeile.
UnternehmensspaltenCustomerCompanyId braucht die interne ID des Unternehmens; CustomerCompanyName findet oder legt per Name an.
TrennzeichenNur Kommas.
UmfangBis zu 1.000 Kunden und 5 MB pro Upload; eine größere Datei wird in Teilen importiert. Werte über 255 Zeichen scheitern beim Abschließen mit Übermittlung fehlgeschlagen..
UnternehmenskennungDie eigene Unternehmens-ID eines Unternehmens lässt sich per Import nicht setzen.

CustomerId (Pflicht), CustomerEmail, CustomerCompanyId, CustomerCompanyName, Pin, Password, Role und, wenn Sie Toolkits vorausfüllen, ServerAuthorizationsJson. Nur die erste ist Pflicht; die anderen dürfen leer bleiben oder fehlen. Wählen Sie Vorlage herunterladen auf Kunden aus CSV importieren, um alle mit drei Beispielzeilen zu erhalten.

Eine PIN hat 4 bis 8 Ziffern und sonst nichts; ein Passwort braucht mindestens 8 Zeichen. Manche Admin-Ansichten beschriften die PIN-Option mit „4-6 Ziffern“, aber 7- und 8-stellige PINs werden angenommen. Eine falsche PIN zeigt in der Vorschau “Pin must be 4-8 numeric digits.”

Ist CustomerCompanyId die beim Unternehmen angezeigte Unternehmens-ID?

Abschnitt betitelt „Ist CustomerCompanyId die beim Unternehmen angezeigte Unternehmens-ID?“

Nein. CustomerCompanyId braucht die interne ID des Unternehmens, die lange Kennung in der Adresse seiner Seite unter CRMUnternehmen. Die beim Unternehmen angezeigte Unternehmens-ID ist ein anderer Wert; mit ihr erscheint “CustomerCompanyId must be a valid Guid.” Nutzen Sie notfalls CustomerCompanyName.

Die Kopfzeile fehlt oder ist falsch geschrieben, oder die Datei nutzt Semikolons statt Kommas, wie Excel es in manchen Sprachen tut. Öffnen Sie die Datei in einem Texteditor, prüfen Sie, ob die erste Zeile mit CustomerId beginnt und die Werte durch Kommas getrennt sind, und starten Sie die Vorschau erneut.

Die Rolle aus der Spalte Role, Admin oder Member. Ein leeres Role macht den Kunden zum Admin, der das Unternehmen im Kundenportal verwalten kann. Setzen Sie Member für alle, die nur den Assistenten nutzen sollen.

Import bestätigen bleibt nicht verfügbar, bis keine Zeile mehr einen Fehler hat, und scheitert beim Abschließen selbst etwas, wird keine Zeile gespeichert, und Übermittlung zurückgesetzt – Fehler beheben und erneut versuchen erscheint. Korrigieren Sie die Datei und starten Sie die Vorschau erneut, bis Fehler 0 zeigt.

Was bedeuten Create, Update und Skip in der Spalte Action?

Abschnitt betitelt „Was bedeuten Create, Update und Skip in der Spalte Action?“

In der Spalte „Action“ der Vorschau bedeutet „Create“, dass die Zeile einen neuen Kunden anlegt, „Update“, dass sie einen bestehenden aktualisiert, und „Skip“, dass sie einen bestehenden Kunden unverändert lässt, weil Bestehende Kunden aktualisieren nicht angehakt ist; „Error“ heißt, dass sie nicht importiert werden kann. Die Farbe zeigt den Rest: Grün für eine saubere Zeile, Orange für eine Zeile mit Warnung.

Ja, wenn Sie vor der Vorschau Bestehende Kunden aktualisieren anhaken. Dann aktualisiert eine Zeile, deren CustomerId zu einem bestehenden Kunden passt, ihn: Eine gefüllte E-Mail, ein Unternehmen, eine Rolle oder Anmeldedaten ersetzen die aktuellen, leere Spalten lassen die aktuellen Werte unberührt. Die Vorschau zählt diese Zeilen unter Aktualisierungen.

Kann ein erneuter Import eine vergessene PIN zurücksetzen?

Abschnitt betitelt „Kann ein erneuter Import eine vergessene PIN zurücksetzen?“

Ja. Importieren Sie den Kunden erneut mit einem neuen Wert in Pin oder Password. Die Anmeldedaten werden ersetzt, und eine Sperre nach Fehlversuchen wird aufgehoben. Der Kunde wird außerdem bei seiner nächsten Anfrage abgemeldet und meldet sich mit den neuen Anmeldedaten wieder an.

Kann ich Kunden einem Unternehmen zuordnen, das es noch nicht gibt?

Abschnitt betitelt „Kann ich Kunden einem Unternehmen zuordnen, das es noch nicht gibt?“

Ja. Tragen Sie den Namen des neuen Unternehmens in CustomerCompanyName ein. Die Vorschau listet es unter Unternehmen, die erstellt werden: und warnt, dass es „will be created on commit“; angelegt wird es, wenn Sie Import bestätigen wählen.

SymptomWas Sie prüfen
Bestehende Kunden wurden nicht geändert, und die Vorschau zählt sie unter ÜbersprungenBestehende Kunden aktualisieren war nicht angehakt. Haken Sie es an, starten Sie Vorschau und Abschluss erneut.
Die Seite meldet, die Datei enthalte mehr Kunden, als ein Upload umfasstNehmen Sie In {{parts}} Teilen hochladen an, oder teilen Sie die Datei selbst in Dateien mit bis zu 1.000 Kunden und 5 MB.
Import unterwegs angehalten nach einem Import in TeilenLesen Sie, welcher Teil warum gescheitert ist. Korrigieren Sie die Datei und importieren Sie sie erneut; Kunden aus den gelungenen Teilen werden übersprungen, sofern Bestehende Kunden aktualisieren nicht angehakt ist.
Jede Zeile: “CustomerId is required.”Die Kopfzeile fehlt, oder die Datei nutzt Semikolons; speichern Sie sie kommagetrennt.
“Pin must be 4-8 numeric digits.”Nur 4–8 Ziffern; formatieren Sie die Spalte in Excel als Text, damit führende Nullen bleiben.
“Specify at most one of Pin / Password per row.”Lassen Sie eines der beiden leer.
“CustomerCompanyId must be a valid Guid.” oder “CustomerCompanyId … does not exist.”Nutzen Sie die interne ID aus der Adresse der Unternehmensseite, oder entfernen Sie sie und nutzen Sie CustomerCompanyName.
“Unknown role ’…’. Use Admin or Member.”Korrigieren Sie den Wert in Role.
“Duplicate CustomerId within this file.”Jede ID darf nur einmal vorkommen, ohne Rücksicht auf Groß- und Kleinschreibung.
“CustomerEmail is not a valid email address.”Der Wert braucht ein @.
Import bestätigen bleibt nicht verfügbarMindestens eine Zeile hat einen Fehler; beheben Sie ihn und starten Sie die Vorschau erneut.
Übermittlung fehlgeschlagen.Ein Wert ist vielleicht zu lang (über 255 Zeichen); kürzen Sie ihn und versuchen Sie es erneut.
Eine Änderung schlägt mit Anfrage fehlgeschlagen und “This action requires the Admin role.” fehlVorlage herunterladen, Vorschau und Import bestätigen erfordern die Rolle Admin. Bitten Sie eine Person mit der Rolle Admin, die Änderung vorzunehmen oder Ihnen die Rolle unter Einstellungen › Benutzer zu geben.