Adición de contactos del directorio
Contenidos de la página
Acerca de cómo agregar contactos del Directorio
El Directorio de contactos Esta pestaña contiene todos los contactos añadidos al directorio de su organización. Cualquier contacto añadido a un envío lista de distribución se agregan a este directorio automáticamente, pero también puede agregar personas directamente al directorio mismo usando el Agregar contactos botón.
Consejo Q: Los contactos añadidos al directorio son visibles para todos los usuarios de la organización. con acceso al directorio .
Consejo Q: Al agregar nuevos contactos, asegúrese de revisar su Configuración para fusionar duplicados , que será visible en la ventana de importación. Estas configuraciones determinan cómo se identifican y combinan los duplicados; estas configuraciones pueden modificarse mediante administradores de directorio .
Proyectos que pueden utilizar contactos del XM Directory
Consejo Q: Las características analizadas en esta sección no necesariamente están incluidas en todas las licencias. Si está interesado en obtener acceso, comuníquese con su Ejecutivo de Cuenta .
Puedes usar XM Directory para crear listas de contacto y enviar invitaciones para varios tipos de eventos. proyectos de Qualtrics . Sin embargo, no todos los tipos de proyectos de Qualtrics son compatibles con XM Directory.
XM Directory poder Se utilizará para enviar lo siguiente:
- Proyectos de encuesta
- Asociado / MaxDiff
- Ciertos no- EX Soluciones XM
Consejo Q: También puedes Enviar correos electrónicos sin un enlace a ninguna encuesta..
Sin embargo, los datos de contacto del XM Directory son completamente separado a partir de la información del empleado / participante guardada en el Directorio de Empleado . Esto significa que los datos editados en un directorio nunca afectarán al otro. XM Directory no puedo ser utilizado para distribuir cualquier proyectos de Employee Experience (EX ), incluidos Engagement, Pulse, 360 y más.
Campos de contactos disponibles
Ya sea que cargues un archivo CSV o TSV con tus contactos o que los escribas manualmente, hay cierta información que debes incluir para tus contactos.
Consejo Q: Dependiendo de cómo esté su directorio fusiona duplicados, FirstName, LastName, Correo electrónico y/o Referencia de Datos Externos pueden ser campos obligatorios.
- FirstName: El nombre de pila del contacto.
- LastName: El apellido del contacto.
- Correo electrónico: La dirección de correo electrónico del contacto. Se recomienda que usted fusionar duplicados fuera de este campo.
- Referencia de datos externos: Información extra 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 autenticadores y configurar cómo se crea el directorio fusiona duplicados.
Datos embebidos: Los Datos embebidos son campos adicionales que contienen cualquier campo que desee. No es necesario seguir una convención concreta para los nombres. En la captura de pantalla anterior, el departamento, la ciudad y el país son 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.
- Idioma: Una columna opcional que identifica el idioma del contacto utilizando códigos de idioma .
- Teléfono: Una columna opcional que identifica el número de teléfono del contacto. Ver el Distribuciones de SMS Página de soporte para formatos de números de teléfono aceptados.
Consejo Q: Si incluye estos campos en su archivo, Los títulos de sus columnas deben coincidir perfectamente con estos nombres en mayúsculas y espaciado. . La única excepción es que los datos embebidos no distinguen entre mayúsculas y minúsculas.
Atención: No cambie los valores en el ID de contacto ¡columna! Este campo se utiliza para identificar los contactos existentes. No puedes usar ContactID para crear nuevos contactos. Sólo se puede utilizar para actualizar contactos existentes.
Datos de fecha y hora
Si tiene datos embebidos guardados en formato de fecha, puede usar un filtro para buscar fechas futuras o fechas que ocurrieron recientemente. Para buscar por fecha, el campo de fecha debe estar en formato ISO-8601, con horas en UTC. (Es decir, AAAA-MM-DDT-HH:mm:ss+ZZZZ . Puede encontrar más información sobre estos símbolos en Sintaxis del formato de fecha página de soporte).
Ejemplo: Digamos que nuestra fecha es el 31 de marzo de 2021 a las 9:00:00 a. m. EDT (UTC-4). Esta fecha en formato ISO-8601 es 2021-03-21T13:00:00.000Z. Observe cómo se ha convertido la hora de EDT a UTC.
Subir un archivo de contactos del Directorio
Asegúrate de empezar en el Directorio de contactos pestaña.
Consejo Q: Excel interpreta caracteres no ASCII (por ejemplo, 是 o ñ) de una manera única que hace que sea difícil para Qualtrics cargarlos. Cuando trate de importar nombres con caracteres especiales, quizá tenga que guardar la información de su lista de contactos con un editor de texto (p. ej., con TextEdit en un Mac o Bloc de notas en Windows) para poder cargar el archivo en Qualtrics. Ver el Problemas especiales de personajes en nuestro Problemas al cargar archivos CSV/ TSV Página para instrucciones adicionales.
Solución de problemas de importación de archivos de Contacto
Qualtrics facilita la verificación del estado de sus importaciones de contacto y la corrección de cualquier error que pueda haber ocurrido. Durante el proceso de carga, es posible que reciba un aviso si su archivo está configurado incorrectamente. Se le proporcionará una solución y se le impedirá subir el archivo hasta que se solucione el problema, manteniendo así los datos de su directorio limpios y precisos.
Ejemplo: En la captura de pantalla que aparece a continuación, el archivo fue bloqueado porque la Referencia a datos externos tenía más de 100 caracteres. Si corregimos esto, podremos volver a subir nuestro archivo.
Descarga del informe de estado de una importación
Proporcionamos un archivo línea por línea de cada contacto e información sobre si se importó correctamente. Esto sirve como referencia para que si tus contactos no se importan, puedas identificar cuál fue el problema, arreglar el archivo e intentarlo nuevamente.
A continuación se muestra una descripción de cada campo en el informe de errores:
- ID de índice de origen: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.
- ID de contacto:El ID del contacto en su directorio.
- Estado de importación:El estado de importación del contacto. Los valores incluyen: Agregado, Actualizado y Error.
- Código de estado de importación:El código de estado de la importación. Consulte la siguiente sección para obtener una lista de códigos y sus significados.
Identificación de transacción:Si corresponde, el ID de Transacción de la carga o actualización del contacto .
Consejo Q : Puedes configurar actas Cuando se utiliza un flujo de trabajo de importación de contacto, o al agregar contactos a través de API.
- Estado de la transacción: Si corresponde, el estado de la transacción. Los valores incluyen: Agregado, Actualizado y Error.
- Código de estado de la transacción:El código de estado de la transacción. Consulte la siguiente sección para obtener una lista de códigos y sus significados.
- Descripción del estado de importación : Descripción del problema detectado. Consulte la siguiente sección para ver una lista de los códigos que corresponden a cada descripción.
- Lista de contactosContactId: Si se agregan contactos a una lista de distribución o se crea una nueva lista, el ID del contacto en la lista de distribución específica.
- Lista de contactos Estado del contacto:Si se agregan contactos a una lista de distribución o se crea una nueva lista, el estado de la adición o actualización. Los valores incluyen: Agregado, Actualizado y Error.
- Lista de contactos Código de estado del contacto: 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.
Errores de archivos comunes y sus códigos de estado
A continuación se muestra una lista de posibles códigos de estado y sus descripciones.
Consejo Q: Si contacta al soporte para solicitar ayuda, tenga a mano el archivo de resolución de problemas.
| Código de estado | Descripción |
|---|---|
| 0 | Ocurrió un error desconocido; vuelva a intentar la importación. |
| 1 | Ocurrió un error desconocido; vuelva a intentar la importación. |
| 10 | El contacto FirstName Está vacío o no es válido; por favor, introduzca un nombre válido. |
| 11 | El contacto LastName Está vacío o no es válido; por favor, introduzca un apellido válido. |
| 12 | El valor del contacto para Referencia de datos externos está vacío o no es válido; ingrese un valor ExternalDataReference válido. |
| 13 | El contacto Teléfono está vacío o no es válido; ingrese un número de teléfono válido. |
| 14 | El contacto Correo electrónico No es válido; por favor, introduzca una dirección de correo electrónico válida. |
| 15 | Contacto no válido debido a que la clave del campo de datos embebidos tiene más de 200 caracteres. |
| 16 | Contacto no válido debido a que el valor del campo de datos embebidos tiene más de 1024 caracteres. |
| 18 | El contacto tiene un ID de contacto que existe en un directorio diferente al que se está importando; borre el valor. |
| 19 | El contacto Idioma no es válido; por favor ingrese un código de idioma Eso tiene menos de 20 caracteres. |
| 20 | El contacto no se creó porque contiene código ejecutable, ya sea en la información de contacto o en los datos embebidos. |
| 40 | El contacto fue creado exitosamente. |
| 41 | El contacto se actualizó exitosamente. |
| 42 | El contacto no fue creado; vuelva a intentar la importación. |
| 43 | El contacto no fue creado; vuelva a intentar la importación. |
| 44 | El contacto no fue creado; vuelva a intentar la importación. |
| 45 | El contacto no fue creado; vuelva a intentar la importación. |
| 46 | El contacto no fue creado; vuelva a intentar la importación. |
| 47 | El contacto no fue creado; vuelva a intentar la importación. |
| 49 | Se produjo un error interno; vuelva a intentar la fila fallida. Si el error persiste, contacto con Qualtrics para obtener asistencia. |
| 60 | El contacto se agregó a la lista de distribución con éxito. |
| 61 | El contacto se actualizó en la lista de distribución con éxito. |
| 62 | El contacto no se agregó a la lista de distribución; vuelva a intentar la importación. |
| 63 | El Contacto no se agregó a la lista porque falló la creación del contacto |
| 70 | La transacción se creó exitosamente. |
| 71 | La importación de la transacción falló: no se encontró ningún contacto válido asociado a la transacción; por favor, proporcione información de contacto válida. |
| 72 | La transacción no se creó; vuelva a intentar la importación. |
| 73 | La creación de la transacción falló porque ID de contacto o Lista de contactosContactId No se encontró en el directorio; ingrese un ContactId y ContactListContactId válidos. |
| 74 | La creación de la transacción falló debido a la falta de Fecha de transacción; Por favor ingrese una fecha de transacción válida. |
| 75 | Ocurrió un error desconocido; vuelva a intentar la importación. |
| 76 | Transacción no válida debido a que la clave del campo de datos de transacción tiene más de 200 caracteres. |
| 77 | Transacción no válida debido a que el valor del campo de datos de transacción tiene más de 1024 caracteres. |
| 78 | La transacción no se creó porque falló la creación del contacto asociado. |
Otros consejos para solucionar problemas
- Ortografía del encabezado: Asegúrese de tener todos los encabezados relevantes. La mayúscula, la ortografía y el espaciado son importantes. Ver una lista de campos predeterminados .
- Encabezados faltantes: Todas las columnas deben tener encabezados.
- Límites de caracteres: Es posible que su archivo tenga uno o varios campos que excedan el límite de caracteres. Revise los límites de caracteres a continuación:
- Idioma: 20
- Nombre: 100
- Apellido: 100
- Dirección de correo electrónico: 254
- Número de teléfono: 20
- Referencia a datos externos: 100
- Campo de Datos embebidos : 200
- Valor de los Datos embebidos : 1.024
- Blanco valores :Tenga en cuenta que la configuración del directorio puede afectar el modo en que se tratan los valores en blanco. Si intentas actualizar un contacto y no obtienes el resultado esperado, puede deberse a una configuración que haya establecido un administrador. Ver Importación de valores en blanco en el XM Directory .
- Problemas con el formato del archivo: Si los consejos de esta sección no han resuelto su problema, consulte también la Problemas al cargar archivos CSV y TSV página.
Introducción manual de contactos del Directorio
Asegúrate de empezar en el Directorio de contactos pestaña.
Cómo agregar contactos desde Digital Intercepts
Puede agregar contactos automáticamente a su XM Directory desde cualquier intercepción digital que haya creado. Más información sobre cómo configurar la creación automática de contacto en proyectos de Opinión sobre el sitio web/de la aplicación se puede encontrar en el Integración del XM Directory con Digital Intercepts Página de soporte.
Extraer contactos automáticamente de otra plataforma
Puede configurarlo para que los contactos se extraigan automáticamente de otro servicio que utilice (como SFTP, Qualtrics File Service, Google Drive o más) a Qualtrics. Elija el horario que funcione mejor para usted y su equipo, luego déjelo funcionar por sí solo.
Mira esto Flujos de trabajo del XM Directory Para obtener más información, visite nuestra página web.
Preguntas frequentes
Parece que mi archivo se subió correctamente, pero no veo ningún contacto en mi lista en el XM Directory. ¿Qué ocurrió?
Parece que mi archivo se subió correctamente, pero no veo ningún contacto en mi lista en el XM Directory. ¿Qué ocurrió?
Si no puede ver la pestaña Configuración de directorio, consulte su Administrador de Marca/organización .
Mi archivo de contactos de la lista de distribución/directorio no se carga en absoluto en XM Directory. ¿Lo que está sucediendo?
Mi archivo de contactos de la lista de distribución/directorio no se carga en absoluto en XM Directory. ¿Lo que está sucediendo?
¿Cómo puedo agregar contactos que ya están en el XM Directory a una Lista de correo?
¿Cómo puedo agregar contactos que ya están en el XM Directory a una Lista de correo?
¿Qué es el XM Directory? / ¿Dónde está el Público Objetivo ?
¿Qué es el XM Directory? / ¿Dónde está el Público Objetivo ?
Cuando se importan actualizaciones a contactos existentes, ¿cómo se tratan los campos vacíos o en blanco?
Cuando se importan actualizaciones a contactos existentes, ¿cómo se tratan los campos vacíos o en blanco?
Al actualizar los contactos mediante la carga de un archivo, aparecerá un espacio en blanco. campos de contacto (como FirstName, LastName y ExternalDataReference) voluntad Sobrescribir los valores existentes para los contactos en el directorio.
Sin embargo, campos de datos embebidos del directorio no lo hará Sus datos se sobrescribirán por defecto. Puedes elegir qué campos de datos embebidos deben permitir que los valores en blanco sobrescriban los existentes ajustando la configuración de tu directorio. Ver Importación de valores en blanco en el XM Directory Para obtener más información.
¡Genial! ¡Gracias por tus comentarios!
¡Gracias por tus comentarios!