-
Planes Business y Enterprise (no disponibles para planes LSP)
Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.
-
Plan Enterprise (anterior)
Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.
Consejo
Para obtener información sobre la integración de Contentful en Phrase Strings, consulta Contentful (Strings).
Contentful proporciona una infraestructura de gestión de contenido headless para crear, gestionar y distribuir contenido a cualquier plataforma o dispositivo. Phrase se integra con Contentful de dos maneras:
-
A través de un conector de Contentful dedicado (2.0, a nivel de entrada, a nivel de campo)
El conector Contentful 2.0 actualmente solo admite la autenticación a través del centro de datos de EE. UU.
-
A través del plugin de Contentful Marketplace para una experiencia personalizada
Nota
El conector no admite la traducción de objetos JSON.
Métodos de localización admitidos
Contentful admite múltiples métodos de localización. Consulta la documentación de Contentful para obtener una descripción detallada.
El conector Contentful 2.0 es la integración actual y preferida que admite la localización a nivel de campo. También ofrece:
-
Espacios múltiples
-
Alias de entorno
-
Configuración de URL de vista previa
-
Importación de referencias
-
Filtrado de contenido basado en etiquetas
-
Configuración de vista previa en vivo
Localización a nivel de entrada (heredada)
Utiliza el conector Contentful (Entry-Level).
El conector a nivel de entrada solo funciona con tipos de contenido que tienen campos de referencia localizados (por ejemplo, un campo de referencia llamado Localized que está habilitado para la localización).
Localización a nivel de campo (heredada)
Utiliza el conector Contentful (Field-Level).
El conector a nivel de campo solo funciona con tipos de contenido que tienen un campo traducible (por ejemplo, un campo de texto o de texto enriquecido con la localización habilitada) y, opcionalmente, recursos multimedia. Importa entradas referenciadas y sus campos traducibles (si los campos de referencia están localizados).
Importante
Los conectores heredados quedarán obsoletos el 30 de noviembre de 2026. Se pueden crear nuevas instancias de estos conectores hasta el 17 de agosto de 2026. Migra al nuevo conector antes de la fecha de obsolescencia.
Consulta Legacy Connector Deprecation para obtener una guía de migración completa.
Hay varios casos prácticos del conector:
-
Los project managers pueden agregar archivos directamente a los proyectos desde un repositorio en línea. El contenido se puede buscar por ID de entrada.
-
Configura el portal de remitentes para que los remitentes puedan agregar archivos a las solicitudes directamente desde el repositorio en línea. El contenido se puede buscar por ID de entrada.
-
Usa la creación automática de proyectos (APC) para que se creen nuevos proyectos automáticamente cuando se detecte un cambio en el tamaño del contenido de los documentos supervisados o de una carpeta supervisada.
Casos de uso para la aplicación:
-
Los editores de contenido pueden enviar directamente una entrada para su localización desde Contentful. Esto permite que los editores o gestores de contenido tengan un control total sobre el flujo de localización y reciban actualizaciones de estado sobre la marcha al ver una entrada.
Una vez que la entrada se haya finalizado:
-
Selecciona los idiomas de destino deseados para la localización.
-
Envía solo la entrada con los idiomas seleccionados a Phrase TMS o usa la pestaña Selección de campos para seleccionar los campos.
-
Si no se selecciona ningún campo, todos los campos localizables se envían para su traducción.
-
Si se selecciona un campo no localizable, ese campo seguirá sin enviarse para su traducción. Solo se envían los campos localizables.
-
Si solo se seleccionan algunos campos localizables, solo esos campos se enviarán para su traducción.
-
-
Según la configuración de APC, los trabajos se crean automáticamente a partir del contenido enviado. Durante las ejecuciones de APC, solo se seleccionan para la creación de trabajos las entradas en estado enviado.
-
Una vez creados los trabajos a partir de una entrada enviada, el estado cambia a en curso. Cuando las traducciones se envían de vuelta a Contentful, el estado cambia a completado.
-
Las entradas traducidas anteriormente pueden volver a enviarse tras realizar cambios en el texto original.
-
-
Los editores de contenido pueden utilizar la pantalla de inicio de Phrase TMS para:
-
Enviar entradas de forma masiva.
-
Especificar idiomas de destino individuales al realizar envíos masivos.
-
Tener una visión general de los trabajos de traducción activos.
-
Configuración de Contentful
Al trabajar con la aplicación Phrase TMS:
-
Descarga la aplicación Phrase TMS desde el marketplace.
-
Instala la aplicación en el espacio activo actual y selecciona los modelos de contenido en los que debe instalarse.
-
Introduce el token de autenticación de Phrase TMS obtenido al crear el conector en Phrase TMS.
-
Haz clic en Instalar.
Opcional: Launch App (declarada obsoleta por Contentful)
Si utilizas los flujos de trabajo mediante Launch App de Contentful, sigue estos pasos:
-
Instala la aplicación Launch de Contentful en uno o más espacios.
Nota
Solo se puede crear un flujo de trabajo por espacio. Si necesitas distintos enfoques para los tipos de contenido dentro de un mismo espacio de Contentful, ponte en contacto con el responsable de éxito del cliente asignado.
-
Configura el flujo de trabajo de localización necesario.
-
Selecciona el tipo o los tipos de contenido que siguen el flujo de trabajo descrito.
Si los flujos de trabajo están configurados en un conector, la creación automática de proyectos (APC) creará nuevos proyectos cuando se detecte un cambio en los pasos del flujo de trabajo de los artículos o tipos de contenido supervisados.
Los trabajos enviados pueden cancelarse, lo que permite volver a enviar el contenido después de realizar cambios. Estos trabajos seguirán existiendo en Phrase y deberán ser eliminados por un gestor de proyectos.
Nota
La aplicación Contentful Launch no es compatible con el conector 2.0.
-
En la página Configuración
, desplázate hacia abajo hasta la sección .
-
Haz clic en Conectores.
Se abrirá la página .
-
Haz clic en Nuevo conector.
Se abrirá la página .
-
Cambia el Tipo a Contentful 2.0.
-
Dale un nombre al conector.
-
Haz clic en Conectar a Contentful 2.0.
Se abre la ventana de inicio de sesión de Contentful.
-
Introduce los datos de inicio de sesión y haz clic en Iniciar sesión (o utiliza otros métodos de inicio de sesión). La ventana de inicio de sesión se cierra y se muestra .
-
Si utilizas el conector con la aplicación, marca la casilla Phrase Contentful App.
-
Haz clic en Generar token.
Se abre la ventana .
-
Haz clic en Generar token.
Se genera un token que debe copiarse al portapapeles o a un archivo de texto. Asegúrate de copiar el token antes de cerrar la ventana, ya que no volverá a mostrarse. Este token se utilizará al conectarte a la aplicación.
-
Cierra la ventana y se mostrará .
-
-
Si utilizas Etiquetas de Contentful para identificar contenido traducible, introduce un ID de etiqueta y pulsa Intro.
El ID se presenta y se pueden añadir más. Las etiquetas pueden utilizarse para limitar qué contenido de Contentful es visible para el conector.
-
Si es necesario, selecciona .
-
Si es necesario, selecciona (contenido anidado).
Se muestran los . Aplica los filtros deseados para establecer un control más granular sobre cómo el sistema recorre las relaciones de contenido.
-
Limita hasta dónde sigue Phrase las entradas referenciadas durante la importación.
El valor predeterminado es 10.000. Si es necesario, selecciona otros valores o especifica un valor entero personalizado.
-
Selecciona si quieres detenerte al llegar a las entradas cuyo tipo de contenido coincida con la lista especificada o seguirlas.
-
Excluye las entradas cuyo tipo de contenido de la entrada principal coincida con la lista especificada.
-
Selecciona si quieres detenerte al llegar a las entradas que tengan alguna de las etiquetas de contenido especificadas o seguirlas.
-
Selecciona si quieres detenerte al llegar a las entradas a las que hacen referencia los ID de campo especificados o seguirlas.
-
-
Si es necesario, selecciona .
Se muestra el campo . Introduce un valor para habilitar la configuración de taxonomía.
-
Cuando se selecciona, el conector obtiene taxonomías de Contentful y las incluye en el archivo .XLIFF. El panel del editor CAT enumerará los valores de taxonomía de Contentful para cada segmento. Los valores de taxonomía no son contenido traducible. No se pueden enumerar, importar ni exportar como un trabajo independiente, ya sea por sí solos o junto con una entrada.
-
Si los metadatos de taxonomía no están disponibles o el conector no está configurado con ellos, el panel simplemente se omite.
-
Si un proyecto no requiere contexto de función/pantalla, se recomienda dejar la taxonomía deshabilitada para optimizar el rendimiento al exportar el archivo .XLIFF.
-
-
Si es necesario, selecciona .
El alias se utiliza para toda la supervisión de APC y las reimportaciones y exportaciones de trabajos. Si el destino del alias cambia en el futuro, APC supervisará el contenido del nuevo destino; los trabajos se reimportarán desde el nuevo destino del alias y se exportarán a él.
Seguir alias se aplica a la supervisión de APC, la reimportación de trabajos y la exportación de trabajos. También se aplica a las entradas enviadas a través de la aplicación Phrase Contentful desde una URL de alias. La aplicación registra el alias en el momento del envío, por lo que el conector encuentra estas entradas después de que cambia el destino del alias. Las entradas enviadas mientras el alias apuntaba a un entorno anterior permanecen visibles para el conector. Cada entrada se sigue exportando y reimportando al entorno desde el que se envió.
Un conector que sigue un alias no encuentra entradas enviadas desde la URL del entorno concreto en lugar de la URL del alias. Tampoco encuentra entradas enviadas a través de la aplicación antes de que se añadiera la compatibilidad con alias. Vuelve a enviar estas entradas desde Contentful a través de la URL del alias.
-
(predeterminado y recomendado)
Los APC y los trabajos creados están vinculados al entorno al que apuntaba el alias en el momento de su creación. Los APC solo supervisan ese entorno y su contenido; los trabajos se exportan y reimportan a él.
-
Los APC y los trabajos creados están vinculados al propio alias. Los APC solo supervisan ese alias y su contenido; los trabajos se exportan y reimportan a él.
Si se cambia el destino del alias, los APC supervisarán el nuevo destino del alias (entorno); los trabajos ahora se exportarán y reimportarán a él.
Para las entradas enviadas a través de la aplicación Phrase Contentful, los trabajos se exportan y reimportan al entorno desde el que se envió la entrada.
Los roles personalizados de Contentful requieren acceso directo al entorno subyacente específico al que apunta el alias, no solo al alias en sí, o el panel de la aplicación Phrase TMS no se cargará. Añade este acceso en Contentful, en , en la sección del rol. Si el alias se redirige más tarde a un entorno diferente, añade también acceso al nuevo entorno.
-
-
Si es necesario, proporciona la .
Esta es la plantilla de URL que conduce al contenido renderizado desde Contentful. Se admiten los siguientes marcadores de posición:
-
{env_id}: ID del entorno -
{entry.id}: ID de entrada -
{space_id}: ID de espacio
Una plantilla de URL puede tener este aspecto:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry_id}
Nota
La URL debe conducir a una aplicación desplegada que renderice el contenido de Contentful. Para utilizar la vista previa en vivo, reemplaza
contentfulapp.tlden la plantilla de URL por el dominio real de la aplicación.Consulta la documentación de Contentful para obtener más información sobre la configuración de la vista previa del contenido.
No se puede usar la localización como marcador de posición en estos momentos. Para utilizar la configuración regional en la URL, especifica un valor fijo y crea varias instancias de conector.
-
-
Si es necesario, utiliza para excluir campos específicos de la importación a Phrase. Indica los ContentIDs que deben omitirse de la importación.
-
Proporciona y para (obligatorio).
La API de vista previa requiere un token de acceso de Contentful llamado que debe configurarse en los ajustes de API del espacio de Contentful.
La integración de Contentful 2.0 utiliza esta API para importar contenido y supervisar cambios (APC).
-
Selecciona cada espacio y entorno que quieras supervisar o desde el que quieras importar contenido de Contentful.
-
La configuración y el acceso se gestionan dentro del propio Contentful.
-
-
Haz clic en Guardar.
El conector se añadirá a la lista de la página .
Nota
La supervisión de APC vuelve a comprobar el contenido completo de una entrada rastreada y sus referencias en cada ejecución, ya que Contentful no informa de qué configuración regional cambió. Las entradas referenciadas se obtienen individualmente en lugar de por lotes, por lo que en espacios con muchas entradas referenciadas, una sola ejecución puede generar un gran número de solicitudes a la API de vista previa y a la API de contenido de Contentful. Debido a esto, una entrada puede volver a importarse después de recibir una traducción aunque su contenido de origen no haya cambiado. En espacios de gran volumen, esto puede ralentizar las ejecuciones de APC y aumentar significativamente el uso de la API de Contentful.
Para reducir este impacto:
-
Elimina la etiqueta de traducción una vez que se complete una entrada y vuelve a añadirla solo si necesita una nueva traducción.
-
Limita los ajustes de solo a las entradas que necesiten traducción.
-
Utiliza la aplicación Phrase Contentful, que supervisa solo las entradas enviadas a través de ella.
Las entradas traducidas anteriormente pueden volver a enviarse tras realizar cambios en el texto original. El reenvío es manual cuando se utiliza la aplicación Phrase Contentful: un editor debe abrir la entrada en Contentful, abrir la barra lateral de la aplicación Phrase y hacer clic en Empezar de nuevo (o utilizar el reenvío masivo desde el panel de control de la aplicación) antes de que APC la detecte y actualice el texto de origen del trabajo existente. Esto difiere de los conectores de supervisión de archivos o carpetas, donde APC detecta los cambios en el contenido de origen automáticamente sin necesidad de reenvío manual.
Un conector de Contentful 2.0 pertenece a tu organización y no a un usuario individual. El token OAuth de Contentful que utiliza el conector está vinculado al usuario que lo autorizó.
Para vincular el conector a otro usuario de Contentful, elimina el token OAuth existente para que ese usuario pueda volver a autorizar el conector:
-
Con la cuenta de Contentful que creó el token, abre la página de tokens de API del espacio correspondiente (https://app.contentful.com/spaces/{space_id}/api/cma_tokens).
-
Elimina el token llamado "Memsource Connector". Si varios tokens comparten este nombre, confirma cuál utiliza el conector afectado antes de eliminarlo.
-
Una vez eliminado el token, el conector se desactiva hasta que el nuevo usuario lo vuelva a autorizar desde la configuración del conector en Phrase TMS.
Completa estos pasos antes de que se elimine el acceso del usuario original a Contentful, ya que, de lo contrario, es posible que el token deje de estar visible.
Importante
Si accedes desde un dominio personalizado (por ejemplo, mydomain.phrase.jp), abre una ventana de navegador en modo incógnito e inicia sesión a través de cloud.memsource.com o us.cloud.memsource.com para aplicar la autenticación requerida para la creación o el guardado del conector. Después de guardar, se puede acceder al conector a través del dominio personalizado.
-
En la página Configuración
-
Haz clic en Conectores.
Se abrirá la página .
-
Haz clic en Nuevo conector.
Se abrirá la página .
-
Cambia el Tipo a ya sea Contentful (nivel de entrada) o Contentful (nivel de campo) y asigna un nombre al conector.
-
Si vas a usar el conector con la aplicación, marca la casilla Phrase Contentful App.
-
Token de la aplicación Contentful
Genera un token de aplicación para introducirlo en la aplicación Contentful de Phrase TMS. Guarda el conector después de generar el token y copiarlo en la aplicación Contentful.
Nota
Una vez guardado, el token no puede cambiarse desde dentro de Contentful. Para actualizarlo, revoca el token desde la configuración del conector en Phrase TMS y genera uno nuevo.
-
-
Configura los ajustes independientes del idioma.
-
Idioma fuente
Selecciona un idioma de origen para sustituir el idioma predeterminado de Contentful. El conector extraerá entonces el contenido del idioma configurado en los ajustes del conector.
Ejemplo:
Si EN-US está establecido como el idioma predeterminado en Contentful, pero se requiere DE-DE como idioma de origen para la localización en un espacio o modelo de contenido específico, la configuración puede ajustarse para que el espacio (carpeta remota) extraiga contenido de DE-DE en lugar de EN-US.
Nota
No aplicable al utilizar la aplicación.
-
-
Selecciona cómo procesar el contenido anidado mediante el modo de importación de entradas. El contenido puede utilizar un campo de referencia para hacer referencia a otro contenido, lo que permite crear una jerarquía de entidades.
-
Contentful (nivel de entrada)
El conector a nivel de entrada recorre automáticamente toda la jerarquía del contenido anidado.
-
Contentful (nivel de campo)
Selecciona cómo debe importar el conector a nivel de campo el contenido anidado.
-
-
Se importa el contenido que se selecciona explícitamente al añadirlo desde el repositorio.
-
Los cambios detectados por APC se importan para su traducción.
-
-
Importar entradas referenciadas
-
El conector recorre toda la jerarquía del contenido anidado e importa todos los campos traducibles para su traducción.
-
-
-
-
Crea una lista separada por comas en Omitir campos traducibles para excluir de la importación a Phrase TMS los campos que tienen marcada la opción . Usa la siguiente estructura:
contentTypeID:fieldID.-
Selecciona Dejar campos omitidos vacíos si quieres que los campos enumerados queden vacíos. Esta configuración se aplicará a todas las entradas indicadas.
-
Selecciona Copiar origen a destino si quieres que los campos enumerados contengan los valores de origen. Esta configuración se aplicará a todas las entradas indicadas.
-
-
Selecciona si faltan datos de un campo determinado en el idioma de origen.
Si es necesario, selecciona un en la lista desplegable. Esta configuración regional de idioma se utilizará en caso de que falten datos.
Nota
No existe ninguna relación entre el idioma de reserva de Contentful y esta configuración.
-
Si es necesario, proporciona la (BETA).
Esta es la plantilla de URL que conduce al contenido renderizado desde Contentful. Se admiten los siguientes marcadores de posición:
-
{env_id}: ID del entorno -
{entry.sys.id}: ID de entrada -
{space_id}: ID de espacio
Una plantilla de URL puede tener este aspecto:
https://contentfulapp.tld/?spaceId={space_id}&environmentId={env_id}&entryId={entry.sys.id}
Nota
La URL debe conducir a una aplicación desplegada que renderice el contenido de Contentful. Para utilizar la vista previa en vivo, sustituye
contentfulapp.tlden la plantilla de URL por el dominio real de la aplicación.Consulta la documentación de Contentful para obtener más información sobre la configuración de la vista previa del contenido.
No se puede usar la localización como marcador de posición en estos momentos. Para utilizar la configuración regional en la URL, especifica un valor fijo y crea varias instancias del conector.
-
-
Si el equipo de soporte técnico solicita que se registre información de depuración, selecciona .
-
Haz clic en Conectar a Contentful.
Si la conexión tuvo éxito, aparecerá una marca de verificación en la configuración del conector. Si no es así, aparecerá un signo de exclamación rojo. Pasa el cursor sobre el icono para ver más detalles.
-
Solo para Contentful (nivel de entrada):
Establece el Idioma de origen.
Nota
Este idioma debe coincidir con la configuración regional predeterminada del espacio de Contentful, definida en los ajustes de configuración regional de Contentful.
-
Haz clic en Guardar.
El conector se añade a la lista de la página .
-
Si quieres, edita el conector para seleccionar .
-
:
El conector supervisa los artículos en la etapa seleccionada (p. ej. Traducir). El autor puede aplicar esta etiqueta a los artículos cuando estén listos para traducción.
Al importar desde Contentful:
-
El conector hace avanzar el flujo de trabajo a la etapa seleccionada (p. ej., Traducción en curso) cuando se descargan los artículos de origen.
Al exportar a Contentful:
-
El conector establece la etapa del flujo de trabajo de los artículos de origen en la seleccionada (p. ej., Traducciones completadas) cuando se exporta la traducción.
Nota
Contentful dejó de ofrecer soporte para los flujos de trabajo el 1 de junio de 2023. Ya no se ofrece soporte para su uso continuado.
-