Google Translate

¡Bienvenido al componente Google Translate! 🌍

Este componente es tu puente directo hacia la tecnología de Google para trabajar con idiomas en tus automatizaciones. Puedes usarlo para traducir mensajes, documentos o contenido web entre más de 130 idiomas, detectar el idioma original de un texto o incluso obtener listas de idiomas soportados.

Es perfecto si necesitas:

Traducir correos, mensajes de chat o datos de formularios.
Detectar en qué idioma está escrito un texto automáticamente.
Preparar contenido para que sea entendido por usuarios de todo el mundo.

¿Cómo funciona?

El componente se conecta de forma segura a Google Cloud Translation API. Esto significa que cuando lo usas en Nappai, envías automáticamente la información a los servidores de Google, que son expertos en entender y traducir textos de forma muy precisa.

Una vez que Google procesa tu texto, el componente recibe el resultado y te lo entrega listo para usar en el siguiente paso de tu flujo. Todo este proceso es automático, rápido y transparente para ti.

Además, el componente cuenta con una función especial llamada Modo de Mapeo que te permite traducir muchas frases a la vez con un solo clic, en lugar de una por una.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en Nappai para poder interactuar con Google y acceder a la API de traducción.

Sigue estos pasos para configurarlo correctamente:

Dirígete a la sección de Credenciales en tu panel de Nappai.
Crea una nueva credencial del tipo Google Translate y guarda los campos requeridos (como tu Google Api Key).
Una vez creada la credencial, regresa a tu flujo de trabajo. En el campo Credential de este nodo, selecciona la credencial que acabas de guardar.

💡 Nota: Si no tienes una clave de API de Google, tendrás que generarla en la consola de Google Cloud antes de completar este paso.

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado Modo de Mapeo. Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

Fixed (Fijo): Escribes el valor directamente en el campo.
Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados, ideal para procesar listas de datos o tomar decisiones basadas en el contenido.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Text: El texto que deseas traducir o analizar. Este campo es obligatorio y puede recibir frases cortas o listas completas de texto.
- Visible en: Todas las configuraciones básicas.
Target Language: El idioma al que quieres traducir el texto. Se selecciona desde una lista desplegable usando códigos ISO (por ejemplo, ‘es’ para español, ‘en’ para inglés, ‘fr’ para francés).
- Visible en: Todas las configuraciones básicas.
Format: El formato del texto de entrada. Permite elegir entre “text” (texto plano) o “html” (si estás traduciendo código de páginas web o contenido enriquecido).
- Visible en: Todas las configuraciones básicas.

Salidas

Al ejecutar este componente, obtendrás resultados que puedes utilizar en pasos posteriores de tu automatización.

Data: Contiene el resultado de la operación. Dependiendo de lo que hayas solicitado, este dato incluirá el texto traducido, el idioma detectado y la confianza de la detección. Puedes usar Data para conectar con otros componentes, guardar registros o enviar mensajes.

Ejemplo de Respuesta JSON

A continuación, verás un ejemplo de cómo se estructura la información que devuelve el componente al ejecutarse con éxito. Esto te ayudará a saber qué variables puedes mapear en los siguientes nodos del flujo: json { “data”: { “translatedText”: “Hola, esto es una traducción de ejemplo.”, “detectedSourceLanguage”: “en”, “confidence”: 0.99 } }

En este ejemplo:

translatedText: Es el texto traducido.
detectedSourceLanguage: Muestra el idioma original detectado.
confidence: Indica qué tan seguro está el sistema de la traducción (0.99 significa alta confianza).

Conectividad

Este componente suele funcionar como un “traductor” dentro de tu flujo. Lógicamente:

Entradas: Recibe texto desde disparadores (como nuevos correos o mensajes), desde transformadores de datos o desde pasos donde se captura información del usuario.
Salidas: Conecta su salida Data a componentes de envío (como Gmail o Slack), a bases de datos para guardar traducciones, o a lógicas condicionales que dependan del idioma detectado.

Es especialmente útil antes de guardar datos en un CRM o al enviar respuestas automatizadas a clientes internacionales.

Ejemplo de Uso

Escenario: Traducción automática de comentarios de clientes.

Imagina que recibes muchos comentarios en un formulario web y quieres entenderlos todos, pero están en distintos idiomas.

El flujo recibe la lista de comentarios.
Activas el Modo de Mapeo y conectas la lista de comentarios al campo Text.
En Target Language, seleccionas “es”.
El componente traduce todos los comentarios al español y devuelve los resultados en Data.
Un siguiente paso guarda esos comentarios traducidos en tu base de datos para que el equipo de soporte pueda leerlos.

Consejos y Mejores Prácticas

Códigos de idioma: Asegúrate de seleccionar códigos ISO válidos en Target Language. Si no estás seguro, puedes probar con el código de tu idioma nativo (ej. ‘es’ para español).
Uso en lote: Si necesitas traducir muchas frases, utiliza el Modo de Mapeo. Te ahorrará tiempo y mantendrá tu flujo más limpio.
Validación de texto: El campo Text es sensible al formato. Si traduces HTML, verifica que el código esté limpio para evitar errores de traducción.
Revisión de resultados: Aunque la traducción es muy precisa, para textos muy críticos siempre es buena idea revisar la salida Data manualmente la primera vez que configuras un flujo.

Consideraciones de Seguridad

Protección de Claves: Tu Google Api Key es confidencial. Asegúrate de no compartirla públicamente y de almacenarla solo en las Credenciales seguras de Nappai.
Limites de Uso: Google puede aplicar límites de tasa o cuotas en su API. Si tu automatización procesa un volumen muy alto de texto, verifica la documentación de Google para evitar interrupciones.
Contenido Sensible: Recuerda que el texto enviado a la API de Google es procesado por sus servidores. No utilices este componente para traducir información confidencial o personal que no deba salir de tu entorno.