使用WhatsApp Cloud API创建模板时遭遇语言代码错误求助

一、"指定语言代码下无可用模板"错误的排查要点 #

• 检查模板状态：模板必须处于*已批准（APPROVED）*状态才能调用，待审核（PENDING）或被拒绝（REJECTED）的模板无法正常使用，可在Meta Business Manager的WhatsApp模板管理页面查看状态。
• 严格匹配语言代码：API调用时的语言代码必须和模板创建时完全一致，WhatsApp采用[ISO 639-1语言码]_[ISO 3166-1国家/地区码]格式，比如zh_CN、en_US，不能简写为zh或en。
• 核对模板名称：调用时传入的模板名称要和创建时完全匹配，大小写、下划线等特殊字符都不能出错，比如模板命名为delivery_update，调用时不能写成DeliveryUpdate。
• 校验请求参数格式：发送模板消息的请求中，language.code字段必须准确，示例请求片段：

  {
    "messaging_product": "whatsapp",
    "to": "目标用户号码",
    "type": "template",
    "template": {
      "name": "你的模板名称",
      "language": {
        "code": "zh_CN"
      }
    }
  }
  

• 确认账号一致性：确保调用API使用的Meta账号和创建模板的账号为同一主体，跨账号无法访问对方的模板资源。

二、易出现语言代码错误的API类型 #

• 模板消息发送API：这是最常触发该错误的场景，语言代码不匹配或格式错误会直接返回无可用模板的提示。
• 模板创建/查询API：创建模板时若语言代码不符合规范会导致创建失败；查询模板列表时，错误的语言代码会返回空结果集。
• 会话消息发送API：当会话消息涉及多语言本地化配置时，错误的语言代码会导致消息无法按预期展示。
• 媒体资源API：上传或关联带语言标签的媒体文件时，错误的语言代码会导致资源无法绑定到对应语言版本的模板。

内容的提问来源于stack exchange，提问作者Abraham Zamani