使用WhatsApp API发送es语言模板消息时遇132001错误求助

问题概况 #

使用WhatsApp API发送模板消息时，已创建并获批适用于es（西班牙语）的模板kindo_welcome，但每次请求均返回错误，问题持续数周且无法联系到Facebook支持团队。

错误信息 #

错误提示：

(#132001) Template name does not exist in the translation

完整错误对象：

{
    "error": {
        "message": "(#132001) Template name does not exist in the translation",
        "type": "OAuthException",
        "code": 132001,
        "error_data": {
            "messaging_product": "whatsapp",
            "details": "template name (kindo_welcome) does not exist in es"
        },
        "fbtrace_id": "AukZdjNY1Ahnl_NwJXLmQZx"
    }
}

请求体示例 #

{
    "messaging_product": "whatsapp",
    "to": "{{Recipient-Phone-Number}}",
    "type": "template",
    "template": {
        "namespace": "kindo",
        "name": "kindo_welcome",
        "language": {
            "code": "es"
        },
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Juan"
                    }
                ]
            }
        ]
    }
}

排查与解决步骤 #

• 核对模板名称与命名空间的准确性
  确认Meta Business Manager/WhatsApp Business Platform后台中，模板的名称确实是kindo_welcome，所属命名空间为kindo——名称区分大小写，任何大小写不匹配都会触发该错误。

• 验证西班牙语翻译的状态
  进入模板管理页面，检查kindo_welcome的西班牙语翻译版本：

  1. 确认该翻译已提交并通过审核（状态显示“已获批”）
  2. 排查是否存在未提交的翻译草稿，或翻译版本被意外删除

• 调整语言代码格式测试
  WhatsApp API对语言代码格式有严格要求，尝试将请求体中的"code": "es"替换为"code": "es_ES"（带地区后缀的标准格式）后重新发送请求。

• 确认账号匹配性
  检查调用API使用的访问令牌对应的Meta Business Account，是否与创建模板的Business Account为同一账号——跨账号调用会导致系统无法识别模板。

• 强制同步模板缓存
  Meta模板系统存在缓存延迟，即使模板已获批，API端可能未同步：

  1. 对模板做微小修改（如调整一个无关字符）后重新提交审核，通过后再次调用API
  2. 使用Graph API的模板查询接口（GET /{whats-app-business-account-id}/message_templates），确认返回列表中存在kindo_welcome的es版本，验证模板是否真的存在于系统中

内容的提问来源于stack exchange，提问作者Juan Roa