# Localización (/es/guides/localization)

Las cadenas que Bitelio mismo renderiza — el pie de página de baja que añade a los correos de marketing, más las páginas alojadas de baja, suscripción y preferencias — pueden servirse en los idiomas de tus contactos. Lo que Bitelio nunca toca es el contenido de tus propias plantillas: los asuntos y el texto del cuerpo **no** se traducen automáticamente, y permanecen totalmente bajo tu control.

## Establecer el idioma por defecto del proyecto

En **Ajustes → Proyecto**, elige un idioma por defecto. Los contactos sin un idioma propio registrado usan este.

## Sobrescribir por contacto

Para dar a un destinatario individual un idioma distinto, escribe un campo `locale` en el `data` del contacto:

```bash
curl -X POST https://api.bitelio.com/v1/track \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "event": "signed_up",
    "data": { "locale": "fr" }
  }'
```

El valor debe ser un código [BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) / ISO 639 de la lista de compatibilidad de abajo. El campo también está disponible como `{{locale}}` en variables de plantilla, así que puedes ramificar tu propio contenido a partir de él.

Cuando el `locale` de un contacto no está entre los idiomas compatibles, toma el control el idioma por defecto del proyecto; cuando ninguno está establecido, todo se renderiza en inglés.

## Idiomas compatibles

| Código  | Idioma                         |
| ------- | ------------------------------ |
| `en`    | Inglés                         |
| `nl`    | Neerlandés (Nederlands)        |
| `fr`    | Francés (Français)             |
| `de`    | Alemán (Deutsch)               |
| `es`    | Español (Español)              |
| `it`    | Italiano (Italiano)            |
| `pt`    | Portugués (Português)          |
| `pl`    | Polaco (Polski)                |
| `cs`    | Checo (Čeština)                |
| `bg`    | Búlgaro (Български)            |
| `hi`    | Hindi (हिंदी)                  |
| `zh-CN` | Chino (simplificado, China)    |
| `zh-TW` | Chino (tradicional, Taiwán)    |
| `zh-HK` | Chino (tradicional, Hong Kong) |

## Qué se traduce

| Superficie                                            | ¿Se traduce?                                                  |
| ----------------------------------------------------- | ------------------------------------------------------------- |
| Pie de página de baja en correos de marketing         | Sí                                                            |
| Páginas alojadas de baja / suscripción / preferencias | Sí                                                            |
| **El asunto y cuerpo de tus propias plantillas**      | No — crea plantillas por idioma y ramifica sobre `{{locale}}` |

## Traducir tus propias plantillas

El contenido de las plantillas es tuyo para localizar. Dos enfoques son comunes:

* **Una plantilla separada por idioma**, seleccionada por tu código o tu flujo de trabajo antes de disparar el envío. Un sufijo de idioma en el nombre (`welcome-en`, `welcome-fr`) las mantiene organizadas.
* **Una única plantilla que ramifica internamente**, usando condicionales de Handlebars sobre `{{locale}}` para incrustar cada variante de idioma. Funciona bien para unas pocas cadenas cortas; se vuelve tedioso cuando los correos se alargan.

Cuando hay mucho que localizar, una plantilla por idioma se mantiene manejable durante mucho más tiempo.