PAYATHON 2026

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 侧的账号配置。

建议按这个顺序排查

  1. 确认发送号码状态。 在 Meta 中查看该号码是否已按当前 WhatsApp API 接入方式完成注册。如果号码仍显示 pending,先完成 Meta 页面要求的步骤,确认号码变为可用状态后再重试。不要只凭 pending 状态判断是证书问题;先确认当前使用的 API 类型及其注册流程。
  2. 核对 n8n 凭据关联的账号和号码。 确认凭据对应的 WhatsApp Business 账号与配置的发送号码一致。节点能列出模板或号码,并不能证明发送号码已完成注册,也不能保证发送时使用的是预期账号。
  3. 检查收件号码。 确认收件号码格式正确,且已注册 WhatsApp。如果方便,可以使用同一凭据和发送号码,换一个已知可用的收件号码进行对照,看看问题是否只出现在特定收件方。
  4. 核对模板配置。 确认所选模板属于当前 WhatsApp Business 账号,并检查模板语言和参数是否符合模板定义。现有错误描述没有指出模板或参数有问题,因此这只是排查项,不能视为已确认原因。
  5. 确认号码添加入口。 Meta App 中只显示测试号码,因此目前无法从这个页面确认正式号码是否已关联到对应业务账号。检查 Meta 中 WhatsApp Business 账号的号码管理或 API 配置页面,并确认 n8n 凭据关联的是该账号。菜单名称可能因 Meta 界面和接入方式而异。

关于证书

先确认使用的是哪种 WhatsApp 接入方式,再按照 Meta 中对应的流程设置号码。目前没有接入方式的信息,也没有 pending 页面上的具体提示,因此无法据此提供证书连接步骤。查看号码状态旁的完整说明;如果页面要求完成注册或验证,先按要求处理,再用 n8n 重试。

如果完成以上检查后仍返回相同错误,请记录发送号码状态、收件号码是否已注册、n8n 凭据关联的业务账号,以及失败请求的完整错误响应。分享日志前,请遮盖令牌、电话号码等敏感信息。这些信息可以帮助判断 Account not registered 指向哪一侧的账号或号码。

备注:内容仅供参考。