n8n 发送 WhatsApp 模板时出现 400 Account not registered 怎么排查?
支付阿杰
结论
目前只能确认,发送模板时 WhatsApp 接口返回了 Account not registered。这条错误不足以证明原因是电话号码处于 pending,也无法确认需要连接证书。建议先核对 n8n 使用的 WhatsApp 账号、发送号码和收件号码,再查看 Meta 中该号码的注册状态。
错误发生在 n8n 2.0.2 Cloud 的 Send template 节点,操作为 sendTemplate,HTTP 状态码为 400:
{
"errorMessage": "Bad request - please check your parameters",
"errorDescription": "Account not registered",
"errorDetails": {
"httpCode": "400"
}
}
Bad request 是概括性提示,排查时应重点关注 Account not registered。单凭这段日志,无法判断它具体指发送方号码、收件方账号,还是 Meta 侧的账号配置。
建议按这个顺序排查
- 确认发送号码状态。 在 Meta 中查看该号码是否已按当前 WhatsApp API 接入方式完成注册。如果号码仍显示
pending,先完成 Meta 页面要求的步骤,确认号码变为可用状态后再重试。不要只凭pending状态判断是证书问题;先确认当前使用的 API 类型及其注册流程。 - 核对 n8n 凭据关联的账号和号码。 确认凭据对应的 WhatsApp Business 账号与配置的发送号码一致。节点能列出模板或号码,并不能证明发送号码已完成注册,也不能保证发送时使用的是预期账号。
- 检查收件号码。 确认收件号码格式正确,且已注册 WhatsApp。如果方便,可以使用同一凭据和发送号码,换一个已知可用的收件号码进行对照,看看问题是否只出现在特定收件方。
- 核对模板配置。 确认所选模板属于当前 WhatsApp Business 账号,并检查模板语言和参数是否符合模板定义。现有错误描述没有指出模板或参数有问题,因此这只是排查项,不能视为已确认原因。
- 确认号码添加入口。 Meta App 中只显示测试号码,因此目前无法从这个页面确认正式号码是否已关联到对应业务账号。检查 Meta 中 WhatsApp Business 账号的号码管理或 API 配置页面,并确认 n8n 凭据关联的是该账号。菜单名称可能因 Meta 界面和接入方式而异。
关于证书
先确认使用的是哪种 WhatsApp 接入方式,再按照 Meta 中对应的流程设置号码。目前没有接入方式的信息,也没有 pending 页面上的具体提示,因此无法据此提供证书连接步骤。查看号码状态旁的完整说明;如果页面要求完成注册或验证,先按要求处理,再用 n8n 重试。
如果完成以上检查后仍返回相同错误,请记录发送号码状态、收件号码是否已注册、n8n 凭据关联的业务账号,以及失败请求的完整错误响应。分享日志前,请遮盖令牌、电话号码等敏感信息。这些信息可以帮助判断 Account not registered 指向哪一侧的账号或号码。
备注:内容仅供参考。
