Resumen: ◀▼
Con un archivo CSV, se pueden importar o actualizar varias organizaciones a la vez, en mucho menos tiempo que si se agregan una por una. El archivo CSV debe cumplir ciertos requisitos de formato y tamaño específicos, y para hacer importaciones es necesario ser administrador. Durante la importación se respetan los datos principales de las organizaciones y los campos personalizados, pero existen ciertas limitaciones. Por ejemplo, no se garantiza que la importación siga un orden y no pueden haber entradas duplicadas en un archivo. En los registros del historial de importaciones se hace seguimiento del progreso realizado.
En lugar de agregar organizaciones una por una, se pueden agregar varias organizaciones a la vez mediante la importación de un archivo CSV (valores separados por comas). La importación masiva se puede usar para agregar organizaciones o para actualizarlas. Es necesario ser administrador para poder hacer una importación masiva de organizaciones. También se pueden agregar o actualizar varios usuarios y varios registros de objetos personalizados a la vez.
La importación masiva de organizaciones no puede deshacerse. Antes de importar el archivo CSV que contiene la información de todas las organizaciones, pruebe el mismo archivo CSV con el registro de una sola organización para asegurarse de que la carga se realice correctamente.
Limitaciones para la importación masiva con el importador de datos
Es posible importar un conjunto de datos básico sobre usuarios y organizaciones. Para importar los datos que no aparecen en la tabla a continuación, se debe usar la API de REST de Zendesk en su lugar. Consulte Importing users with the Zendesk API.
- Cuando se usa el importador de datos, el archivo CSV de importación solo puede tener un tamaño máximo de 1 GB. Recomendamos un máximo de 500.000 filas. Es decir, una fila de encabezado y hasta 499.999 filas de datos. Además, el tamaño máximo de cada fila es de 128 KB.
- El archivo CSV de importación solo admite un máximo de 200 columnas.
- El archivo CSV de importación no puede garantizar el orden de importación de las filas.
- No incluya el mismo usuario ni la misma organización más de una vez en un archivo CSV. De lo contrario, la importación podría fallar.
- No se puede garantizar que los registros se creen o actualicen en el orden en que aparecen en el archivo CSV.
- Solo se puede importar un archivo CSV a la vez. Por lo tanto, si los datos sobrepasan el número máximo de filas que admite el archivo CSV, es necesario crear archivos separados por cada lote e importarlos uno tras otro. Cuando no se usa el importador de datos, es posible tener hasta dos lotes en la cola y ejecutarlos en segundo plano. Si desea importar más de dos lotes, tendrá que esperar hasta que finalice la importación de los dos primeros antes de agregar más.
- La herramienta de importación masiva no se puede usar para importar información de contacto de las cuentas de usuarios finales de Facebook o X (anteriormente Twitter). Para hacer ese tipo de importación es necesario usar la API de REST de Zendesk. Consulte Importing users with the Zendesk API.
Crear el archivo CSV de datos de organizaciones
Para hacer una importación masiva de organizaciones, se usa un archivo CSV de datos de las organizaciones. En esta sección se explica cómo configurar un archivo de datos CSV.
- El archivo debe tener el formato CSV correcto y estar guardado con la codificación de caracteres UTF-8.
- La primera fila del archivo CSV es la fila de encabezado.
- La fila de encabezado debe incluir todos los campos requeridos que se indican en la tabla a continuación, además de cualquier otro campo de la tabla que se desee incluir.
- En la fila de encabezado, utilice ya sea domain_names o default, según el método de importación que tenga. No se pueden usar los dos juntos.
- Si no desea importar datos para un campo, no lo incluya en la fila de encabezado.
- Las columnas de datos vacías en el archivo sobrescribirán los datos existentes para esa organización.
- Para agregar saltos de línea a las notas o campos personalizados de varias líneas, presione ALT+INTRO en Windows o CTRL+OPCIÓN+RETORNO en macOS.
| Campo | Descripción |
|---|---|
| name | Requerido. Nombre de la organización. |
| external_id | Opcional, pero recomendado; requerido si tiene intención de usar el importador de datos para actualizar estos registros en el futuro. Un valor de identificación único, como un número que identifique a un empleado o a un cliente en un sistema externo. |
| notes | Notas sobre la organización. Solo los agentes pueden ver las notas, no los usuarios finales. |
| details | Información detallada acerca de la organización, como la dirección. Solo los agentes pueden ver esta información, no los usuarios finales. Utilice este campo en lugar del encabezado default cuando se usa el importador de datos. |
| domain_names | Los nombres de dominio de la organización, que se utilizan para el mapeo de usuarios. Si va a incluir varios nombres de dominio para una organización, sepárelos con una barra vertical (|). |
| group_id | Ingrese un grupo predeterminado para la organización. Consulte Mapear un grupo a una organización. |
| tags | Si está activado el etiquetado de usuarios y organizaciones para Zendesk Support, puede configurar etiquetas para la organización. Separe cada etiqueta con una barra vertical ( | ). Cuando se hace una importación masiva de organizaciones, las etiquetas del archivo CSV reemplazan las etiquetas existentes de la organización. Para que eso no ocurra, utilice la API de etiquetas para actualizar las etiquetas. |
| organization_fields.<clave de campo> | Cuando se realiza una importación masiva de organizaciones, se puede importar un campo de organización personalizado especificando el prefijo organization_fields. y la clave de campo. Por ejemplo, para la clave de campo subscription_date, utilice lo siguiente para establecer los valores importados para este campo. organization_fields.subscription_date Para ubicar la clave de campo de un campo de organización, consulte Ubicar la clave de campo o la ID de campo de un campo personalizado. Si un valor de campo no tiene el formato correcto, la importación fallará y los detalles sobre el error se podrán ver en el registro del historial de importaciones. En los campos de fecha personalizados, utilice el formato AA/MM/DD o AAAA-MM-DD. Para los campos de casilla de verificación, utilice True o False. Para establecer el valor del campo desplegable, utilice la etiqueta que agregó cuando creó la lista desplegable.
Nota: Los campos de relación de búsqueda no se admiten cuando se importan organizaciones en la página Importador de datos.
|
Importar organizaciones con el importador de datos
El importador de datos sirve para importar un archivo CSV encargado de crear organizaciones nuevas o actualizar organizaciones existentes, además de capturar los registros de todos los intentos de importación a través de la página Importador de datos.
Cuando finaliza el proceso de importación, la importación se agrega a la cola y las organizaciones se agregan a Zendesk Support. Esto debería tomar alrededor de una hora por archivo en completarse, pero siempre dependerá del tamaño del archivo y de la cola.
- En el Centro de administración, haga clic en
Objetos y reglas en la barra lateral y luego seleccione Herramientas > Importador de datos. - Haga clic en Importar.
- Bajo Destino objetivo, seleccione Organización.
- En Opciones de importación, seleccione una de estas opciones:
- Solo crear registros: solo se crean organizaciones nuevas. Se ignoran todos los datos del archivo CSV relacionados con organizaciones existentes.
- Solo actualizar registros: reemplaza los datos de las organizaciones existentes incluidas en el archivo CSV. Se requiere la external_id para actualizar las organizaciones. Se ignoran los datos correspondientes a organizaciones nuevas.
- Crear y actualizar registros: crea nuevas organizaciones y actualiza los datos de las organizaciones existentes incluidas en el archivo CSV.
- Bajo Carga de archivos, arrastre y suelte su archivo o haga clic para cargar y seleccionar un archivo CSV en el explorador de archivos.
Si necesita cambiar el archivo que ya seleccionó, haga clic en el icono de borrar (
) junto al nombre del archivo. - Haga clic en Siguiente.
- Examine la lista Mapeo de campos.
- Si el mapeo es correcto, haga clic en Siguiente.
- Si el mapeo no es correcto, haga clic en Atrás. Edite el archivo CSV de manera que cumpla los requisitos de formato y vuelva a cargarlo.
- Examine el resumen de la importación en el cuadro de diálogo de confirmación y luego haga clic en Iniciar importación.
Una vez iniciada la importación, los cambios importados no se pueden revertir. Para verificar el estado de una importación, revise el historial de importaciones.