> ## 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 de modelo do WhatsApp suportados

> Escolha um código de idioma suportado pela Meta ao criar, gerenciar ou enviar um modelo do WhatsApp.

## O que é

Cada modelo do WhatsApp possui um código de idioma. O código identifica o idioma
e, quando aplicável, a localidade regional do conteúdo do modelo.

Use o mesmo código ao criar, consultar, editar, excluir ou enviar esse
modelo localizado. Por exemplo, use `en_US` para inglês (EUA) e `pt_BR` para
português (Brasil).

## Antes de começar

* Escolha o idioma correspondente ao conteúdo do modelo.
* Use um código regional quando a Meta disponibilizar um para a localidade desejada.
* Mantenha o nome do modelo e o código de idioma juntos na sua aplicação.
* Crie e obtenha aprovação para cada modelo localizado antes de enviá-lo.

<Note>
  A Meta pode atualizar a lista de idiomas suportados. Esta página reflete a
  [referência de idiomas suportados pela Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages),
  atualizada em 21 de maio de 2026.
</Note>

## Como funciona

1. Selecione um código de idioma suportado.
2. Defina o código no campo `language` ao criar o modelo.
3. Aguarde até que esse modelo localizado seja aprovado.
4. Use exatamente o mesmo código no gerenciamento de modelos e nas requisições de mensagens.

Os códigos de idioma diferenciam maiúsculas de minúsculas. Não substitua sublinhados por hífens.
Por exemplo, envie `zh_CN`, não `zh-CN`.

## Códigos de idioma suportados

### A–F

| Idioma | Código |
| - | - |
| Africâner | `af` |
| Albanês | `sq` |
| Árabe | `ar` |
| Árabe (Egito) | `ar_EG` |
| Árabe (Emirados Árabes Unidos) | `ar_AE` |
| Árabe (Líbano) | `ar_LB` |
| Árabe (Marrocos) | `ar_MA` |
| Árabe (Catar) | `ar_QA` |
| Azerbaijano | `az` |
| Bielorrusso | `be_BY` |
| Bengali | `bn` |
| Bengali (Índia) | `bn_IN` |
| Búlgaro | `bg` |
| Catalão | `ca` |
| Chinês (China) | `zh_CN` |
| Chinês (Hong Kong) | `zh_HK` |
| Chinês (Taiwan) | `zh_TW` |
| Croata | `hr` |
| Tcheco | `cs` |
| Dinamarquês | `da` |
| Dari | `prs_AF` |
| Holandês | `nl` |
| Holandês (Bélgica) | `nl_BE` |
| Inglês | `en` |
| Inglês (Reino Unido) | `en_GB` |
| Inglês (Estados Unidos) | `en_US` |
| Inglês (Emirados Árabes Unidos) | `en_AE` |
| Inglês (Austrália) | `en_AU` |
| Inglês (Canadá) | `en_CA` |
| Inglês (Gana) | `en_GH` |
| Inglês (Irlanda) | `en_IE` |
| Inglês (Índia) | `en_IN` |
| Inglês (Jamaica) | `en_JM` |
| Inglês (Malásia) | `en_MY` |
| Inglês (Nova Zelândia) | `en_NZ` |
| Inglês (Catar) | `en_QA` |
| Inglês (Cingapura) | `en_SG` |
| Inglês (Uganda) | `en_UG` |
| Inglês (África do Sul) | `en_ZA` |
| Estoniano | `et` |
| Filipino | `fil` |
| Finlandês | `fi` |
| Francês | `fr` |
| Francês (Bélgica) | `fr_BE` |
| Francês (Canadá) | `fr_CA` |
| Francês (Suíça) | `fr_CH` |
| Francês (Costa do Marfim) | `fr_CI` |
| Francês (Marrocos) | `fr_MA` |

### G–N

| Idioma | Código |
| - | - |
| Georgiano | `ka` |
| Alemão | `de` |
| Alemão (Áustria) | `de_AT` |
| Alemão (Suíça) | `de_CH` |
| Grego | `el` |
| Guzerate | `gu` |
| Hauçá | `ha` |
| Hebraico | `he` |
| Híndi | `hi` |
| Húngaro | `hu` |
| Indonésio | `id` |
| Irlandês | `ga` |
| Italiano | `it` |
| Japonês | `ja` |
| Canarês | `kn` |
| Cazaque | `kk` |
| Quiniaruanda | `rw_RW` |
| Coreano | `ko` |
| Quirguiz (Quirguistão) | `ky_KG` |
| Lao | `lo` |
| Letão | `lv` |
| Lituano | `lt` |
| Macedônio | `mk` |
| Malaio | `ms` |
| Malaiala | `ml` |
| Marata | `mr` |
| Norueguês | `nb` |

### P–Z

| Idioma | Código |
| - | - |
| Pashto | `ps_AF` |
| Persa | `fa` |
| Polonês | `pl` |
| Português (Brasil) | `pt_BR` |
| Português (Portugal) | `pt_PT` |
| Panjabi | `pa` |
| Romeno | `ro` |
| Russo | `ru` |
| Sérvio | `sr` |
| Cingalês | `si_LK` |
| Eslovaco | `sk` |
| Esloveno | `sl` |
| Espanhol | `es` |
| Espanhol (Argentina) | `es_AR` |
| Espanhol (Chile) | `es_CL` |
| Espanhol (Colômbia) | `es_CO` |
| Espanhol (Costa Rica) | `es_CR` |
| Espanhol (República Dominicana) | `es_DO` |
| Espanhol (Equador) | `es_EC` |
| Espanhol (Honduras) | `es_HN` |
| Espanhol (México) | `es_MX` |
| Espanhol (Panamá) | `es_PA` |
| Espanhol (Peru) | `es_PE` |
| Espanhol (Espanha) | `es_ES` |
| Espanhol (Uruguai) | `es_UY` |
| Suaíli | `sw` |
| Sueco | `sv` |
| Tâmil | `ta` |
| Télugo | `te` |
| Tailandês | `th` |
| Turco | `tr` |
| Ucraniano | `uk` |
| Urdu | `ur` |
| Uzbeque | `uz` |
| Vietnamita | `vi` |
| Zulu | `zu` |

## Requisição

Defina `language` com um código da tabela ao criar um modelo.

```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"]]
        }
      }
    ]
  }'
```

## Resposta

```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."
    }
  ]
}
```

A resposta preserva o código de idioma enviado. Um modelo `PENDING` precisa
concluir a análise antes que você possa usá-lo em uma solicitação de mensagem.

## Erros comuns

* Usar uma localidade do site como `en-US` em vez do código do modelo `en_US`.
* Enviar um código regional que não corresponda ao modelo aprovado.
* Presumir que a Meta traduz o conteúdo do modelo automaticamente.
* Reutilizar um código de idioma para conteúdo escrito em outro idioma.

<CardGroup cols={2}>
  <Card title="Gerenciar modelos" icon="rectangle-list" href="/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    Crie, versione, revise, publique e desative modelos localizados.
  </Card>

  <Card title="API de criação de modelos" icon="code" href="/api-reference/whatsapp-templates/create-a-template">
    Inspecione o esquema completo de requisição e resposta.
  </Card>
</CardGroup>


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