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 de la importación masiva de usuarios y organizaciones
Es posible importar un conjunto de datos básico sobre usuarios y organizaciones. Por ejemplo, mediante la importación masiva se pueden importar los datos que se describen en la tabla a continuación; sin embargo, no se pueden importar zonas horarias, fotos, preferencias de idioma, etc. 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 o Importing organizations with the Zendesk API.
- El número máximo de filas depende del método de importación.
- Cuando se usan las páginas Importación masiva para importar datos de usuarios y organizaciones nuevos y existentes, el archivo CSV de importación de datos puede contener un máximo de 2000 filas. Es decir, una fila de encabezado y hasta 1.999 filas de datos.
- Si se usa el importador de datos para importar datos de organizaciones nuevas y existentes, el tamaño máximo admitido para el archivo CSV de importación es 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.
- También se aplican las siguientes limitaciones cuando se usa el importador de datos:
- 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.
- 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 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 la organización
Para hacer una importación masiva de organizaciones, se usa un archivo CSV de datos de la organización. En esta sección se describe 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. |
domain_names (solo el importador de datos) |
Información detallada acerca de la organización, como la dirección. Solo los agentes pueden ver esta información, no los usuarios finales. Utilizar en lugar del encabezado default cuando se usa el importador de datos. |
default (no el importador de datos) |
Para mapear a los usuarios a una organización. Ingrese uno o más dominios de correo electrónico, separados por espacios (por ejemplo, organización1.com organización2.com). Utilizar en lugar del encabezado domain_names cuando no se usa el importador de datos. Consulte Agregar usuarios automáticamente a organizaciones según su dominio de correo electrónico. |
shared | True o False. Establece la organización como una organización compartida. Consulte Configurar una organización compartida para usuarios finales. |
shared_comments | True o False. Permite que todos los usuarios de la organización agreguen comentarios a los tickets de los otros usuarios. El campo compartido también debe establecerse en verdadero. Consulte Configurar una organización compartida para usuarios finales. |
group | 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 (consulte Adición de etiquetas a usuarios y organizaciones), puede configurar etiquetas para la organización. Separe cada etiqueta con un espacio. 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> (solo el importador de datos) |
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 para un campo de organización personalizado, haga clic en el icono Administrador () y seleccione Campos de organización, y luego haga clic en el nombre de un campo personalizado. La clave de campo aparece en el panel de propiedades de la derecha. 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.
|
custom_fields.<clave de campo> (no el importador de datos) |
Cuando se realiza una importación masiva de organizaciones, se puede importar un campo de organización personalizado especificando el prefijo custom_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. custom_fields.subscription_date Para ubicar la clave para un campo de organización personalizado, haga clic en el icono Administrador () y seleccione Campos de organización, y luego haga clic en el nombre de un campo personalizado. La clave de campo aparece en el panel de propiedades de la derecha. Si una clave de campo no tiene el formato correcto, la importación fallará y se le enviará por correo electrónico un informe de error que especifica los registros que no se guardaron. 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 de las opciones de la lista desplegable, utilice la etiqueta que agregó cuando creó la lista desplegable.
Nota: Si el campo de organización personalizado que está importando es un campo de relación de búsqueda, ingrese la ID del objeto relacionado como el valor para este campo. Por ejemplo, para una organización, ingrese la ID de la organización; para un usuario, ingrese la ID del usuario; para un registro de objeto personalizado, ingrese la ID del registro. Para buscar la ID de una organización, un usuario o un registro de objeto personalizado, puede exportar los datos de su cuenta o usar la API de organizaciones, la API de usuarios o la API de registros de objetos personalizados.
Los campos de relación de búsqueda no se admiten cuando se importan organizaciones en la página Importador de datos. |
Importar el archivo CSV de datos de la organización
Puede emplear la importación masiva para crear nuevas organizaciones o actualizar la información de organizaciones existentes.
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. Consulte Limitaciones de importación masiva de usuarios y organizaciones.
Usar el importador de datos para importar datos de organizaciones
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.
- 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 Organizaciones.
- Bajo Tipo de importación, elija una de las siguientes 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.
Usar una importación de archivo CSV para actualizar los datos de organizaciones existentes
Se recomienda usar el importador de datos, pero puede seguir usando las páginas Acciones masivas para importar datos de organizaciones nuevas y actualizadas. Recibirá un correo electrónico cuando finalicen las importaciones de esta página.
- En el Centro de administración, haga clic en Personas en la barra lateral y luego seleccione Acciones masivas > Importar organizaciones.
- Elija el tipo de importación que desea realizar:
-
Crear nuevas organizaciones
-
Actualizar organizaciones existentes: este tipo de importación se usa para reemplazar los datos existentes de las organizaciones incluidos en el archivo CSV.
La external_id o el nombre de la organización deben incluirse en el archivo CSV para que se puedan identificar. Aparte del campo identificador de la organización, solo es necesario incluir en el archivo los campos que se desean actualizar. Si la fila de una organización tiene un campo en blanco, este sobrescribiría los datos existentes de esa organización.
-
- Haga clic en Elegir archivo o en el vínculo Permitirme más bien pegar datos.
- Haga clic en Importar.
Una vez iniciada la importación, los cambios importados no se pueden revertir.
- (Opcional) Puede ver el estado de las importaciones en curso en la página Centro de administración > Objetos y reglas > Herramientas > Importador de datos. Una vez que finaliza la importación, esto se refleja en el registro del historial de importaciones.