通过 Meta Cloud API 连接 WhatsApp
直接从 Meta（Cloud API）发送和接收 WhatsApp 消息，使用您自己的号码和应用，作为 Twilio 的替代方案。BYO 模式：号码、WhatsApp Business Account 和应用均归您所有。
消息模板
客户超过 24 小时未回复后，WhatsApp 就不再允许发送自由文本：要重新发起会话，必须使用已批准的模板。你可以直接在 CRM 中创建和管理模板，位置在设置 → 集成的 WhatsApp 卡片里，无需前往 Meta 的商务管理平台。
- 点击“新建模板”，并说明用途。技术名称会自动填好（Meta 只接受小写字母、数字和下划线）。
- 选择语言和类别。“实用”用于客户预期中的消息，例如订单或预约；“营销”用于优惠。Meta 也会审核类别，选错是常见的驳回原因。
- 撰写消息。凡是因人而异的内容都用 {{1}}、{{2}} 表示，按顺序编号且不能跳号。
- 为每个变量填写示例。Meta 强制要求，缺少就会驳回模板——这些值不会发送给任何人，只用于审核。
- 提交审核。模板进入待审状态，Meta 通常在几分钟内批准；状态会显示在列表中。
一键连接
如果卡片顶部出现“连接 WhatsApp”按钮，请用它，这是最短的路径。会打开一个 Meta 窗口，你在其中选择（或创建）WhatsApp Business 账号和号码，就完成了。无需创建应用，无需生成令牌，也没有任何东西要粘贴。这之所以可行，是因为 SellioCRM 是经 Meta 批准的技术服务商：连接在我们的应用下完成，而不需要你自己搭建一个。
- 号码和账号仍然属于你。你随时可以在 Meta 上断开连接，我们会立即失去访问权限。
- 我们永远看不到你的 Facebook 密码，我们的任何密钥也不会进入你的浏览器。
- 消息费用仍由 Meta 在你自己的账户上收取。
手动配置（你自己的 Meta 应用）
除了 Twilio，您还可以使用官方的 Cloud API 直接从 Meta 发送和接收 WhatsApp 消息。这是一种替代方案：当此集成处于激活状态时，WhatsApp 会走 Meta 通道；短信仍继续使用 Twilio。BYO 模式（您自带账户）：号码、WhatsApp Business Account（WABA）和 Meta 应用均归您所有，消息在您的 Meta 账户中计费，我们这边不产生任何费用、加价或中间环节。
该集成一开始处于未启用状态：在您填写字段并激活之前不会发送任何内容。access token 和 app secret 会在 CRM 中加密存储，且永远不会再显示出来。
前提条件
- 一个已添加 WhatsApp 产品的 Meta 应用（developers.facebook.com），以及一个 WhatsApp Business Account（WABA）。
- 已注册在您 WABA 下的 WhatsApp 号码及其 Phone Number ID（位于 WhatsApp > API Setup 下）。
- 一个永久 access token（建议：在 Business Manager 中创建一个 System User）以及该应用的 App secret（位于 Settings > Basic 下）。
- 在 Sellio 中拥有管理员权限，以便在 Settings → Integrations 中保存凭据并激活该集成。
需要填写的内容
- Phone Number ID：您在 Meta 中 WhatsApp 号码的标识符（是一个 ID，而非电话号码本身）。
- WABA ID（可选）：您 WhatsApp Business Account 的 ID，用于管理和模板相关操作。
- Graph version：要调用的 Graph API 版本（例如 v21.0）。留空则使用默认版本。
- Verify token：您自行设定的一个字符串。在 CRM 中以及在 Meta 面板订阅 webhook 时，必须保持一致。
- Access token：授权发送消息的永久令牌（在 CRM 中加密存储）。
- App secret：应用密钥，用于验证接收到的 webhook 的签名（在 CRM 中加密存储）。
如何配置
- 打开 Settings → Integrations，找到“WhatsApp（Meta Cloud API）”卡片。
- 填写 Phone Number ID、Verify token（自行设定一个字符串）、Access token 和 App secret；WABA ID 和 Graph version 为可选项。点击“保存凭据”。
- 复制页面上出现的“Webhook URL（Meta）”。在 Meta 面板的 WhatsApp → Configuration → Webhooks 下，将该 URL 粘贴到 Callback URL，并在 Verify token 字段中填入相同的 Verify token。
- 仍在 Meta 面板中，订阅“messages”字段以接收消息和状态。
- 返回 CRM，点击“激活”。此后，WhatsApp 发送将走 Meta 通道。
如何发送消息
- 打开一个填有电话（电话或手机字段）的联系人或潜在客户。
- 在“消息（短信/WhatsApp）”面板中，点击“发送短信/WhatsApp”，选择 WhatsApp 渠道。
- 核对号码，撰写消息内容并点击“发送”。
- 该消息会被记录到该记录的历史中。客户的回复会通过 webhook 到达，并出现在同一条历史记录中。
安全性：CRM 会使用您的 App secret 校验每一次收到的 webhook 的 X-Hub-Signature-256（未签名的调用或签名无效的调用会被拒绝）。请将 access token 和 app secret 视为机密信息：它们会被加密存储，且永远不会再显示出来。
同一应用中的多个号码
同一个集成里可以有多个 WhatsApp 号码（例如：美国号码作为默认，巴西号码用于本地对话）。在集成卡片的"其他号码"中添加它们（Phone Number ID、可选的 WABA ID 和标签）并保存。发起对话时，在"发送号码"中选择发送方；收件箱的回复会自动从每个对话进入时所用的号码发出。主号码仍是默认号码。
如何测试
- 打开一个填有电话的联系人或潜在客户，向您自己的某个号码发送一条简短的 WhatsApp 消息。
- 确认消息已到达手机，并且已记录在该记录的历史中。
- 从手机回复，检查该回复是否出现在同一条历史记录中（这可验证入站 webhook 是否正常）。
故障排查
- 在 Meta 中 webhook 验证失败：CRM 和 Meta 面板中的 Verify token 必须完全一致。检查 Callback URL 是否为卡片上显示的“Webhook URL（Meta）”。
- 发送出错：检查 Phone Number ID 和 Access token。令牌过期或没有 WhatsApp 权限会导致 Meta 拒绝发送。
- 窗口之外 WhatsApp 无法发送：请使用已获批的模板。自由文本仅在 24 小时窗口内有效。
- 收不到回复：在 Meta 面板中订阅“messages”字段，并确认 Callback URL + Verify token 是否正确。
- Webhook 被拒绝（403）：X-Hub-Signature-256 不匹配。请在 CRM 中重新输入相同的 App secret（服务器不会回传该值）。
- 消息仍然通过 Twilio 发出：Meta 集成必须处于“已激活”状态。未激活时，WhatsApp 会继续使用 Twilio。
使用已在 WhatsApp Business 应用中的同一号码
同一个号码可以同时在手机应用中使用并连接到 CRM——Meta 称之为共存。销售人员照常用手机回复，他发出的每条消息都会自动出现在 CRM 的会话里。启用时最多可导入六个月的历史会话。
- 不是由您在企业管理平台自行开启：它通过 CRM 的连接向导完成，并用发送到您 WhatsApp 的验证码确认。
- 应用照常使用：变化只是会话同时被记录在这里，归到正确的联系人下。
- 历史导入有时限：Meta 在启用后给 24 小时。导入期间请保持应用开启——界面会显示进度。
- 如果更换手机或重新注册该号码，连接会断开并需要重做。CRM 会提示您。