WhatsApp 问题
WhatsApp Business 集成问题排查指南。
常见错误消息
| 错误 | 含义 |
|---|---|
| "Failed to connect WhatsApp account" | 连接设置失败 |
| "Failed to disconnect WhatsApp account" | 无法移除现有连接 |
| "WhatsApp Signup Cancelled" | 用户关闭了设置弹出窗口 |
| "Failed to get state from backend" | 服务器通信错误 |
连接失败
您看到的情况： 尝试连接 WhatsApp Business 时出现错误
首先检查
-
Facebook Business 帐户已准备就绪
- 您需要一个 Facebook Business 帐户
- 该帐户必须已完成验证
-
电话号码要求
- 号码必须能够接收短信
- 号码不能已在 WhatsApp 个人应用中注册
- 号码不能被其他 WhatsApp Business 帐户使用
-
浏览器弹出窗口设置
- 允许 AVA Streamliner 的弹出窗口
- 设置期间不要关闭弹出窗口
尝试以下操作
- 转到 通信中心 → WhatsApp → 设置
- 点击 连接 WhatsApp
- 完成 Facebook 弹出窗口中的流程
- 等待成功消息
- 如果弹出窗口意外关闭，请重试
消息未发送
您看到的情况： 客人没有收到 WhatsApp 消息
检查连接状态
- 转到 通信中心 → WhatsApp → 设置
- 确认状态显示为“已连接”
- 检查已连接的电话号码是否正确
确认模板已获批准
WhatsApp 要求业务消息使用已获批准的模板：
- 在 WhatsApp Business Manager 中确认您的消息模板已获批准
- 已批准的模板会显示 ✓ 状态
- 被拒绝的模板需要修改后重新提交
检查客人的电话号码
- 号码必须包含国家代码（例如，美国为 +1）
- 号码必须是有效的手机号码
- 客人必须已在该号码上安装 WhatsApp
沙盒模式限制
如果处于沙盒模式：
- 只有预先批准的测试号码才能接收消息
- 联系支持团队以切换到生产模式
模板被拒绝
您看到的情况： 模板显示“已拒绝”状态
常见拒绝原因
| 原因 | 解决方法 |
|---|---|
| 促销内容 | 删除销售性语言 |
| 缺少变量 | 正确添加所需的占位符 |
| 格式问题 | 遵循 WhatsApp 模板指南 |
| 违反政策 | 查看 WhatsApp Business 政策 |
修复步骤
- 在 WhatsApp Business Manager 中查看拒绝原因
- 编辑模板以解决相关问题
- 重新提交以供批准
- 等待 24-48 小时审核
断开连接失败
您看到的情况： "Failed to disconnect WhatsApp account"
尝试以下操作
- 刷新页面
- 再次尝试断开连接
- 如果仍然失败，请等待 5 分钟后重试
仍然无法解决？
联系支持团队，并提供：
- 您的酒店名称
- 已连接的电话号码
- 错误截图
弹出窗口已关闭/取消
您看到的情况： "WhatsApp Signup Cancelled"
这通常是因为：
- 您在完成设置前关闭了 Facebook 弹出窗口
- 浏览器阻止了弹出窗口
- 连接超时
修复方法
- 在浏览器中为 AVA Streamliner 启用弹出窗口
- 再次点击 连接 WhatsApp
- 完成整个流程，不要关闭弹出窗口
- 等待成功消息后再关闭弹出窗口
消息延迟
您看到的情况： 客人延迟收到消息
正常延迟
WhatsApp 消息通常会在几秒钟内送达，但以下情况可能导致延迟：
- 高流量时段
- 客人所在位置的网络问题
- WhatsApp 服务器队列
如果持续延迟
- 检查您的 WhatsApp Business 等级（等级越高，送达速度通常越快）
- 联系支持团队检查您的帐户状态
何时联系支持团队
如果出现以下情况，请联系我们：
- 尽管设置正确，连接仍持续失败
- 消息无法送达任何客人
- 帐户被暂停或标记
电子邮件： success@vouch-technologies.com
请提供：
- WhatsApp 设置页面的屏幕截图
- 未收到消息的示例电话号码
- 错误消息（如有）
相关指南
- 请参阅 AVA Streamliner 中的 通信中心 → WhatsApp → 设置