SaleWisely 目前支持三种方式接入 WhatsApp 官方 API 号码，可按需选择：
方式一：Meta 直连（推荐）——使用您自己的 Meta 商业资产（BM / App / 永久 Token）直连 Meta Cloud API，无需第三方服务商，计费直接走您的 Meta 账单；
方式二：阿里云 ChatApp；
方式三：YCloud。
还没有 Cloud API 号码？请先阅读 《Facebook 创建 WhatsApp Cloud API 号码教程》完成 Meta 侧的号码创建。
一、Meta 直连接入（推荐）
1. 登录 SaleWisely，左侧功能面板找到【集成】→【官方API渠道】→【WhatsApp API】，点击【连接】。
2. 代理协议选择【Meta 直连】，依次填入四项凭证后点击【连接】：
Facebook App ID / Facebook App Secret：Meta 开发者后台 → 设置 → 基本中获取；
Business Manager ID：商务管理平台编号；
WhatsApp 永久 Access Token：BM 后台「系统用户」生成的永久令牌，生成时需勾选 business_management、whatsapp_business_messaging、whatsapp_business_management 三项权限。
获取永久 Token 的关键步骤（详细图文见 创建号码教程）：
① 打开 FB 商务后台设置，在所绑定 BM 下点击【系统用户】→【添加】，优先创建「管理员」系统用户；
② 点击该系统用户 →【添加资产】，勾选前面创建的应用并开启「管理应用」权限；
③ 点击【生成新口令】，选择应用，勾选三项权限后生成并复制口令。
注意：口令仅在生成时可复制，请妥善保存；系统用户口令永久有效，请勿泄露。
3. 连接成功后，系统自动同步该 BM 下已通过验证的 WABA 号码（自动拉取前 50 个 WABA，超出的可点击「同步 BM 下的号码」手动补充），同时弹出 Webhook 配置信息（Callback URL 与 Verify Token）。
4. 前往 Meta 开发者后台 → 您的应用 →【WhatsApp】→【配置】，将 Webhook URL 填入 Callback URL、Verify Token 填入对应令牌框，点击验证并保存后，订阅 messages 字段。完成后即可收发消息。
5. 在号码列表中开启对应号码的开关，即可开始接待客户。
注意：仅海外号码注册的 Facebook 个人号开发者可使用 Cloud API；中国大陆地区注册的账号暂不支持。应用需在 Meta 开发者后台切换为「上线中」状态。
二、阿里云Chat App集成
阿里云是Meta官方认可的商业解决方案提供商，通过Chat App Message Service 提供直接访问WhatsApp API的服务，企业可享受官方通道的稳定性和合规保障。
2.点击右上角【账号】→【AccessKey】
3.点击【使用RAM用户Access Key】→【用户】→【创建用户】，填入用户账号信息后点击确定，即可生成对应的Access Key，复制保存当前页面的【AccessKey ID、AccessKey Secret】。
注意：必须保存AccessKey相关信息，仅有在创建时可复制获取，后续无法获取！
4.左侧功能面板找到【授权】→【新增授权】，如图，勾选刚创建的邮箱账号作为【授权主体】，搜索ChatApp,勾选对应管理权限→【确认新增授权】。
6.在阿里云搜索【ChatApp消息服务】→【通道管理】→【管理】→【WABA管理】→【WABA注册及绑定】，绑定好号码。
7. 返回SaleWisely，左侧功能面板找到【集成】→【官方API渠道】→【WhatsApp API】→【授权号码】，选择ChatApp集成方式。复制Webhook地址，在阿里云控制台【通道webhook设置】、【设置webhook】分别按回调、通知地址，填入相应的通道Webhook设置处。
8. SaleWisely填入之前保存的【AccessKey ID、AccessKey Secret】，即可配置成功。
三、YCloud集成商业API号码
YCloud是Meta官方认证的WhatsApp BSP，它接入了 Meta 的底层的 WhatsApp Business API，企业可以通过 YCloud 快速完成 Meta 企业认证、申请官方绿标/蓝标（绿勾认证），并直接开通WhatsApp商业API账号。
2.打开SaleWisely,左侧功能面板找到【集成】→【官方API渠道】→【WhatsApp API】→【授权号码】，选择YCloud集成方式。
3. 在YCloud平台【注册或绑定】WhatsApp账号。
4.完成绑定后，找到YCloud左侧【Developers】-【API密钥】查看并复制API Key到SaleWisely即可成功集成。
常见问题
1.（Meta 直连）创建应用提示“你暂时被禁止执行这项操作”
原因：Facebook Business Manager（BM）账号有异常，请检查 BM 状态。
2.（Meta 直连）提示“目前无法显示请求查看的内容”
原因可能是:内容暂时不可用、链接已过期、你没有查看权限；或应用程序被删除/封禁，关联的WhatsApp 号码也被封禁，可换一个FB个人号尝试。
3.（Meta 直连）隐私权政策网址无效
出现场景是打开应用模式：开发者上线开关提示您必须提供有效隐私权政策网址才能使应用上架。请前往【设置】→【基本】填写有效的隐私权政策网址，保存后再次打开上线开关。
4.（Meta 直连）中国大陆可以接入吗？
仅海外号码注册的 Facebook 个人号开发者可使用 Cloud API；中国大陆地区注册的开发者暂无法使用，可选用阿里云 ChatApp 或 YCloud 方式接入。
5.WhatsApp app设备数量0/1，为什么点击添加设备提示数量达到上限？
可以查看下号码状态，目前逻辑是：已连接/已断开/扫码中的号码均会占用设备号数量，可检查并删除失效号码，再尝试添加设备。
6.为什么我的WhatsApp app 设备号码状态失效了？
检查手机app上的号码状态是否正常，检查下连接的设备是否有超过限额（最多可同时在四台已关联的设备上使用WhatsApp）详情查看WhatsApp app官方《关于WhatsApp已关联的设备》说明
可能是其他SaleWisely账号已连接了该设备，导致您的号码状态变为失效。
已关联的设备不活跃状态>=30天也会自动解除关联。如果你超过 14 天没使用手机，已关联的设备便会登出。
如果上述情况都不符合的话，可能是出现异常，导致您的设备已登出，详情可查看官方文档：《看到WhatsApp 显示 “您的设备已登出”》
WhatsApp账号被封禁。
确认下手机端的vpn节点是哪里，保证添加设备的地区和手机端节点一致，如系统没有节点可选择就近的地区或者自定义代理。比如手机端节点是香港，在SaleWisely选择的是阿联酋地区，这种会导致经常失效的，建议切换到相同节点（香港）。
