Importación masiva de organizaciones

Atención: El Importador de datos se encuentra actualmente en versión beta abierta. La página Importar organizaciones en el Centro de administración continuará estando disponible durante la versión beta.

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. Se pueden agregar o actualizar varios usuarios a la vez (consulte Importación masiva de usuarios).

Nota: Si desea hacer una importación masiva de organizaciones y usuarios, primero debe importar las organizaciones. Si desea información sobre la importación masiva de usuarios, consulte Importación masiva de usuarios.

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 realice las tareas previstas.

Este artículo contiene las siguientes secciones:

• Limitaciones de la importación masiva de usuarios y organizaciones
• Crear el archivo CSV de datos de la organización
• Importar el archivo CSV de datos de la organización

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.

También existen las siguientes limitaciones para la importación masiva:

• El número máximo de filas depende del método de importación.
  • Cuando se importan datos de usuarios o se actualizan datos de organizaciones, el archivo CSV de importación de datos admite un máximo de 2000 filas solamente. Es decir, una fila de encabezado y hasta 1.999 filas de datos.
  • Si se usa el Importador de datos (beta) para importar datos de nuevas organizaciones, 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.
• 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 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.

Hay algunas cosas importantes que se deben tener en cuenta al crear el archivo:

• 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 y tiene que incluirse en el archivo.
• 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.
• Los campos incluidos deben aparecer en la fila de encabezado en el orden que se sigue en la lista a continuación.
• 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.

La tabla siguiente muestra una lista de los campos que se pueden incluir en el archivo.

Tabla 1. Datos de importación de organización

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.
default	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). 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 agregar etiquetas a la organización. Separe cada etiqueta con un espacio.
custom_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 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 recibirá un informe de error que indica los registros que no se pudieron guardar. 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 buscar la ID de una organización o de un usuario, exporte los datos de su cuenta o use la API de organizaciones o la API de usuarios. Los campos de relación de búsqueda no se admiten cuando se importan organizaciones en la página Importador de datos. Consulte Adición de campos personalizados a organizaciones.

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.

Uso del Importador de datos para crear nuevas organizaciones (beta)

El Importador de datos se encuentra en versión beta y sirve para importar un archivo CSV encargado de crear nuevas organizaciones y capturar los registros de todos los intentos de importación a través de la página Importador de datos. Durante la versión beta, el Importador de datos no se puede usar para actualizar los datos de organizaciones existentes.

Para crear nuevas organizaciones con el Importador de datos

1. En el Centro de administración, haga clic en Objetos y reglas en la barra lateral y luego seleccione Herramientas > Importador de datos.
2. Haga clic en Importar.
3. 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.

4. Haga clic en Siguiente.
5. 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.
6. 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.

Uso de una importación de archivo CSV para actualizar los datos de organizaciones existentes

La página Importador de datos solo se puede usar para crear nuevas organizaciones a través de una importación de archivo CSV durante la etapa beta. Si necesita realizar una importación de archivo CSV para actualizar las organizaciones existentes, deberá usar la página Centro de administración > Personas > Acciones masivas > Importar organizaciones. También puede usar esta página para crear nuevas organizaciones. Recibirá un correo electrónico cuando finalice la importación.

Para actualizar organizaciones con una importación de archivo CSV

1. En el Centro de administración, haga clic en Personas en la barra lateral y luego seleccione Acciones masivas > Importar organizaciones.
2. 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. Solo es necesario incluir en el archivo los campos que se desean actualizar. Las columnas de datos vacías sobrescribirán los datos existentes para esa organización.

3. Haga clic en Elegir archivo o en el vínculo Permitirme más bien pegar datos.
4. Haga clic en Importar.

   Una vez iniciada la importación, los cambios importados no se pueden revertir.

5. (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 de la página Importador de datos.