Adición de contactos del directorio
Acerca de la adición de contactos del directorio
La pestaña Contactos del directorio contiene todos los contactos añadidos al directorio de su organización. Todos los contactos añadidos a una lista de distribución se añaden automáticamente a este directorio, pero también puede añadir personas directamente al directorio utilizando el botón Añadir contactos del directorio.
Proyectos que pueden utilizar contactos de XM Directory
Puede utilizar XM Directory para crear listas de contactos y enviar invitaciones para varios tipos de proyectos de Qualtrics. Sin embargo, no todos los tipos de proyecto de Qualtrics son compatibles con XM Directory.
XM Directory se puede utilizar para enviar lo siguiente:
- Proyectos de encuesta
- Conjoint / MaxDiff
- Ciertas soluciones XM que no son de EX
Sin embargo, los datos de contacto de XM Directory están completamente separados de la información de empleado/participante guardada en el Directorio de empleados. Esto significa que los datos editados en un directorio nunca afectarán al otro. XM Directory no se puede utilizar para distribuir ningún proyecto de Employee Experience (EX), incluidos Engagement, Pulse, 360 y más.
Campos de contactos disponibles
Ya sea que cargue un CSV o TSV de contactos o que los escriba manualmente, hay cierta información que debe incluir en sus contactos.
- Nombre: El nombre del contacto.
- Apellido: El apellido del contacto.
- Correo electrónico: La dirección de correo electrónico del contacto. Se recomienda fusionar duplicados de este campo.
- ExternalDataReference: Información adicional sobre el contacto. Lo más habitual es que este campo se utilice para almacenar información como, por ejemplo, un ID de empleado o de estudiante. Se puede utilizar para iniciar sesión en autenticadores y configurar cómo el directorio fusiona duplicados.
- Datos embebidos: Los datos embebidos son campos adicionales que contienen el campo que desee. No es necesario seguir una convención concreta para los nombres. En la captura de pantalla anterior, Departamento, Ciudad y País son todos datos embebidos.
Consejo Q: Los nombres de datos embebidos tienen un máximo de 200 caracteres. Los valores deben tener un máximo de 1024 caracteres cada uno.Advertencia: Todos los campos de datos embebidos anteriormente distinguieron entre mayúsculas y minúsculas. Para una gran mayoría de usuarios, los datos embebidos ya no distinguen entre mayúsculas y minúsculas, lo que significa que “prueba” y “prueba” se tratarían como el mismo campo. Sin embargo, seguimos recomendando que lo mejor es respetar las mayúsculas y minúsculas, ya que existe una pequeña parte de las cuentas en la que no se ha realizado este cambio.Advertencia: No utilice puntos como campo de datos embebidos, ya que es un campo reservado en XM Directory. Además, no utilice ninguno de los otros campos predeterminados de Qualtrics.
- Idioma: Una columna opcional que identifica el idioma del contacto mediante códigos de idioma.
- Teléfono: Una columna opcional que identifica el número de teléfono del contacto. Consulte la página de soporte técnico “Distribuciones por SMS” para conocer los formatos aceptados de números de teléfono.
Datos de fecha y hora
Si ha guardado datos embebidos en un formato de fecha, puede utilizar un filtro para buscar fechas futuras o fechas que se hayan producido recientemente. Para buscar por fecha, el campo de fecha debe tener el formato ISO-8601, con horas en UTC. (Por ejemplo, AAAA-MM-DDT-HH:mm:ss+ZZZZ . Puede encontrar más información sobre estos símbolos en la página de soporte Sintaxis de formato de fecha).
Cargar un archivo
- Haga clic en Añadir contactos del directorio.
- Haga clic en Cargar un archivo.
- En Excel, cree un documento con los campos necesarios y guárdelo como CSV o TSV. O haga clic en Descargar una plantilla de muestra, rellene las columnas adecuadas, añada los datos embebidos que desee y guarde el archivo.
- Cuando el archivo esté listo, arrástrelo y suéltelo en el espacio proporcionado o haga clic en Seleccionar un archivo y seleccione el archivo de su carpeta.
- Haga clic en Siguiente.
- Revise las condiciones de importación de contactos. Aquí se mostrará cualquier regla válida para toda la dirección para fusionar contactos duplicados. Estas reglas se configuran en la configuración del directorio y se aplicarán a los contactos de su archivo.
Consejo Q: El acceso a la pestaña Configuración del directorio requiere el permiso Gestionar directorio. Póngase en contacto con el administrador de organización si le interesa obtener acceso a esta configuración. - Revise los campos de su archivo para asegurarse de que la información es correcta. En caso de que alguno de los campos no se hubiera reconocido adecuadamente, haga clic en el nombre de campo para ver una lista desplegable de opciones y seleccionar el campo correcto.
Consejo Q: Si los datos no tienen el formato correcto en la vista previa (por ejemplo, agrupados en lugar de divididos en columnas), es posible que sus datos no estén separando (o “delimitando”) correctamente. Para solucionarlo, seleccione el enlace azul Mostrar opciones y elija un Delimitador y/o Cierre diferente.Consejo Q: Si se carga un contacto con un campo incrustado vacío que ya tiene un valor almacenado en ese campo, el campo no se sobrescribirá y el valor actual permanecerá.
- Haga clic en Cargar el archivo para cargar los contactos en su directorio.
Resolución de problemas de importación de archivos
Qualtrics facilita la verificación del estado de las importaciones de contactos y la corrección de los errores que puedan haberse producido. Proporcionamos un archivo línea por línea de cada contacto e información sobre si se importó correctamente. Esto sirve de referencia para que, si sus contactos no pueden importar, pueda identificar cuál era el problema, corregir el archivo e intentarlo de nuevo.
Para obtener un estado detallado de la importación:
- Después de cargar su archivo, haga clic en el icono de la caja de herramientas en la esquina superior derecha de la pestaña Contactos del directorio.
Consejo Q: Si importa contactos a una lista de distribución específica, también puede hacer clic en la caja de herramientas desde la lista de distribución. - Haga clic en Ver detalles de importación.
- Revise el resumen de la importación. Esto incluirá cuántos contactos se han creado, cuántos se han actualizado y cuántos contactos no se han podido importar. Además, a su importación se le asignará un ID de progreso, lo que resulta útil si necesita ponerse en contacto con el soporte técnico de Qualtrics.
- Para descargar su archivo de informe de errores, haga clic en Descargar un informe.
Consejo Q: Según el tamaño de su carga, el informe puede tardar unos minutos en generarse. - Abra el archivo en un editor de hojas de cálculo en su ordenador y revise el archivo para ver los contactos que hayan fallado. La columna más útil para identificar contactos fallidos es la columna ImportStatus. A continuación encontrará más información sobre cada columna.
Campos de informe de errores
A continuación encontrará una descripción de cada campo en el informe de errores:
- SourceIndexId: el índice o ID de fila del contacto en el archivo de importación.
- Correo electrónico: La dirección de correo electrónico asociada con el contacto.
- ContactId: El ID del contacto en su directorio.
- Estado de importación: El estado de importación del contacto. Los valores incluyen: Añadido, Actualizado y Fallido.
- ImportStatusCode: el código de estado para la importación. Consulte la siguiente sección para obtener una lista de códigos y sus significados.
- TransactionId: Si corresponde, el ID de transacción de la carga o actualización de contacto.
Consejo Q: Puede configurar transacciones al utilizar una automatización de importación de contactos o al añadir contactos mediante una API.
- Estado de transacción: si corresponde, el estado de la transacción. Los valores incluyen: Añadido, Actualizado y Fallido.
- TransactionStatusCode: el código de estado de la transacción. Consulte la siguiente sección para obtener una lista de códigos y sus significados.
- ContactListContactId: Si añade contactos a una lista de distribución o crea una lista nueva, el ID del contacto en la lista de distribución específica.
- ContactListContactStatus: Si añade contactos a una lista de distribución o crea una lista nueva, el estado de la adición o actualización. Los valores incluyen: Añadido, Actualizado y Fallido.
- ContactListContactStatusCode: el código de estado del contacto en la lista de distribución. Consulte la siguiente sección para obtener una lista de códigos y sus significados.
Códigos de estado
A continuación se muestra una lista de posibles códigos de estado y sus descripciones.
Consejo Q: Si se pone en contacto con el soporte técnico para obtener ayuda, tenga a mano el archivo de resolución de problemas.
Código de estado | Descripción |
0 | Se ha producido un error desconocido; póngase en contacto con Qualtrics para obtener soporte técnico. |
1 | Se ha producido un error desconocido; póngase en contacto con Qualtrics para obtener soporte técnico. |
10 | El nombre del contacto está vacío o no es válido; introduzca un nombre válido. |
11 | El apellido del contacto está vacío o no es válido; introduzca un apellido válido. |
12 | El valor de contacto para ExternalDataReference está vacío o no es válido; introduzca un valor de ExternalDataReference válido. |
13 | El teléfono del contacto está vacío o no es válido; introduzca un número de teléfono válido. |
14 | La dirección de correo electrónico de contacto no es válida; introduzca una dirección de correo electrónico válida. |
15 | Contacto no válido porque la clave del campo de datos embebidos tiene más de 200 caracteres. |
16 | El contacto no es válido porque el valor del campo de datos embebidos tiene más de 1024 caracteres. |
18 | El contacto tiene un ContactID que existe en un directorio diferente al que se importa a; borre el valor. |
19 | El idioma de contacto no es válido; introduzca un código de idioma que tenga menos de 20 caracteres. |
40 | El contacto se ha creado correctamente. |
41 | El contacto se ha actualizado correctamente. |
42 | No se ha creado el contacto; póngase en contacto con Qualtrics para recibir soporte técnico. |
43 | No se ha creado el contacto; póngase en contacto con Qualtrics para recibir soporte técnico. |
44 | No se ha creado el contacto; póngase en contacto con Qualtrics para recibir soporte técnico. |
45 | No se ha creado el contacto; póngase en contacto con Qualtrics para recibir soporte técnico. |
46 | No se ha creado el contacto; póngase en contacto con Qualtrics para recibir soporte técnico. |
47 | No se ha creado el contacto; póngase en contacto con Qualtrics para recibir soporte técnico. |
60 | El contacto se ha añadido correctamente a la lista de distribución. |
61 | El contacto se ha actualizado correctamente en la lista de distribución. |
62 | El contacto no se ha añadido a la lista de distribución; póngase en contacto con Qualtrics para recibir soporte técnico. |
63 | El contacto no se agregó a la lista porque falló la creación del contacto |
70 | La transacción se ha creado correctamente. |
71 | Falló la importación de la transacción. No había ningún contacto válido asociado a la transacción. Proporcione información de contacto válida. |
72 | La transacción no se ha creado; póngase en contacto con Qualtrics para obtener soporte técnico. |
73 | La creación de la transacción ha fallado porque ContactId o ContactListContactId no existen en el directorio; indique un ContactId y ContactListContactId válidos. |
74 | La creación de la transacción ha fallado debido a que falta TransactionDate; introduzca una fecha de transacción válida. |
75 | Se ha producido un error desconocido; póngase en contacto con Qualtrics para obtener soporte técnico. |
76 | La transacción no es válida porque la clave del campo de datos de transacción tiene más de 200 caracteres. |
77 | La transacción no es válida porque el valor del campo de datos de transacción tiene más de 1024 caracteres. |
78 | La transacción no se ha creado porque ha fallado la creación del contacto asociado; póngase en contacto con Qualtrics para obtener soporte técnico. |
Troubleshooting Other Errors
- Your file has a field or multiple fields that exceed the character limit. Review the character limits below:
- Idioma: 20
- Nombre: 100
- Apellido: 100
- Dirección de correo electrónico: 254
- Número de teléfono: 20
- Referencia externa: 100
- Campo de datos embebidos: 200
- Valor de datos embebidos: 1.024
Entrada manual
- Haga clic en Añadir contactos del directorio.
- Seleccione Entrada manual.
- Revise las condiciones de importación de contactos. Aquí se mostrará cualquier regla válida para toda la dirección para fusionar contactos duplicados. Estas reglas se configuran en la configuración del directorio y se aplicarán a los contactos que introduzca.
- Rellene los campos disponibles. Puede escribir o copiar y pegar información de contacto.
- Haga clic en el signo más (+) para añadir una columna adicional para los datos embebidos. Recuerde que puede incluir lo que quiera en estos campos.
- Haga clic en Siguiente para cargar sus contactos.
Añadir contactos desde intercepts digitales
Puede añadir contactos automáticamente a su XM Directory desde cualquier intercept digital que haya creado. Puede encontrar más información sobre cómo configurar la creación automática de contactos en proyectos de opinión de página web/aplicación en la página de soporte Integración de XM Directory con Digital Intercepts.