Arbeiten mit Daten in der .csv-Quelldatei
Externe ID ist das erforderliche Schlüsselfeld, das Genesys Cloud Importvorgang verwendet, um eindeutige Kontakte zu ermitteln. Dieses Feld hilft beim Identifizieren von Kontakten, sodass Sie vorhandene Kontakte problemlos über dieselbe Tabelle aktualisieren können. Für jede eindeutige externe ID erstellt der Importvorgang einen externen Genesys Cloud-Kontaktdatensatz. Der Importvorgang importiert alle Kontaktfelder in der Zeile in den entsprechenden externen Kontaktdatensatz von Genesys Cloud.
Wenn Sie eine externe ID erstellen, können Sie jede beliebige Kombination aus Buchstaben und Zahlen verwenden. Sie können beispielsweise eine eindeutige Kennung aus Ihrem CRM- oder ERP-System verwenden oder einen für Sie aussagekräftigen zusammengesetzten Schlüssel erstellen. Sie können zur Identifizierung des Datensatzes jede beliebige externe ID verwenden, solange die Beschränkung auf 255 Zeichen eingehalten wird. Wenn Ihre CSV-Datei aus einem CRM extrahiert wird, empfehlen wir die Verwendung eindeutiger Kennungen (UUIDs) aus Ihrem CRM. UUIDs ermöglichen die Synchronisierung von Kontakten aus Ihrem CRM in kommenden Funktionsupdates.
Wenn Sie den Datensatz nur einmal importieren wollen, können Sie jede beliebige externe ID verwenden. Das System erzeugt interne IDs, die mit diesen externen IDs übereinstimmen.
- Wenn Sie Ihre Kontakte zuvor mit dem alt Beim Massenimportvorgang verwendet das System nur die Kennungen für die Telefonnummer oder E-Mail-Adresse, um Ihren Kontakt mit der neuen externen ID abzugleichen und zu aktualisieren.
- Um die bestehenden Kontakte erfolgreich mit den neuen Datensätzen zusammenzuführen, ist es beim CSV-Massenimport wichtig, dass alle Telefonnummern in der CSV-Datei den E.164-Format beim Matching per Telefon.
- Wenn die Telefonnummern in Ihrer CSV-Datei nicht dem E.164-Format entsprechen, wird der Datenvalidierungsschritt des Importvorgang löst Warnungen aus. Während der Importvorgang mit dem Importieren der Kontakte fortfährt, gibt es keine Garantie dafür, dass der Algorithmus zur Identitätsauflösung die Kontakte anhand der Telefonnummern genau abgleicht und zusammenführt.
- Wenn Ihre alten Kontakte keine E-Mail-Adresse oder Telefonnummer haben, die mit der E-Mail-Adresse oder Telefonnummer in Ihrer neuen CSV-Datei übereinstimmt, erstellt das System einen Datensatz mit Ihrer angegebenen externen ID in der CSV-Datei.
- Wenn die Informationen eines Kontakts mehrmals in derselben Datei wiederholt werden, wird der Kontakt mehrmals aktualisiert und der Zähler für importierte Zeilen spiegelt die Wiederholung wider. Die Reihenfolge, in der die Aktualisierungen erfolgen, kann jedoch nicht garantiert werden.
Achten Sie beim Aktualisieren zuvor importierter Kontakte darauf, dass Sie dieselben externen IDs verwenden, um die Erstellung doppelter Datensätze zu vermeiden.
Wenn Sie beispielsweise eine Tabelle mit einem Datensatz importieren und dabei „A“ als externe ID verwenden und später dieselbe Tabelle mit „B“ als externe ID für diesen Datensatz erneut importieren, erstellt Genesys Cloud einen Datensatz, anstatt den vorhandenen zu aktualisieren. Verwenden Sie zum Aktualisieren eines vorhandenen Datensatzes immer dieselbe externe ID.
Externe Organisationen
T Die externe ID der externen Organisation ist die Schlüsselfeld, das der Importprozess verwendet, um eindeutige Organisationen zu bestimmen . Für jede eindeutige externe Organisations-ID erstellt der Importvorgang einen externen Genesys Cloud-Organisationsdatensatz. Der Importvorgang importiert alle Kontofelder in der Zeile in den entsprechenden externen Organisationsdatensatz von Genesys Cloud.
Wenn Sie eine externe ID für eine externe Organisation erstellen, können Sie jede beliebige Kombination aus Buchstaben und Zahlen verwenden. Sie können einen für Sie aussagekräftigen zusammengesetzten Schlüssel erstellen, solange Sie die Beschränkung auf 255 Zeichen einhalten. Wenn Ihre CSV-Datei aus einem CRM extrahiert wird, empfehlen wir die Verwendung eindeutiger Kennungen (UUIDs) aus Ihrem CRM. UUIDs ermöglichen die Synchronisierung von Kontakten aus Ihrem CRM in kommenden Funktionsupdates.
Verknüpfen Sie einen externen Kontakt mit einer externen Organisation
Um einen externen Kontakt einer externen Organisation zuzuordnen, geben Sie ihn in derselben Zeile der CSV-Quelldatei ein.
In diesem Beispiel ist Angus Reid ein Problemlöser für Phoenix Foundation II. Der Importvorgang erstellt den externen Organisationsdatensatz für Phoenix Foundation II und einen externen Kontaktdatensatz für Angus Reid. Unter „Externe Kontakte“ erscheint Angus Reid als externer Kontakt für die Organisation Phoenix Foundation II.
Verknüpfen Sie mehrere externe Kontakte mit einer externen Organisation
So verknüpfen Sie mehrere externe Kontakte mit einem extern Organisation, weisen Sie allen dieselbe externe Organisations-ID zu.
In diesem Beispiel sind Kathryn, Josh und Rebecca alle Ansprechpartner für die Organisation Office Mart.
- Wenn mehrere Zeilen eine externe ID einer externen Organisation gemeinsam nutzen, müssen alle organisationsspezifischen Felder identisch sein (z. B. Kontoname) und Genesys Cloud erstellt eine externe Organisation für alle zugehörigen Kontakte. Genesys Cloud importiert nur eine Zeile pro externer ID, erstellt eine externe Organisation für alle zugehörigen Kontakte und garantiert nicht, welche Zeile verwendet wird. Wenn zwischen den Zeilen Unterschiede bestehen, wird jede Zeile separat zur Aktualisierung an die externe Organisation gesendet.
- Sie können keine .csv-Datei verwenden, um Mitglieder in eine Organisation zu importieren, die Sie manuell erstellt haben.
So verwaltet der Massenimportprozess die Zusammenführungsaktionen
Importieren Sie in diesem Beispiel nur Kontakte und gehen Sie davon aus, dass alle externen Kontaktorganisationsfelder in der CSV-Datei leer sind.
Während des Massenimportvorgangs wurden im Bildschirm „Importprofil“ die folgenden Optionen ausgewählt:
- Kontakte abgleichen nach : Externe ID, Telefonnummer und E-Mail-Adresse
- Übereinstimmende Kontakte zusammenführen : Alle übereinstimmenden Kontakte zusammenführen und aktualisieren
In diesem Beispiel werden die folgenden Kennungen gesucht:
- ExternalID: 123AABC
- Telefon: +1 919 432 5523
- E-Mail: tom.sellenta@sag.aftra.com
Die geschäftliche Telefonnummer aus der CSV-Datei wird mit der Mobiltelefonnummer von Kontakt C abgeglichen. Ein neuer zusammengeführter ContactD wird erstellt.
In der folgenden Tabelle
- Die Spalte „Feldname“ gibt den Feldnamen in der CSV-Datei an.
- Die Spalte „CSV-Daten (Anforderung anreichern)“ zeigt die Daten aus der CSV-Datei an.
- Die Spalte „Kontakt B“ ist ein kuratierter Kontakt in der Genesys Cloud.
- Die Spalte „Kontakt C“ ist ein kuratierter Kontakt in der Genesys Cloud.
- Die Spalte „Kontakt D“ ist der zusammengeführte Kontakt nach Abschluss des Imports.
- In der Spalte „Erklärung“ wird beschrieben, wie die Daten in der Spalte „Kontakt D“ importiert wurden.
| Feldname | CSV-Daten (Anforderung anreichern) | Kontakt B | Kontakt C | Kontakt D (zusammengeführter Kontakt) | Erläuterung |
|---|---|---|---|---|---|
| Externe SIP | 123AABC | 123AABC | Die externe ID aus dem CSV-Datensatz bereichert den zusammengeführten Datensatz als primäre Kennung. Die vom alten CSV-Import verwendete Kontakt-ID wird in den Kontaktdatensätzen nicht mehr verwendet oder angezeigt. | ||
| Vorname | Tom | Tommy | Tom | Tom | Datenkonflikt, der zusammengeführte Kontakt behält die aktuellsten Daten aus der CSV-Datei. |
| middleName | D | D | Nullwerte werden aus den CSV-Importen nicht verwendet. Der Wert von Kontakt C wird verwendet. | ||
| Nachname | Selleck | Selk | Selleck | Datenkonflikt, der zusammengeführte Kontakt behält die aktuellsten Daten aus der CSV-Datei. | |
| Titel | Problemlöser | Problemlöser | Es wird der Wert von Kontakt C verwendet. | ||
| salutation | Mister | Herr. | Mister | Datenkonflikt, der zusammengeführte Kontakt behält die aktuellsten Daten aus der CSV-Datei. | |
| geschäftliche E-Mail | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com | Datenkonflikt, der zusammengeführte Kontakt behält die aktuellsten Daten aus der CSV-Datei. |
| persönliche E-Mail | tom@hotmail.com | tommy@yahoo.com | tom@gmail.com | E-Mails und Telefonnummern werden beim Zusammenführen sorgfältig behandelt, um Datenverlust zu vermeiden. Wenn zwei Kontakte dasselbe Feld verwenden (z. B. „workEmail“), werden die Daten in ein anderes verfügbares Feld verschoben (z. B. „personalEmail“ oder „otherEmail“). In diesem Beispiel wird „tom@gmail.com“ von „workEmail“ nach „personalEmail“ verschoben, anstatt es zu löschen. Dieser Vorgang wird iterativ fortgesetzt, bis alle möglichen Felder verwendet sind. Wenn der Speicherplatz begrenzt ist, werden ältere E-Mails gelöscht, um Platz für die Anforderungswerte zu schaffen. |
|
| andere E-Mail | tommy@hotmail.com | Die spezifischen Feldnamen sind nicht wichtig und Daten aus zusammengeführten Kontakten bleiben soweit möglich erhalten. Wenn keine verfügbaren Felder zum Verschieben übrig bleiben, werden die Daten gelöscht. | |||
| Handy | +1 919 432-5523 | Das Arbeitstelefon aus der CSV-Datei wird mit dem Mobiltelefon von Kontakt C abgeglichen. | |||
| work Telefon | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | Da das Kontrollkästchen „Importfeld“ deaktiviert wurde, bleibt das Arbeitstelefon von Kontakt C nach dem Import unverändert. | |
| Telefon | Keine Updates, kein Wert in irgendeinem Kontakt. | ||||
| Anderes Telefon | Keine Updates, kein Wert in irgendeinem Kontakt |
Dieses Beispiel importiert nur Kontakte. Es wird davon ausgegangen, dass die Felder „Externe Organisation“ in der CSV-Datei leer sind.
Während des Massenimportvorgangs wurden im Bildschirm „Importprofil“ die folgenden Optionen ausgewählt:
- Kontakte abgleichen nach: Externe ID, E-Mail-Adresse, Telefon
- Übereinstimmende Kontakte zusammenführen : Nur den ersten übereinstimmenden Kontakt aktualisieren
In diesem Beispiel ist die Reihenfolge der gesuchten Bezeichner: (Die E-Mail-ID steht vor der ExternalID)
- ExternalID: 123AABC
- E-Mail: tom.selleck@sag.aftra.com
- Telefon: +1 919 432-5523
Die geschäftliche E-Mail-Adresse aus der CSV-Datei wird mit der geschäftlichen E-Mail-Adresse von Kontakt C abgeglichen und die geschäftliche Telefonnummer wurde mit der Handynummer von Kontakt B abgeglichen. Da die Option „Alle übereinstimmenden Kontakte zusammenführen und aktualisieren“ nicht ausgewählt ist, wird nach dem Import nur Kontakt C aktualisiert und Kontakt B bleibt unverändert, obwohl beide Kontakte teilweise mit den CSV-Daten übereinstimmen.
In der folgenden Tabelle
- Die Spalte „Feldname“ gibt den Feldnamen in der CSV-Datei an.
- Die Spalte „CSV-Daten (Anforderung anreichern)“ zeigt die Daten aus der CSV-Datei an.
- Die Spalte „Kontakt B“ ist ein kuratierter Kontakt in der Genesys Cloud.
- Die Spalte „Kontakt C“ ist ein kuratierter Kontakt in der Genesys Cloud
- Die Spalte „Aktualisierter Kontakt C“ enthält die Daten nach Abschluss des Imports.
- In der Spalte „Erklärung“ wird beschrieben, wie die Daten in der Spalte „Kontakt D“ importiert wurden.
| Feldname | CSV-Daten (Anforderung anreichern) | Kontakt B | Kontakt C | Aktualisierter Kontakt C | Erläuterung |
|---|---|---|---|---|---|
| Externe SIP | 123AABC | 123AABC |
Die externe ID aus dem CSV-Datensatz bereichert den Kontakt-C-Datensatz als primäre Kennung. Die vom alten CSV-Import verwendete Konto-ID wird in den Kontaktdatensätzen nicht mehr verwendet oder angezeigt. |
||
| Vorname | Tom | Tommy | Tom | Tom | Kein Konflikt, keine Veränderung. |
| middleName | D | D |
.csv hat keinen Wert für „middleName“, aber Kontakt C hat einen. Daher ändert sich der middleName-Wert von Kontakt C nicht. |
||
| Nachname | Selleck | Selk | Selleck | Konflikt. Aktualisieren Sie Kontakt C mit Daten aus der CSV-Datei. | |
| Titel | Problemlöser | Problemlöser | Keine Aktualisierungen, da das Feld „Importieren“ deaktiviert ist. | ||
| salutation | Mister | Herr. | Mister | Konflikt. Aktualisieren Sie Kontakt C mit Daten aus der CSV-Datei. | |
| geschäftliche E-Mail | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com |
Die geschäftliche E-Mail aus der CSV-Datei wird mit der geschäftlichen E-Mail von Kontakt C abgeglichen. Dieser Kontakt wird nach dem Import aktualisiert und Kontakt B bleibt unverändert, da er nicht der erste zugeordnete Kontakt war und Kontakt C der erste zugeordnete Kontakt war. |
| persönliche E-Mail | tommy@yahoo.com | tom@yahoo.com | Keine Aktualisierungen, da das Feld „Importieren“ nicht ausgewählt ist. | ||
| andere E-Mail | Keine Updates, kein Wert in irgendeinem Kontakt. | ||||
| Handy | +1 317 845-1232 | +1 317 845-1232 | Keine Aktualisierungen, da das Importfeld nicht ausgewählt ist. | ||
| work Telefon | +1 919 432-5523 | +1 317 845-1232 | +1 919 432-5523 | Da ein Konflikt vorliegt, wird Kontakt C mit Daten aus .csv aktualisiert. | |
| Telefon | Keine Updates, kein Wert in irgendeinem Kontakt. | ||||
| Anderes Telefon | Keine Updates, kein Wert in irgendeinem Kontakt. |
In diesem Beispiel werden einige Kontakte identifiziert und einige Kontakte kuratiert.
Es gibt drei Kontakttypen:
- Ephemeral: Ein automatisch generierter Kontakt, der mit einer clientseitigen Webkennung oder einem Cookie verknüpft ist, aber keine weiteren Informationen enthält. Mit anderen Worten handelt es sich um einen leeren Kontakt, auf den ein Web-Cookie/eine clientseitige Kennung verweist. Sie haben eine Gültigkeitsdauer (TTL) von 60 Tagen.
- Identifiziert : Ein automatisch generierter Kontakt mit PII ohne Cookies und einem TTL-Limit von 60 Tagen.
- Kuratiert : Kontakte, die von Agenten oder API-Aufrufen erstellt oder _befördert_ wurden. Sie haben kein TTL-Limit.
Flüchtige und identifizierte Kontakte werden vom System generiert und erscheinen nicht in Such-APIs, umgekehrten Whitepage-Suchen oder Scans.
Die folgenden zwei Kontakte werden im System abgeglichen:
- Kontakt B (kuratiert)
- Kontakt C (Identifiziert)
Während des Massenimportvorgangs wurden im Bildschirm „Importprofil“ die folgenden Optionen ausgewählt:
- Kontakte abgleichen nach : Externe ID, E-Mail-Adresse und Telefonnummer.
- Übereinstimmende Kontakte zusammenführen : Alle übereinstimmenden Kontakte zusammenführen und aktualisieren.
In diesem Beispiel werden die folgenden Kennungen gesucht:
- ExternalID:123AABC
- email: johnny@gmail.com
- Telefon: +1 919 432-5523
Das Feld „Persönliche E-Mail“ aus der CSV-Datei wird mit dem anderen E-Mail-Feld von Kontakt C abgeglichen, d. h. johnny@gmail.com .
Die geschäftliche Telefonnummer aus der CSV-Datei wird mit der Mobiltelefonnummer von Kontakt B abgeglichen, also +1 919 432-5523.
In der folgenden Tabelle
- Die Spalte „Feldname“ gibt den Feldnamen in der CSV-Datei an.
- Die Spalte „CSV-Daten (Anforderung anreichern)“ zeigt die Daten aus der CSV-Datei an.
- Die Spalte „Kontakt B“ ist ein kuratierter Kontakt in der Genesys Cloud.
- Die Spalte „Kontakt C“ ist ein identifizierter Kontakt in der Genesys Cloud.
- Die Spalte „Kontakt D“ ist der zusammengeführte Kontakt nach Abschluss des Imports.
- In der Spalte „Erklärung“ wird beschrieben, wie die Daten in der Spalte „Kontakt D“ importiert wurden.
| Feldname | CSV-Daten (Anforderung anreichern) | Kontakt B | Kontakt C | Kontaktdaten von D | Erläuterung |
| Externe SIP | 123AABC | 123AABC | Die externe ID aus dem CSV-Datensatz bereichert den zusammengeführten Kontakt-D-Datensatz als primäre Kennung. | ||
| Vorname | Johnny | Johnny | Nullwerte werden aus den CSV-Importen nicht verwendet. Der Wert von Kontakt C wird verwendet. | ||
| middleName | Matthäus | M | Matthäus | Da ein Konflikt vorliegt, wird der Wert aus dem neuster kuratierter Kontakt verwendet wird. | |
| Nachname | Banks IV | Banks | Banks IV | Banks IV | Der Wert aus der CSV-Datei hat hier Vorrang. |
| Titel | Johnny Boy | Johnny Boy | Nullwerte werden aus den CSV-Importen nicht verwendet. Der Wert von Kontakt C wird verwendet. | ||
| salutation | Mr | Mr | Nullwerte werden aus den CSV-Importen nicht verwendet. Der Wert von Kontakt B wird verwendet. | ||
| geschäftliche E-Mail | Banks@gmail.com | Banks@gmail.com | Nullwerte werden aus den CSV-Importen nicht verwendet. Der Wert von Kontakt B wird verwendet. | ||
| persönliche E-Mail | johnny@gmail.com | johnny@gmail.com | Die persönliche E-Mail aus der CSV-Datei wird mit der anderen E-Mail von Kontakt C abgeglichen. Der Wert aus der CSV-Datei wird für die persönliche E-Mail des zusammengeführten Kontakts D verwendet. |
||
| andere E-Mail | johnny@gmail.com |
Die persönliche E-Mail-Adresse aus der CSV-Datei wird mit der anderen E-Mail-Adresse von Kontakt C abgeglichen. Die andere E-Mail-Adresse des zusammengeführten Kontakts bleibt in diesem Szenario leer da die persönliche E-Mail-Adresse diese E-Mail-Adresse bereits verwendet hat und doppelte Telefon- oder E-Mail-Werte nicht gespeichert werden. |
|||
| Handy | +1 919 432-5523 |
Die geschäftliche Telefonnummer aus der CSV-Datei wird mit der Mobiltelefonnummer von Kontakt B abgeglichen. Die Mobiltelefonnummer des zusammengeführten Kontakts bleibt in diesem Szenario leer, da das geschäftliche Telefon diesen Telefonnummernwert bereits verwendet hat und doppelte Telefon- oder E-Mail-Werte nicht gespeichert werden. |
|||
| work Telefon | +1 919 432-5523 | +1 919 432-5523 | Die geschäftliche Telefonnummer aus der CSV-Datei wird mit der Mobiltelefonnummer von Kontakt B abgeglichen. | ||
| Telefon | Keine Updates, kein Wert in irgendeinem Kontakt. | ||||
| Anderes Telefon | Keine Updates, kein Wert in irgendeinem Kontakt |
