Cómo gestionar traducciones de forma masiva con CSV
Debes tener una cuenta pagada de Klaviyo y la Traducción inteligente habilitada para usar esta función.
Administra las traducciones fuera de Klaviyo exportando y editando un archivo CSV, y luego impórtalo de nuevo para actualizar las traducciones en lote o colaborar con otras personas.
Exportar un CSV de tus traducciones
Sigue estos pasos para exportar las traducciones actuales de un solo mensaje:
- Abre el mensaje que quieras actualizar (correo electrónico de campaña, correo electrónico de flujo, SMS, mensaje de WhatsApp, etc.).
- Haz clic en el ícono o botón Traducir del mensaje, o en el botón que muestra el número de traducciones, para abrir el editor de traducción. Si el mensaje aún no se ha traducido, primero completa la configuración de idioma.
- En el editor de traducción, abre el menú de acciones de 3 puntos y haz clic en Exportar.

- En Seleccionar formato de exportación, selecciona CSV. Mantén seleccionada la opción Compatible con Smartling si vas a enviar el archivo a Smartling, o desmárcala para editar un CSV estándar en una hoja de cálculo.

- En Idiomas para exportar, elige Seleccionar todo para incluir todos los idiomas de traducción existentes, o Selección personalizada para elegir idiomas específicos. Para exportar solo el texto de origen para un traductor, elige la opción de solo idioma de origen. El idioma de origen se incluye en todas las exportaciones.
- Haz clic en Exportar para descargar el CSV.
CSV de Smartling
Un CSV compatible con Smartling incluye:

Directivas de Smartling en la parte superior del archivo, incluidas:
# smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE
- block_id – el identificador único de cada cadena traducible en este mensaje.
- Código de idioma de origen (p. ej., en): el texto original de origen para esa cadena.
- Columnas de idioma para los idiomas de traducción que seleccionaste, si corresponde.
Puedes usar este archivo tal como está para importar tus cadenas a Smartling. Smartling analiza automáticamente el CSV, extrae las cadenas y te permite activar trabajos de traducción.
Cuando termine el trabajo, descarga el CSV traducido. Antes de importarlo en Klaviyo, elimina cualquier fila de directivas # smartling. inicial para que la primera fila contenga los encabezados de columna. Mantén la columna block_id, la columna del idioma de origen y al menos 1 columna de idioma de traducción compatible. Luego, sigue la sección Importar el CSV que aparece a continuación.
CSV Standard
Un CSV estándar incluye:

- block_id – el identificador único de cada cadena traducible en este mensaje.
- source – el texto de origen original de esa cadena.
- Columnas de idioma: 1 columna por idioma de traducción que seleccionaste, nombrada con su código de idioma (por ejemplo, en, fr, es-MX). Una exportación solo de origen no tiene columnas de idioma de traducción.
Ahora puedes abrir este archivo en Excel, Google Sheets u otro editor de hojas de cálculo.
Actualiza el CSV
Cuando edites el CSV, solo necesitas trabajar en las columnas de idioma.
No edites, agregues ni elimines valores en la columna block_id. Si una fila tiene un block_id no válido o faltante, esa fila se ignora durante la importación y sus traducciones no se actualizan.
Lo que puedes cambiar de forma segura
En el CSV:
- Actualiza las traducciones existentes editando la columna del idioma correspondiente.
- Agrega las traducciones faltantes completando las celdas vacías de una columna de idioma.
- Deja sin cambios los valores de un idioma si no quieres actualizar ese idioma.
- Añade una o más nuevas columnas de idioma:
- Usa un código de idioma BCP-47 válido (por ejemplo, fr-CA, de, ca).
- Durante la importación, los idiomas compatibles con nuevos valores de traducción se agregan al editor de traducciones de este mensaje.
Lo que no debes cambiar
Evita lo siguiente:
- No edites ni elimines valores de block_id.
- No agregues filas. Cada fila debe seguir asignándose a una cadena traducible existente en el mensaje.
- No cambies los valores de origen en el CSV:
- Para cambiar el contenido de origen, edita el mensaje directamente en el editor de Klaviyo y luego exporta un CSV nuevo.
- Mantén los encabezados de columna
block_idy de origen sin cambios. En un CSV de Smartling, mantén el encabezado de columna del idioma de origen en lugar de "source". Mantén cada columna del idioma de traducción etiquetada con el código de idioma compatible. - No cambies el formato del archivo:
- Mantén el archivo como un archivo .csv de formato .csv.
- Guárdalo con la codificación UTF‐8.
Mantén las etiquetas de plantilla y las etiquetas de plantilla, como {{ first_name }} y {% if ... %}, sin cambios en cada traducción. Si estos marcadores de posición difieren del mensaje de origen, la validación bloquea la importación.
Cómo manejar las celdas vacías
Si borras el contenido de una celda de traducción en el CSV y la dejas vacía:
- La importación trata esa cadena vacía como un valor.
- La traducción existente para esa celda se sobrescribe con un valor vacío. Esto puede eliminar una traducción de forma efectiva.
Si al borrar una celda también se eliminan marcadores de posición presentes en el origen, la validación bloquea la importación. Restaura los marcadores de posición o elimina esa columna de idioma antes de importar.
Si quieres evitar cambiar una traducción, deja su valor actual en el CSV o elimina por completo esa columna de idioma antes de importar.
Cuando termines de editar, guarda el archivo como un .csv con codificación UTF‐8.
Importar el CSV
Después de actualizar y guardar el CSV:
- Regresa al editor de traducción para el mismo mensaje.
- Abre el menú de acciones de 3 puntos y haz clic en Importar CSV.
- En el modal de importación, haz lo siguiente:

- Haz clic en Seleccionar archivo y elige el CSV, o
- Arrastra y suelta el archivo CSV en el área de carga.
- Haz clic en Siguiente para validar el archivo y previsualizar los cambios.
Klaviyo ejecuta una "prueba en seco" de validación y muestra:

- Un resumen de cuántas filas se actualizarán, no cambiarán o se ignorarán
- Cualquier advertencia o error que haya detectado
- Revisa cuidadosamente el resumen y las advertencias.
- Si todo se ve correcto, haz clic en Importar para aplicar los cambios.
Cuando la importación se realiza correctamente, el modal se cierra y las traducciones se actualizan en el editor de traducciones. Revisar las traducciones importadas.
Durante la validación, Klaviyo también revisa lo siguiente:
- Tipo de archivo y codificación: usa un CSV codificado en UTF-8.
- Columnas CSV: conserva
block_id, la columna de origen (o la columna en el idioma de origen para Smartling), y al menos 1 columna compatible con el idioma de traducción. - Códigos de idioma que el canal no reconoce o no admite.
- Valores de traducción vacíos y otros posibles problemas.
- Etiquetas de plantilla y etiquetas de plantilla de Personalization que difieren del mensaje de origen.
Si la validación falla, verás un mensaje de error. Haz clic en Seleccionar archivo nuevo después de corregir el CSV para intentarlo de nuevo; la validación no cambia las traducciones.
Entiende los resultados de la importación
Después de la validación, el resumen de importación muestra lo que ocurrirá si continúas.
Recuento de resumen
El resumen puede incluir recuentos como:
- Actualizadas: el número de filas en las que cambiará al menos 1 valor de traducción.
- Omitidas (sin cambios): filas del CSV en las que todos los valores de traducción incluidos coinciden con los que ya están almacenados.
- Ignoradas: filas que no se importarán, como filas duplicadas después de la primera aparición o filas cuyo
block_idno existe en este mensaje.
Los conteos se calculan por fila, no por idioma. Por ejemplo, si un CSV tiene 2 filas y 2 columnas de idioma:
- Si se actualiza 1 fila en 1 idioma, el conteo de Actualizado es 1.
- Si se actualiza 1 fila en ambos idiomas, el conteo de Actualizadas sigue siendo 1.
- Si ambas filas se actualizan en 1 o en todos los idiomas, el recuento de Actualizadas es 2.
Mejores prácticas
Para mantener los datos de traducción precisos y fáciles de administrar:
- Empieza con la exportación más reciente. Evita reutilizar CSV antiguos, especialmente después de cambiar el contenido o los idiomas del mensaje.
- Guarda una copia de respaldo de cada exportación. Guarda una copia del CSV antes de hacer cambios para que puedas volver atrás si es necesario.
- Coordina con los traductores. Explica qué columnas pueden editar (solo las columnas de idioma) y qué columnas no deben cambiar (block_id, source).
- Trabaja en lotes más pequeños si es necesario. Si el archivo es muy grande, considera dividir el trabajo en varios mensajes o ejecutar varias importaciones más pequeñas.
- Usa códigos de idioma compatibles. Al agregar nuevas columnas de idioma, usa códigos BCP-47 compatibles del artículo Traducción inteligente para evitar idiomas “unprocessable”.
Resuelve las advertencias de validación y los errores de importación
Si ves advertencias o errores durante la validación de la importación, revisa las secciones a continuación para entender qué significan y cómo corregirlos.
"Faltan columnas obligatorias."
Qué significa: Falta la columna block_id o se cambió el nombre, o el CSV empieza con filas de directivas en lugar de los encabezados de columna.
Qué hacer: Comienza con los encabezados de columna de la exportación original y mantén block_id sin cambios. Elimina cualquier fila de directiva de Smartling al inicio antes de importar. Conserva el origen (o la columna de idioma de origen de Smartling) para que las traducciones importadas sigan asociadas al contenido de origen correcto.
"Tienes valores de traducción vacíos. Las cadenas vacías se tratarán como valores."
Qué significa: El CSV tiene valores de traducción vacíos, y las cadenas vacías se tratarán como valores.
Qué hacer: Si continúas, esas celdas vacías sobrescriben cualquier traducción existente para esa clave y ese idioma. Si quieres dejar esas traducciones sin cambios, restaura los valores anteriores o elimina la columna de ese idioma y vuelve a importar el archivo.
"La(s) clave(s) <count> no existe(n) en el proyecto y no se incluirá(n) en la importación."
Qué significa: Algunos valores de block_id en el CSV no existen para esta plantilla (por ejemplo, si los valores de block_id se editaron manualmente).
Qué hacer: esas filas se ignoran y las traducciones de esas claves no cambian. Para resolver esto, elimina esas filas del CSV o exporta un archivo nuevo si es necesario.
"El archivo contiene claves duplicadas con valores en conflicto. Se utilizará el primer valor."
Qué significa: Dos o más filas de tu CSV tienen los mismos valores de block_id (por ejemplo, si las filas se duplicaron por error).
Qué hacer: Se usan los valores de la primera fila y se ignoran las filas duplicadas restantes. Para resolver esto, elimina las filas duplicadas del CSV o exporta un archivo nuevo si es necesario.
"Varias columnas corresponden al mismo idioma. Solo se utilizará la última columna y las demás se ignorarán."
Lo que significa: Dos o más columnas de tu CSV tienen el mismo código de idioma o se resuelven en el mismo idioma (por ejemplo, si una columna de idioma se duplicó por error).
Qué hacer: se usan los valores de la última columna duplicada y se ignoran las demás columnas duplicadas. Para resolverlo, elimina las columnas duplicadas del CSV o exporta un archivo nuevo si es necesario.
"Tu archivo contiene columnas con códigos de idioma que no son compatibles con este canal: <invalid language code>. " "Se omitirán, pero se importarán las configuraciones regionales válidas."
Qué significa: Un encabezado de columna en tu CSV usa un código de idioma que no se admite o no se reconoce.
Qué hacer: Para agregar un nuevo idioma, usa uno de los códigos BCP-47 compatibles de la documentación de Traducción inteligente. Se ignoran las columnas con códigos no compatibles.
"Hay idiomas en tu archivo que no están en tu proyecto. Los siguientes idiomas se añadirán a tu editor de traducción: <language detected>."
Qué significa: El CSV incluye columnas de idioma que actualmente no forman parte de esta plantilla.
Qué hacer:
- Para agregar esos idiomas, incluye un nuevo valor de traducción en la columna de cada idioma, revisa la lista y haz clic en Importar para agregarlos al editor de traducciones.
- Si no quieres agregarlas, elimina esas columnas y vuelve a importar el archivo.
"No se encontraron columnas de configuración regional."
Lo que significa: El CSV incluye las columnas block_id y source, pero no se detectó ningún otro encabezado de columna.
Qué hacer: agrega al menos una columna de idioma compatible y vuelve a intentarlo.
"No se encontraron columnas de configuración regional válidas."
Qué significa: El CSV incluye las columnas block_id y source, pero no hay columnas de idioma válidas.
Qué hacer: agrega al menos una columna de idioma compatible y vuelve a intentarlo.
"Algunas traducciones contienen discrepancias en los marcadores de posición. Asegúrate de que todos los marcadores de posición del texto original se conserven en las traducciones."
Qué significa: una traducción tiene etiquetas de plantilla faltantes, modificadas o adicionales en comparación con el mensaje de origen.
Qué hacer: Restaura los marcadores de posición del mensaje de origen en las traducciones afectadas, luego guarda el archivo CSV y selecciona el archivo corregido. La importación no puede continuar hasta que los marcadores de posición coincidan.
Si solo ves advertencias y entiendes su impacto, puedes continuar con la importación. Si ves un error, debes corregir el CSV y volver a subirlo antes de continuar. Si sigues viendo errores, exporta un CSV nuevo desde el editor de traducción, haz cambios mínimos e intenta otra importación para aislar el problema.
Recursos adicionales
- Cómo habilitar la Traducción inteligente
Descubre cómo habilitar la Traducción inteligente para los mensajes, para que puedas enviar campañas y flujos en varios idiomas según las preferencias de idioma de tu audiencia. Klaviyo puede traducir el contenido de los correos electrónicos a más de 60 idiomas.
- Cómo crear una campaña de correo electrónico multilingüe con Traducción inteligente
Aprende a crear y enviar una campaña de correo electrónico en varios idiomas, según las preferencias de idioma de tu audiencia. Klaviyo puede traducir el contenido de una campaña a más de 60 idiomas.
- Cómo crear una campaña de SMS multilingüe con Traducción inteligente
Aprende a crear y enviar una campaña de SMS en varios idiomas, según las preferencias de idioma de tu audiencia. Klaviyo puede traducir el contenido de una campaña a más de 60 idiomas.
- Cómo personalizar el contenido en función del idioma
Aprende a recopilar el idioma preferido de una persona y luego dirígete a ella en ese idioma.