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.
- To successfully merge the existing contacts with the new records, when you perform the .csv bulk import, it is important that all phone numbers in the .csv file follow the E.164 format when matching by phone.
- 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
The External Organization External ID is the key field, which the import process uses to determine unique organizations. For each unique External Organization External ID, the import process creates one Genesys Cloud external organization record. The import process imports all the account fields in the row to the corresponding Genesys Cloud external organization record.
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.
- If multiple rows share an External Organization External ID, all organization-specific fields must be identical (for example, Account Name) and Genesys Cloud creates one External Organization for all related contacts. Genesys Cloud imports only one row per External ID, creates one External Organization for all related contacts and does not guarantee which row is used. If differences exist across rows, each row is sent separately for updates to the External Org.
- 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 ist die Reihenfolge der gesuchten Bezeichner:
- 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 | Kein Konflikt | ||
| 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 keine weiteren Felder verfügbar sind, werden die Daten gelöscht. |
|
| 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 | Die geschäftliche Telefonnummer aus der CSV-Datei wird mit der Mobiltelefonnummer von Kontakt C abgeglichen. Dieses Feld wird nach dem Import mit der Handynummer der CSV-Daten (die in diesem Fall leer ist) aktualisiert. | |||
| work Telefon | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | As the Import Field checkbox was cleared, Contact C’s WorkPhone remains unchanged after the import. | |
| 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, Telefonnummer und E-Mail-Adresse
- Ü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
The Work email from .csv is matched with Contact C’s Work Email and the work phone was matched to Contact B’s cell phone. As the Merge and update all matched contacts option is not selected, only Contact C will be updated after the import and the Contact B remains unchanged, even though both contacts partially match the CSV data.
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.
- The Contact C column is a curated contact in Genesys Cloud
- The Updated Contact C column is the merged contact after completion of the import.
- 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 | Aktualisieren Sie Kontakt C mit Daten aus der CSV-Datei. | |||
| 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 this example, some contacts are identified, and some contacts are curated.
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.
Ephemeral and identified contacts are system-generated and do not appear in search APIs, reverse-whitepages lookups, or 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 ist die Reihenfolge der durchsuchten Bezeichner:
- ExternalID:123AABC
- email: johnny@gmail.com
- Telefon: null
Das Feld „Persönliche E-Mail“ aus der CSV-Datei wird mit dem anderen E-Mail-Feld von Kontakt C abgeglichen und die geschäftliche Telefonnummer aus der CSV-Datei wird mit der Mobiltelefonnummer von Kontakt B abgeglichen.
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 | Da ein Konflikt vorliegt, wird der Wert des identifizierten Kontakts 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 | Da ein Konflikt vorliegt, wird der Wert des identifizierten Kontakts verwendet. |
| Titel | Johnny Boy | Nullwerte werden aus den CSV-Importen nicht verwendet. Der Wert von Kontakt C wird verwendet. | |||
| salutation | 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 | Emails are handled carefully during merges to avoid data loss. Therefore although the .csv data’s work email is null, Genesys Cloud preserves the work Email from Contact B after the merge and place it in Work Email for the merged Contact D. | ||
| 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 | johnny@gmail.com | Emails are handled carefully during merges to avoid data loss. Therefore although the .csv data’s work email is null, Genesys Cloud preserves the other Email from Contact C after the merge and place it in other Email for the merged Contact D. | ||
| Handy | Keine Updates, kein Wert in irgendeinem Kontakt. | ||||
| work Telefon | Keine Updates, kein Wert in irgendeinem Kontakt | ||||
| Telefon | Keine Updates, kein Wert in irgendeinem Kontakt. | ||||
| Anderes Telefon | Keine Updates, kein Wert in irgendeinem Kontakt |
