> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Idiomas admitidos para plantillas de WhatsApp

> Elige un código de idioma admitido por Meta cuando crees, gestiones o envíes una plantilla de WhatsApp.

## Qué es

Cada plantilla de WhatsApp tiene un código de idioma. El código identifica el idioma y, cuando corresponda, la configuración regional del contenido de la plantilla.

Use el mismo código cuando cree, recupere, edite, elimine o envíe esa plantilla localizada. Por ejemplo, use `en_US` para inglés (EE. UU.) y `pt_BR` para portugués (Brasil).

## Antes de comenzar

* Elige el idioma que coincida con el contenido de la plantilla.
* Usa un código regional cuando Meta proporcione uno para la configuración regional prevista.
* Mantenga el nombre de la plantilla y el código de idioma juntos en su aplicación.
* Crea y obtén la aprobación para cada plantilla localizada antes de enviarla.

<Note>
  Meta puede actualizar la lista de idiomas admitidos. Esta página refleja el
  [Referencia de idiomas admitidos por Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages),
  actualizado el 21 de mayo de 2026.
</Note>

## Cómo funciona

1. Seleccione un código de idioma admitido.
2. Establece el código en el campo `language` cuando crees la plantilla.
3. Espera hasta que se apruebe esa plantilla localizada.
4. Usa exactamente el mismo código en la administración de plantillas y en las solicitudes de mensajes.

Los códigos de idioma distinguen entre mayúsculas y minúsculas. No reemplace los guiones bajos con guiones.
Por ejemplo, envíe `zh_CN`, no `zh-CN`.

## Códigos de idioma admitidos

### A–F

| Idioma | Código |
| - | - |
| Afrikáans | `af` |
| Albanés | `sq` |
| Árabe | `ar` |
| Árabe (Egipto) | `ar_EG` |
| Árabe (Emiratos Árabes Unidos) | `ar_AE` |
| Árabe (Líbano) | `ar_LB` |
| Árabe (Marruecos) | `ar_MA` |
| Árabe (Qatar) | `ar_QA` |
| Azerbaiyano | `az` |
| Bielorruso | `be_BY` |
| Bengalí | `bn` |
| Bengalí (India) | `bn_IN` |
| Búlgaro | `bg` |
| Catalán | `ca` |
| Chino (China) | `zh_CN` |
| Chino (Hong Kong) | `zh_HK` |
| Chino (Taiwán) | `zh_TW` |
| Croata | `hr` |
| Checo | `cs` |
| Danés | `da` |
| Darí | `prs_AF` |
| Neerlandés | `nl` |
| Neerlandés (Bélgica) | `nl_BE` |
| Inglés | `en` |
| Inglés (Reino Unido) | `en_GB` |
| Inglés (Estados Unidos) | `en_US` |
| Inglés (Emiratos Árabes Unidos) | `en_AE` |
| Inglés (Australia) | `en_AU` |
| Inglés (Canadá) | `en_CA` |
| Inglés (Ghana) | `en_GH` |
| Inglés (Irlanda) | `en_IE` |
| Inglés (India) | `en_IN` |
| Inglés (Jamaica) | `en_JM` |
| Inglés (Malasia) | `en_MY` |
| Inglés (Nueva Zelanda) | `en_NZ` |
| Inglés (Catar) | `en_QA` |
| Inglés (Singapur) | `en_SG` |
| Inglés (Uganda) | `en_UG` |
| Inglés (Sudáfrica) | `en_ZA` |
| Estonio | `et` |
| Filipino | `fil` |
| Finlandés | `fi` |
| Francés | `fr` |
| Francés (Bélgica) | `fr_BE` |
| Francés (Canadá) | `fr_CA` |
| Francés (Suiza) | `fr_CH` |
| Francés (Costa de Marfil) | `fr_CI` |
| Francés (Marruecos) | `fr_MA` |

### G–N

| Idioma | Código |
| - | - |
| Georgiano | `ka` |
| Alemán | `de` |
| Alemán (Austria) | `de_AT` |
| Alemán (Suiza) | `de_CH` |
| Griego | `el` |
| Guyaratí | `gu` |
| Hausa | `ha` |
| Hebreo | `he` |
| Hindi | `hi` |
| Húngaro | `hu` |
| Indonesio | `id` |
| Irlandés | `ga` |
| Italiano | `it` |
| Japonés | `ja` |
| Canarés | `kn` |
| Kazajo | `kk` |
| Kiñaruanda | `rw_RW` |
| Coreano | `ko` |
| Kirguís (Kirguistán) | `ky_KG` |
| Lao | `lo` |
| Letón | `lv` |
| Lituano | `lt` |
| Macedonio | `mk` |
| Malayo | `ms` |
| Malayalam | `ml` |
| Maratí | `mr` |
| Noruego | `nb` |

### P–Z

| Idioma | Código |
| - | - |
| Pastún | `ps_AF` |
| Persa | `fa` |
| Polaco | `pl` |
| Portugués (Brasil) | `pt_BR` |
| Portugués (Portugal) | `pt_PT` |
| Panyabí | `pa` |
| Rumano | `ro` |
| Ruso | `ru` |
| Serbio | `sr` |
| Cingalés | `si_LK` |
| Eslovaco | `sk` |
| Esloveno | `sl` |
| Español | `es` |
| Español (Argentina) | `es_AR` |
| Español (Chile) | `es_CL` |
| Español (Colombia) | `es_CO` |
| Español (Costa Rica) | `es_CR` |
| Español (República Dominicana) | `es_DO` |
| Español (Ecuador) | `es_EC` |
| Español (Honduras) | `es_HN` |
| Español (México) | `es_MX` |
| Español (Panamá) | `es_PA` |
| Español (Perú) | `es_PE` |
| Español (España) | `es_ES` |
| Español (Uruguay) | `es_UY` |
| Suajili | `sw` |
| Sueco | `sv` |
| Tamil | `ta` |
| Telugu | `te` |
| Tailandés | `th` |
| Turco | `tr` |
| Ucraniano | `uk` |
| Urdu | `ur` |
| Uzbeko | `uz` |
| Vietnamita | `vi` |
| Zulú | `zu` |

## Solicitud

Establece `language` en uno de los códigos de la tabla al crear una plantilla.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request POST https://api.ycloud.com/v2/whatsapp/templates \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "wabaId": "WABA_ID",
    "name": "order_ready",
    "language": "en_US",
    "category": "UTILITY",
    "components": [
      {
        "type": "BODY",
        "text": "Order {{1}} is ready for pickup.",
        "example": {
          "body_text": [["A-10001"]]
        }
      }
    ]
  }'
```

## Respuesta

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "wabaId": "WABA_ID",
  "name": "order_ready",
  "language": "en_US",
  "category": "UTILITY",
  "status": "PENDING",
  "components": [
    {
      "type": "BODY",
      "text": "Order {{1}} is ready for pickup."
    }
  ]
}
```

La respuesta conserva el código de idioma enviado. Una plantilla `PENDING` debe
completar la revisión antes de que puedas usarla en una solicitud de mensaje.

## Errores comunes

* Usar la configuración regional del sitio como `en-US` en lugar del código de plantilla `en_US`.
* Enviar un código regional que no coincida con la plantilla aprobada.
* Asumir que Meta traduce el contenido de la plantilla automáticamente.
* Reutilizar un código de idioma para contenido escrito en otro idioma.

<CardGroup cols={2}>
  <Card title="Administrar plantillas" icon="rectangle-list" href="/es/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    Crea, versiona, revisa, publica y retira plantillas localizadas.
  </Card>

  <Card title="API de creación de plantillas" icon="code" href="/api-reference/whatsapp-templates/create-a-template">
    Inspecciona el esquema completo de solicitud y respuesta.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.