Trabajar con datos en el archivo .csv de origen
Contactos externos
El ID externo es el campo clave obligatorio que el proceso de importación de Genesys Cloud utiliza para determinar contactos únicos. Este campo ayuda a identificar los contactos para que pueda actualizar fácilmente los contactos existentes a través de la misma hoja de cálculo. Para cada ID externo único, el proceso de importación crea un registro de contacto externo de Genesys Cloud. El proceso de importación importa todos los campos de contacto de la fila al registro de contacto externo de Genesys Cloud correspondiente.
Al crear un ID externo, puede utilizar cualquier combinación de letras y números. Por ejemplo, puede utilizar un identificador único de su sistema CRM o ERP, o puede crear una clave compuesta que sea significativa para usted. Puede ser cualquier ID externo que desee utilizar para identificar el registro, siempre que cumpla la limitación de 255 caracteres. Si su .csv se extrae de un CRM, le recomendamos que utilice identificadores únicos (UUID) de su CRM. Los UUID permiten sincronizar los contactos de su CRM en las próximas actualizaciones de funciones.
Si solo planea importar el registro una vez, puede usar cualquier ID externo que desee. El sistema genera identificaciones internas para corresponder con esas identificaciones externas.
- Si ha importado previamente sus contactos mediante el proceso de importación masiva de old, el sistema sólo utiliza los identificadores Teléfono o Dirección de correo electrónico para hacer coincidir y actualizar su contacto con el nuevo ID externo. Si tus contactos antiguos no tienen un correo electrónico o un número de teléfono que coincida con el correo electrónico o el teléfono de tu nuevo archivo .csv, el sistema crea un registro con tu ID externo especificado en el .csv.
- Si la información de un contacto se repite varias veces en el mismo archivo, el contacto se actualiza varias veces y el contador de filas importadas refleja la repetición. Sin embargo, no se garantiza el orden en que se producen las actualizaciones.
Al actualizar contactos previamente importados mediante el nuevo proceso de Importación masiva, asegúrese de utilizar los mismos ID externos para evitar crear registros duplicados.
Si la información de un contacto se repite varias veces en un archivo, el contacto se actualiza varias veces y el recuento de importación refleja la repetición. Sin embargo, no se garantiza el orden en que se producen las actualizaciones.
Por ejemplo, si importa una hoja de cálculo con un registro utilizando "A" como ID externo y más tarde vuelve a importar la misma hoja de cálculo con "B" como ID externo para ese registro, Genesys Cloud crea un registro en lugar de actualizar el existente. Para actualizar un registro existente, utilice siempre el mismo ID externo.
Organizaciones externas
Tel ID externo de la organización es el campo clave que el proceso de importación utiliza para determinar organizaciones únicas. Para cada ID externo de organización externa único, el proceso de importación crea un registro de organización externa de Genesys Cloud. El proceso de importación importa todos los campos de cuenta de la fila al registro de organización externa de Genesys Cloud correspondiente.
Al crear un ID externo de organización externa, puede utilizar cualquier combinación de letras y números. Puede crear una clave compuesta que tenga sentido para usted, siempre que cumpla la limitación de 255 caracteres. Si su .csv se extrae de un CRM, le recomendamos que utilice identificadores únicos (UUID) de su CRM. Los UUID permiten sincronizar los contactos de su CRM en las próximas actualizaciones de funciones.
Asociar un contacto externo con una organización externa
Para asociar un contacto externo a una organización externa, escríbalos en la misma línea en el archivo fuente .csv.
En este ejemplo, Angus Reid es un solucionador de problemas de la Fundación Phoenix II. El proceso de importación crea el registro de organización externa para Phoenix Foundation II y un registro de contacto externo para Angus Reid. En Contactos externos, Angus Reid aparece como contacto externo de la organización Phoenix Foundation II.
Asociar múltiples externos contactos con uno externo organización
Para asociar varios contactos externos a una organización externa , asigne el mismo ID externo de organización externa a todos ellos.
En este ejemplo, Kathryn, Josh y Rebecca son contactos de la organización Office Mart.
- Cuando el proceso de importación encuentra varias filas con el mismo ID externo de organización externa, Genesys Cloud espera que los datos de la cuenta sean los mismos en todos los campos. Por ejemplo, el Nombre de cuenta debe ser idéntico en todas las líneas que tengan el mismo ID externo de organización externa. El proceso de importación sólo importa una de las líneas de datos de la cuenta cuando varias líneas tienen el mismo ID externo de organización externa. Genesys no garantiza qué fila de datos de cuenta importa el proceso. No es necesariamente la primera o la última línea del conjunto de filas de la cuenta. Por lo tanto, todas las filas de datos de la cuenta deben ser idénticas.
- No puede utilizar un archivo .csv para importar miembros a una organización que creó manualmente.
Cómo gestiona el proceso de importación masiva las acciones de fusión
En este ejemplo, importe sólo contactos y suponga que todos los campos de organización de contactos externos del archivo .csv están vacíos.
Durante el proceso de Importación Masiva, se seleccionaron las siguientes opciones en la pantalla de Perfil de Importación:
- Emparejar contactos por: ID externo, número de teléfono y dirección de correo electrónico
- Fusionar contactos coincidentes: Fusionar y actualizar todos los contactos coincidentes
En este ejemplo, el orden de los identificadores buscados es:
- ExternalID: 123AABC
- teléfono: +1 919 432 5523
- correo electrónico: tom.sellenta@sag.aftra.com
El teléfono de trabajo del .csv coincide con el número de móvil del contacto C. Se crea un nuevo ContactoD fusionado.
En la tabla siguiente,
- La columna Nombre de campo indica el nombre del campo en el archivo .csv.
- La columna Datos CSV (Enrich Request) indica los datos del archivo .csv.
- La columna Contacto B es un contacto curado en Genesys Cloud.
- La columna Contacto C es un contacto curado en Genesys Cloud.
- La columna Contacto D es el contacto fusionado tras finalizar la importación.
- La columna Explicación describe cómo se importaron los datos de la columna Contacto D.
| Nombre del campo | Datos CSV (solicitud de enriquecimiento) | Contacto B | Contacto C | Contacto D (Contacto fusionado) | Explicación |
|---|---|---|---|---|---|
| ID externo | 123AABC | 123AABC | El ID externo del registro .csv enriquece el registro fusionado como su identificador primario. El ID de contacto utilizado por la antigua importación .csv ya no se utiliza ni se muestra en los registros de contacto. | ||
| Primer nombre | Tom | Tommy | Tom | Tom | Conflicto de datos, el contacto fusionado conserva los datos más recientes del archivo .csv. |
| middleName | T | T | Ningún conflicto | ||
| Apellido | Selleck | Selk | Selleck | Conflicto de datos, el contacto fusionado conserva los datos más recientes del archivo .csv. | |
| título | Resolver problemas | Resolver problemas | Se utiliza el valor del contacto C. | ||
| saludo | Señor | Mr. | Señor | Conflicto de datos, el contacto fusionado conserva los datos más recientes del archivo .csv. | |
| trabajo Correo electrónico | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com | Conflicto de datos, el contacto fusionado conserva los datos más recientes del archivo .csv. |
| Correo electrónico personal | tom@hotmail.com | tommy@yahoo.com | tom@gmail.com | Los correos electrónicos y los números de teléfono se tratan con cuidado durante las fusiones para evitar la pérdida de datos. Si dos contactos utilizan el mismo campo (por ejemplo, workEmail), los datos se trasladan a otro campo disponible (por ejemplo, personalEmail u otherEmail). En este ejemplo, "tom@gmail.com" se mueve de workEmail a personalEmail en lugar de eliminarlo. Este proceso continúa de forma iterativa hasta que se utilizan todos los campos posibles. Si no hay más campos disponibles, se eliminan los datos. |
|
| otro Correo electrónico | tommy@hotmail.com | Los nombres específicos de los campos no son importantes y los datos se conservan de los contactos fusionados siempre que sea posible. Si no quedan campos disponibles para la reubicación, los datos se descartan. | |||
| Teléfono móvil | +1 919 432-5523 | El teléfono del trabajo del .csv coincide con el teléfono móvil del contacto C. Este campo se actualizará después de la importación con el teléfono móvil de los datos .csv (que en este caso está vacío). | |||
| trabajo Teléfono | +1 919 432-5523 | +1 317 845-1232 | +1 317 845-1232 | Como la casilla Importar Campo no estaba marcada, el Teléfono de Trabajo del Contacto C permanece sin cambios después de la importación. | |
| Inicio Teléfono | Sin actualizaciones, sin valor en ningún contacto. | ||||
| otro Teléfono | Sin actualizaciones, sin valor en ningún contacto |
Este ejemplo sólo importa contactos. El supuesto es que los campos Org Externo en el archivo .csv están vacíos.
Durante el proceso de Importación Masiva, se seleccionaron las siguientes opciones en la pantalla de Perfil de Importación:
- Emparejar contactos por: ID externo, número de teléfono y dirección de correo electrónico
- Fusionar contactos coincidentes: Actualizar sólo el primer contacto coincidente
En este ejemplo, el orden de los identificadores buscados es: (El ID de correo electrónico va antes del ID externo)
- ExternalID: 123AABC
- correo electrónico: tom.selleck@sag.aftra.com
- teléfono: +1 919 432-5523
El correo electrónico del trabajo del .csv coincide con el correo electrónico del trabajo del contacto C y el teléfono del trabajo coincide con el teléfono móvil del contacto B. Como la opción Fusionar y actualizar todos los contactos coincidentes no está seleccionada, sólo se actualizará el contacto C tras la importación y el contacto B permanecerá sin cambios, aunque ambos contactos coincidan parcialmente con los datos CSV.
En la tabla siguiente,
- La columna Nombre de campo indica el nombre del campo en el archivo .csv.
- La columna CSV Data (Enrich Request) indica los datos del archivo .csv.
- La columna Contact B es un contacto curado en Genesys Cloud.
- La columna Contact C es un contacto curado en Genesys Cloud
- La columna Contacto actualizado C es el contacto fusionado tras finalizar la importación.
- La columna Explicación describe cómo se importaron los datos de la columna Contacto D.
| Nombre del campo | Datos CSV (solicitud de enriquecimiento) | Contacto B | Contacto C | Contacto C actualizado | Explicación |
|---|---|---|---|---|---|
| ID externo | 123AABC | 123AABC |
El ID externo del registro .csv enriquece el registro Contacto C como su identificador primario. El ID de cuenta utilizado por la antigua importación .csv ya no se utiliza ni se muestra en los registros de contactos. |
||
| Primer nombre | Tom | Tommy | Tom | Tom | Sin conflicto no hay cambio. |
| middleName | T | Actualizar el Contacto C con los datos del .csv. | |||
| Apellido | Selleck | Selk | Selleck | Conflicto. Actualizar el Contacto C con los datos del .csv. | |
| título | Resolver problemas | Resolver problemas | No hay actualizaciones porque el campo Importar no está marcado. | ||
| saludo | Señor | Mr. | Señor | Conflicto. Actualizar el Contacto C con los datos del .csv. | |
| trabajo Correo electrónico | tom.selleck@sag.aftra.com | tom@gmail.com | tom.selleck@sag.aftra.com | tom.selleck@sag.aftra.com |
El correo electrónico del trabajo del .csv coincide con el correo electrónico del trabajo del contacto C. Este contacto se actualiza después de la importación y el Contacto B permanece sin cambios ya que no fue el primer contacto emparejado y el Contacto C fue el primer contacto emparejado. |
| Correo electrónico personal | tommy@yahoo.com | tom@yahoo.com | No hay actualizaciones ya que el campo Importar no está seleccionado. | ||
| otro Correo electrónico | Sin actualizaciones, sin valor en ningún contacto. | ||||
| Teléfono móvil | +1 317 845-1232 | +1 317 845-1232 | No hay actualizaciones ya que el Campo de Importación no está seleccionado. | ||
| trabajo Teléfono | +1 919 432-5523 | +1 317 845-1232 | +1 919 432-5523 | Como hay un conflicto, el Contacto C se actualiza con los datos del .csv. | |
| Inicio Teléfono | Sin actualizaciones, sin valor en ningún contacto. | ||||
| otro Teléfono | Sin actualizaciones, sin valor en ningún contacto. |
En este ejemplo, algunos contactos se identifican y otros se curan. Por definición, los contactos identificados aún no han reclamado un identificador en el sistema. Los Contactos curados han reclamado un identificador en el momento de su creación.
Los contactos pueden ser de tres tipos:
- Efímero: Un contacto autogenerado que está asociado a un identificador web del lado del cliente o cookie, pero no tiene ninguna otra información. En otras palabras, es un contacto vacío al que apunta una cookie web/identificador del lado del cliente. Tienen un límite de tiempo de vida (TTL) de 60 días.
- Identificado: Un contacto autogenerado que no contiene cookies PII y tiene un límite TTL de 60 días.
- Comisariado: Contactos que han sido creados o _promovidos_ por agentes o llamadas a la API. No tienen límite TTL.
Los contactos efímeros e identificados son generados por el sistema y no aparecen en las API de búsqueda, en las búsquedas inversas de páginas blancas ni en los escaneos.
Los dos contactos siguientes coinciden en el sistema:
- Contacto B (comisariado)
- Contacto C (Identificado)
Durante el proceso de Importación Masiva, se seleccionaron las siguientes opciones en la pantalla de Perfil de Importación:
- Emparejar contactos por: ID externo, dirección de correo electrónico y número de teléfono.
- Fusionar contactos coincidentes: Fusionar y actualizar todos los contactos coincidentes.
En este ejemplo, el orden de búsqueda de los identificadores es:
- ExternalID:123AABC
- email: johnny@gmail.com
- teléfono: null
El campo Correo electrónico personal del archivo .csv coincide con el otro campo Correo electrónico del contacto C y el teléfono del trabajo del CSV coincide con el teléfono móvil del contacto B.
En la tabla siguiente,
- La columna Nombre de campo indica el nombre del campo en el archivo .csv.
- La columna Datos CSV (Enrich Request) indica los datos del archivo .csv.
- La columna Contacto B es un contacto curado en Genesys Cloud.
- La columna Contacto C es un contacto identificado en Genesys Cloud.
- La columna Contacto D es el contacto fusionado tras finalizar la importación.
- La columna Explicación describe cómo se importaron los datos de la columna Contacto D.
| Nombre del campo | Datos CSV (solicitud de enriquecimiento) | Contacto B | Contacto C | Contacto D | Explicación |
| ID externo | 123AABC | 123AABC | El ID externo del registro .csv enriquece el registro D de contacto fusionado como su identificador primario. | ||
| Primer nombre | Johnny | Johnny | Se utiliza el valor del Contacto Identificado ya que existe un conflicto. | ||
| middleName | Matthew | METRO | Matthew | Como hay un conflicto, se utiliza el valor del contacto curado más reciente . | |
| Apellido | Banks IV | Banks | Banks IV | Banks IV | Se utiliza el valor del Contacto Identificado ya que existe un conflicto. |
| título | Johnny Boy | Los valores nulos no se utilizan a partir de las importaciones .csv. Se utiliza el valor del contacto C. | |||
| saludo | Mr | Los valores nulos no se utilizan a partir de las importaciones .csv. Se utiliza el valor del contacto B. | |||
| trabajo Correo electrónico | Banks@gmail.com | Banks@gmail.com | Los correos electrónicos se tratan con cuidado durante las fusiones para evitar la pérdida de datos. Por lo tanto, aunque el correo electrónico de trabajo de los datos .csv sea nulo, conservamos el correo electrónico de trabajo del contacto B después de la fusión y lo colocamos en el correo electrónico de trabajo del contacto D fusionado. | ||
| Correo electrónico personal | johnny@gmail.com | johnny@gmail.com | El correo electrónico personal del .csv coincide con el otro correo electrónico del contacto C. El valor del .csv se utiliza para el correo electrónico personal del contacto D fusionado. |
||
| otro Correo electrónico | johnny@gmail.com | johnny@gmail.com | Los correos electrónicos se tratan con cuidado durante las fusiones para evitar la pérdida de datos. Por lo tanto, aunque el correo electrónico de trabajo de los datos .csv sea nulo, seguimos conservando el otro correo electrónico del contacto C después de la fusión y lo colocamos en otro correo electrónico para el contacto D fusionado. | ||
| Teléfono móvil | Sin actualizaciones, sin valor en ningún contacto. | ||||
| trabajo Teléfono | Sin actualizaciones, sin valor en ningún contacto | ||||
| Inicio Teléfono | Sin actualizaciones, sin valor en ningún contacto. | ||||
| otro Teléfono | Sin actualizaciones, sin valor en ningún contacto |
Contactos externos (antiguo proceso de importación)
El ID de contacto es el campo clave obligatorio. Genesys Cloud proceso de importación lo usa para determinar contactos únicos. Ayuda a identificar contactos para que pueda actualizar fácilmente los contactos existentes utilizando la misma hoja de cálculo. Para cada ID de contacto único, el proceso de importación crea un registro de contacto externo de Genesys Cloud. El proceso de importación importa todos los campos de contacto de la fila al registro de contacto externo de Genesys Cloud correspondiente.
Cuando crea una ID de contacto, puede usar cualquier combinación de letras y números. Por ejemplo, puede utilizar un identificador único de su sistema CRM o ERP, o yTu puedes crear un clave compuesta que sea significativa para usted. Puede ser cualquier ID que desee utilizar para identificar de forma exclusiva el registro.
Si solo planea importar el registro una vez, puede usar cualquier ID externo que desee. El sistema genera identificaciones internas para corresponder con esas identificaciones externas.
Si ha importado previamente sus contactos y desea actualizar los registros, asegúrese de utilizar los mismos ID de contacto para los contactos existentes. De lo contrario, Genesys Cloud crea un nuevo registro en lugar de actualizar el existente.
Por ejemplo, suponga que tiene una hoja de cálculo con un registro y la importa con A como ID de contacto. Más tarde, desea actualizar ese registro volviendo a importar la misma hoja de cálculo. El ID de contacto para ese registro debe ser el mismo que el de la importación anterior. Si, en cambio, reimporta la hoja de cálculo con B como ID de contacto para ese registro, Genesys Cloud crea un nuevo registro en lugar de actualizar el existente.
Organizaciones externas
TEl ID de cuenta es el campo clave que utiliza el proceso de importación para determinar organizaciones únicas. Para cada ID de cuenta único, el proceso de importación crea un registro de organización externa de Genesys Cloud. El proceso de importación importa todos los campos de la cuenta en la fila al registro de la organización externa de Genesys Cloud correspondiente.
Cuando crea una ID de cuenta, puede usar cualquier combinación de letras y números. Puede crear una clave compuesta que sea significativa para usted.
Asociar un contacto externo con una organización externa
Para asociar un contacto externo con una organización externa, escríbalos en la misma línea en el archivo de origen .csv.
En este ejemplo, Kathryn Smith es Compradora de Office Mart. El proceso de importación crea el registro de organización externa para Office Mart y un registro de contacto externo para Kathryn Smith. En Contactos externos, Kathryn Smith aparece como un contacto externo de la organización Office Mart.
Asociar múltiples externos contactos con uno externo organización
Para asociar varios contactos externos con uno externo organización, asígneles el mismo ID de cuenta.
En este ejemplo, Kathryn, Josh y Rebecca son contactos de la organización Office Mart.
- Cuando el proceso de importación encuentra varias filas con el mismo ID de cuenta, Genesys Cloud espera que los datos de la cuenta sean los mismos en todos los campos. Por ejemplo, el nombre de la cuenta debe ser idéntico en todas las filas que tienen el mismo ID de cuenta. El proceso de importación importa solo una de las filas de datos de la cuenta cuando varias filas tienen el mismo ID de cuenta. Genesys no garantiza qué fila de datos de cuenta importa el proceso. No es necesariamente la primera o la última línea del conjunto de filas de la cuenta. Por lo tanto, todas las filas de datos de la cuenta deben ser idénticas.
- No puede utilizar un archivo .csv para importar miembros a una organización que creó manualmente.
