Configura las traducciones
La pestaña Translations te permite traducir cada texto de la interfaz del asistente (textos de botones, el texto de ejemplo, el mensaje de bienvenida, los estados de error, los textos de formularios) para que los visitantes vean el asistente en su propio idioma.
Idiomas integrados
El asistente incluye de serie inglés (EN), español (ES) y catalán (CA). Detecta el idioma del navegador del visitante (a partir de navigator.language) y elige automáticamente el más parecido. Si no encuentra ninguno, usa el inglés.
Añadir un idioma nuevo
- Abre los Settings del asistente y la pestaña Translations.
- Elige Add language e introduce el código del idioma (p. ej.
FRpara francés,DEpara alemán,PTpara portugués). - Rellena los textos de la interfaz: cada clave (como
ask,welcome,placeholder) tiene un campo para tu traducción. - Guarda.
Tus traducciones sobrescriben las integradas, así que también puedes personalizar el texto en inglés: por ejemplo, cambiar el botón de enviar de "Ask" a "Send" o el texto de ejemplo de "Ask a question" a algo propio de tu marca.
Claves de traducción
Cada texto de la interfaz se referencia con una clave. Esta es la lista completa de claves integradas, su valor por defecto en inglés y dónde aparecen en el asistente:
Interacción principal:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
placeholder | "Ask a question" | El texto gris de ejemplo dentro del campo de mensaje. |
ask | "Ask" | El texto del botón de enviar. |
search | "Search" | El texto de la acción de búsqueda (modo overlay). |
searching | "Searching..." | Se muestra mientras el asistente genera una respuesta. |
noResults | "Sorry, I couldn't find what you're looking for." | Se muestra cuando el asistente no encuentra contenido que coincida. |
sorry | "Sorry, we are unable to answer at this moment." | Se muestra ante un error inesperado. |
Bienvenida e identidad:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
welcome | (vacío: usa el mensaje de bienvenida de los ajustes General) | El saludo que se muestra al abrir el chat. |
description | (vacío: usa la descripción de los ajustes General) | El subtítulo bajo el título del asistente. |
Referencias y reacciones:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
references | "Sources" | El título sobre las tarjetas de referencia de una respuesta. |
copy | "Copy" | Tooltip del botón de copiar al portapapeles. |
copied | "Copied to clipboard" | Confirmación después de copiar. |
like | "Like" | Tooltip del botón de reacción de pulgar arriba. |
dislike | "Dislike" | Tooltip del botón de reacción de pulgar abajo. |
Controles de la ventana:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
close | "Close" | Tooltip del botón de cerrar. |
expand | "Expand" | Tooltip del botón de ampliar. |
collapse | "Collapse" | Tooltip del botón de plegar. |
clear | "Clear conversation" | Tooltip del botón de borrar el historial. |
Formularios:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
showForm | "Open form" | El botón que abre un formulario de captación de leads. |
submitForm | "Submit" | El botón de enviar del formulario. |
formSubmitted | "Your form has been submitted." | Confirmación después de enviar un formulario. |
Adjuntos:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
attachFile | "Attach file" | Tooltip del botón de adjuntar fichero. |
attachedFile | "Attached file:" | Texto que se muestra junto a un fichero adjunto. |
removeAttachment | "Remove attachment" | Botón para quitar un adjunto en cola. |
processingAttachment | "Processing attachment..." | Se muestra mientras se procesa un fichero. |
Pie:
| Clave | Por defecto (EN) | Dónde aparece |
|---|---|---|
poweredBy | "Powered by" | El texto de atribución del pie. |
contactUs | "Contact us" | La acción de contacto del pie. |
Cómo funcionan las traducciones en las plantillas
Dentro de las plantillas Liquid del asistente, cada texto traducible se referencia con el filtro t:
{{ 'key' | t: 'Fallback text' }}El filtro busca la clave en el idioma del visitante. Si la clave tiene traducción, se usa; si no, se muestra el texto alternativo (el segundo parámetro).
Por ejemplo, en la plantilla de la barra de búsqueda:
<textarea placeholder="{{ 'placeholder' | t: 'Ask a question' }}"></textarea>
<button>{{ 'ask' | t: 'Ask' }}</button>Y en la plantilla de respuesta, el título de las fuentes y los botones de reacción:
<span>{{ 'references' | t: 'Sources' }}</span>
<button title="{{ 'like' | t: 'Like' }}">...</button>
<button title="{{ 'dislike' | t: 'Dislike' }}">...</button>Claves de traducción personalizadas
Puedes añadir tus propias claves además de la lista integrada. Si añades una clave llamada customGreeting en la pestaña Translations, puedes usarla en una sobrescritura de plantilla:
{{ 'customGreeting' | t: 'Hello!' }}Esto es útil para los usuarios de Enterprise que sobrescriben plantillas y necesitan textos traducibles en su marcado personalizado.
Consejos
- Empieza por los textos que más ven los visitantes:
placeholder,ask,noResultsyreferences. - Prueba cada idioma cambiando el idioma de tu navegador y recargando la página.
- No hace falta traducir todas las claves: las que no estén traducidas usan el valor integrado de ese idioma o el inglés.
- Las traducciones cubren la interfaz (botones, textos, textos de ejemplo), no las respuestas: el idioma de las respuestas del asistente se controla con las instrucciones de comportamiento.
Solución de problemas
- Si un texto se queda en el idioma por defecto, probablemente su clave de traducción está vacía: abre la pestaña Translations y rellénala.
- Evita añadir dos veces el mismo código de idioma: los duplicados pueden provocar un comportamiento impredecible.
- El idioma se detecta a partir del navegador del visitante, no de su ubicación. Para forzar un idioma, defínelo en la integración mediante una sobrescritura de plantilla.