使用Gupshup API发送WhatsApp模板消息提交成功却未收到怎么办？

• 检查测试号码白名单：未上线的Gupshup应用仅支持向预注册的测试号码发送消息。登录Gupshup控制台，确认接收消息的号码已经添加到应用的测试号码列表中，非白名单号码无法接收沙箱环境的消息。
• 验证模板与发送参数一致性：
  • 确认请求中template字段的name与审核通过的模板名称完全一致（注意大小写和特殊字符）。
  • 检查模板参数数量、类型是否与模板定义匹配，比如模板里的{{1}}对应文本参数，不能传入不符合类型的值，参数不匹配会导致消息被静默拦截。
• 查询消息详细状态：submitted仅代表请求被Gupshup接收，不代表已送达。使用Gupshup的消息状态查询接口，传入返回的messageId，获取更具体的状态（如failed、pending）及失败原因，这是定位问题的关键。
• 确认模板的Meta审核状态：Gupshup后台的“启用”不代表模板通过Meta的审核。进入模板管理页面，查看模板状态是否为“已批准”，未通过Meta审核的模板无法发送成功。
• 核对接收号码格式与状态：
  • 接收号码必须是+国际区号+纯数字格式（如+8613800138000），不能包含空格、括号等字符。
  • 确保接收号码的WhatsApp账号正常活跃，无限制或封号情况，能正常接收其他WhatsApp消息。
• 检查请求头与权限：确认请求中的API密钥、应用ID等权限参数正确无误，没有过期或权限不足的情况。

内容的提问来源于stack exchange，提问作者Fullstack Developer