> ## 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.

# 支持的 WhatsApp 消息模板语言

> 在创建、管理或发送 WhatsApp 模板时，请选择 Meta 支持的语言代码。

## 什么是支持的语言

每个 WhatsApp 模板都有一个语言代码。该代码用于识别模板内容的语言以及适用的区域语言环境。

在创建、获取、编辑、删除或发送该本地化模板时，请使用相同的代码。例如，英语（美国）使用 `en_US`，葡萄牙语（巴西）使用 `pt_BR`。

## 开始之前

* 选择与模板内容匹配的语言。
* 当 Meta 为目标语言区域提供了区域代码时，请使用该区域代码。
* 在您的应用程序中将模板名称和语言代码保持在一起。
* 在发送之前，请为每个本地化模板创建并获取批准。

<Note>
  Meta 可能会更新支持的语言列表。本页面反映了
  [Meta 支持的语言参考](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages)，
  更新于 2026 年 5 月 21 日。
</Note>

## 工作原理

1. 选择一个支持的语言代码。
2. 创建模板时，在 `language` 字段中设置该代码。
3. 等待该本地化模板审核通过。
4. 在模板管理和消息请求中使用完全相同的代码。

语言代码区分大小写。请勿将下划线替换为连字符。
例如，发送 `zh_CN`，而不是 `zh-CN`。

## 支持的语言代码

### A–F

| 语言 | 代码 |
| - | - |
| 南非荷兰语 | `af` |
| 阿尔巴尼亚语 | `sq` |
| 阿拉伯语 | `ar` |
| 阿拉伯语（埃及） | `ar_EG` |
| 阿拉伯语（阿拉伯联合酋长国） | `ar_AE` |
| 阿拉伯语（黎巴嫩） | `ar_LB` |
| 阿拉伯语（摩洛哥） | `ar_MA` |
| 阿拉伯语（卡塔尔） | `ar_QA` |
| 阿塞拜疆语 | `az` |
| 白俄罗斯语 | `be_BY` |
| 孟加拉语 | `bn` |
| 孟加拉语（印度） | `bn_IN` |
| 保加利亚语 | `bg` |
| 加泰罗尼亚语 | `ca` |
| 中文（中国） | `zh_CN` |
| 中文（香港） | `zh_HK` |
| 中文（中国台湾） | `zh_TW` |
| 克罗地亚语 | `hr` |
| 捷克语 | `cs` |
| 丹麦语 | `da` |
| 达里语 | `prs_AF` |
| 荷兰语 | `nl` |
| 荷兰语（比利时） | `nl_BE` |
| 英语 | `en` |
| 英语（英国） | `en_GB` |
| 英语（美国） | `en_US` |
| 英语（阿拉伯联合酋长国） | `en_AE` |
| 英语（澳大利亚） | `en_AU` |
| 英语（加拿大） | `en_CA` |
| 英语（加纳） | `en_GH` |
| 英语（爱尔兰） | `en_IE` |
| 英语（印度） | `en_IN` |
| 英语（牙买加） | `en_JM` |
| 英语（马来西亚） | `en_MY` |
| 英语（新西兰） | `en_NZ` |
| 英语（卡塔尔） | `en_QA` |
| 英语（新加坡） | `en_SG` |
| 英语（乌干达） | `en_UG` |
| 英语（南非） | `en_ZA` |
| 爱沙尼亚语 | `et` |
| 菲律宾语 | `fil` |
| 芬兰语 | `fi` |
| 法语 | `fr` |
| 法语（比利时） | `fr_BE` |
| 法语（加拿大） | `fr_CA` |
| 法语（瑞士） | `fr_CH` |
| 法语（科特迪瓦） | `fr_CI` |
| 法语（摩洛哥） | `fr_MA` |

### G–N

| 语言 | 代码 |
| - | - |
| 格鲁吉亚语 | `ka` |
| 德语 | `de` |
| 德语（奥地利） | `de_AT` |
| 德语（瑞士） | `de_CH` |
| 希腊语 | `el` |
| 古吉拉特语 | `gu` |
| 豪萨语 | `ha` |
| 希伯来语 | `he` |
| 印地语 | `hi` |
| 匈牙利语 | `hu` |
| 印度尼西亚语 | `id` |
| 爱尔兰语 | `ga` |
| 意大利语 | `it` |
| 日语 | `ja` |
| 卡纳达语 | `kn` |
| 哈萨克语 | `kk` |
| 卢旺达语 | `rw_RW` |
| 韩语 | `ko` |
| 吉尔吉斯语（吉尔吉斯斯坦） | `ky_KG` |
| 老挝语 | `lo` |
| 拉脱维亚语 | `lv` |
| 立陶宛语 | `lt` |
| 马其顿语 | `mk` |
| 马来语 | `ms` |
| 马拉雅拉姆语 | `ml` |
| 马拉地语 | `mr` |
| 挪威语 | `nb` |

### P–Z

| 语言 | 代码 |
| - | - |
| 普什图语 | `ps_AF` |
| 波斯语 | `fa` |
| 波兰语 | `pl` |
| 葡萄牙语（巴西） | `pt_BR` |
| 葡萄牙语（葡萄牙） | `pt_PT` |
| 旁遮普语 | `pa` |
| 罗马尼亚语 | `ro` |
| 俄语 | `ru` |
| 塞尔维亚语 | `sr` |
| 僧伽罗语 | `si_LK` |
| 斯洛伐克语 | `sk` |
| 斯洛文尼亚语 | `sl` |
| 西班牙语 | `es` |
| 西班牙语（阿根廷） | `es_AR` |
| 西班牙语（智利） | `es_CL` |
| 西班牙语（哥伦比亚） | `es_CO` |
| 西班牙语（哥斯达黎加） | `es_CR` |
| 西班牙语（多米尼加共和国） | `es_DO` |
| 西班牙语（厄瓜多尔） | `es_EC` |
| 西班牙语（洪都拉斯） | `es_HN` |
| 西班牙语（墨西哥） | `es_MX` |
| 西班牙语（巴拿马） | `es_PA` |
| 西班牙语（秘鲁） | `es_PE` |
| 西班牙语（西班牙） | `es_ES` |
| 西班牙语（乌拉圭） | `es_UY` |
| 斯瓦希里语 | `sw` |
| 瑞典语 | `sv` |
| 泰米尔语 | `ta` |
| 泰卢固语 | `te` |
| 泰语 | `th` |
| 土耳其语 | `tr` |
| 乌克兰语 | `uk` |
| 乌尔都语 | `ur` |
| 乌兹别克语 | `uz` |
| 越南语 | `vi` |
| 祖鲁语 | `zu` |

## 请求

创建模板时，请将 `language` 设置为表中的某个代码。

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

## 响应

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

响应会保留所提交的语言代码。`PENDING` 模板必须先完成审核，然后才能在消息请求中使用。

## 常见错误

* 使用网站区域设置（如 `en-US`）代替模板代码 `en_US`。
* 发送与已批准模板不匹配的地区代码。
* 误以为 Meta 会自动翻译模板内容。
* 将某种语言代码重复用于以另一种语言编写的内容。

<CardGroup cols={2}>
  <Card title="管理模板" icon="rectangle-list" href="/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    创建、进行版本控制、审核、发布和停用本地化模板。
  </Card>

  <Card title="创建模板 API" icon="code" href="/api-reference/whatsapp-templates/create-a-template">
    查看完整的请求和响应架构。
  </Card>
</CardGroup>


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