AutoManus开发文档

Pro 客户设置

为 Pro 客户设置 WhatsApp

面向代理商和 ISV 的完整指南，使用 Twilio 和 Meta WhatsApp Business API 为每位 Pro 客户配置专用 WhatsApp 号码。

工作原理

此设置连接三项服务。Twilio 提供电话号码，Meta 提供 WhatsApp Business API，AutoManus 运行 AI 助手。

1️⃣

Twilio

电话号码提供商

每月约 $1 到 $5

2️⃣

Meta

WhatsApp Business API

处理所有消息收发

3️⃣

AutoManus

AI 助手面板

通过 API 凭据连接

关键要点： Twilio 仅提供号码和验证。所有实际的 WhatsApp 消息都通过 Meta 的 Cloud API 收发，而非通过 Twilio。

您需要准备

  • 一个已启用计费的 Twilio 账户
  • 对 Meta Business Suite 账户的访问权限
  • 客户的企业注册信息（用于监管包）
  • 有效的 AutoManus Pro 订阅

阶段 1：获取 Twilio 号码

1

前往 Twilio Console

登录 console.twilio.com，然后进入 Phone Numbers，再选择 Buy a Number。

2

搜索号码

选择客户所在国家，并选择具备 Voice 和 SMS 功能的号码。

英国号码： 英国号码在购买前需要完成监管包。请参阅下一步。
3

完成英国监管包

如果 Twilio 提示需要监管包，请按以下选项创建：

  • 将企业类型选择为 ISV 或经销商
  • 当被问及是否将号码再分配给最终用户时，选择是
  • 选择由企业接收并使用该号码

输入客户的企业信息：

  • 企业名称： 客户的注册公司名称
  • 注册机构： Companies House（英国公司）
  • 注册号： 客户的公司注册号
  • 网站： 客户的企业网站
  • 地址： 客户的注册营业地址

审核通常需要 1 到 3 个工作日。您可以在 Companies House 上查询公司信息。

4

配置呼叫转移

Twilio 号码可以接听电话。将来电转移到真实电话，以免客户无人接听。

  1. 在 Twilio Console 中打开该号码
  2. 在 Voice Configuration 下，将呼叫处理程序设置为 TwiML Bin
  3. 粘贴下方的 TwiML 以转移来电
<?xml version="1.0" encoding="UTF-8"?>
<Response>
  <Dial>+YOUR_PERSONAL_PHONE</Dial>
</Response>

将 +YOUR_PERSONAL_PHONE 替换为您希望接收转移来电的号码。

阶段 2：设置 Meta Business Suite

1

打开 Meta Business Suite

前往 business.facebook.com，然后进入 Settings、Accounts，再到 WhatsApp Accounts。

2

创建新的 WhatsApp Business Account

点击 Add 创建一个新的 WhatsApp Business Account（WABA），填写以下信息：

  • 账户名称： 客户的企业名称
  • 类别： 最符合客户业务的类别
3

添加 Twilio 电话号码

当系统提示输入电话号码时：

  • 选择添加新号码
  • 输入您购买的 Twilio 号码
  • 选择 语音电话 验证（而非短信）
4

接收验证电话

Meta 会拨打 Twilio 号码并提供验证码。借助呼叫转移，该来电会转到您的手机。请在 Meta Business Suite 中输入验证码。

没有收到来电？ 请检查 Twilio 号码是否已配置呼叫转移，且转移目标能够正常接听电话。
5

将号码注册到 Cloud API

将电话号码注册到 Meta 的 Cloud API，使其能够收发消息。 此步骤常被遗漏。

curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messaging_product": "whatsapp", "pin": "123456"}'
如果您跳过此步骤：
  • 号码会显示为已连接，但消息会发送失败
  • webhook 不会投递接收到的消息
  • 从 AutoManus 发送时会出现错误

阶段 3：获取 API 凭据

1

打开 Meta 开发者控制台

前往 developers.facebook.com，然后选择您的应用，再进入 WhatsApp，然后到 API Setup。

2

选择新的电话号码

在 API Setup 页面，从下拉菜单中选择客户的电话号码，以便下方的凭据与之匹配。

3

复制凭据

您需要从 API Setup 页面获取三个值：

  • 电话号码 ID： 所选号码旁显示的 ID
  • WhatsApp Business Account ID： 客户账户的 WABA ID
  • 访问令牌： 页面上显示的临时令牌
4

生成永久令牌

临时令牌将在 24 小时后过期。请通过系统用户生成永久令牌：

  1. 前往 Business Settings，然后 System Users
  2. 创建一个具有 Admin 角色的系统用户
  3. 点击 Generate Token
  4. 选择您的应用并授予以下权限：
    • whatsapp_business_management
    • whatsapp_business_messaging
  5. 复制生成的令牌并妥善保管

阶段 4：连接到 AutoManus

1

打开 WhatsApp 设置

登录客户的 AutoManus 账户，然后前往 → /dashboard/whatsapp-setup

2

使用高级设置

点击 Advanced Setup，以手动输入凭据，而非使用引导式 Facebook 登录。

3

输入凭据

用阶段 3 中获取的值填写表单：

  • 访问令牌： 永久系统用户令牌
  • 电话号码 ID： 来自 API Setup 的电话号码 ID
  • 企业账户 ID： WhatsApp Business Account ID
  • 显示名称： 客户将看到的名称
4

配置 webhook

在 Meta 开发者控制台中设置 webhook，以便 AutoManus 接收接收到的消息：

  • 回调 URL： https://automanus.io/api/whatsapp/webhook
  • 验证令牌： automanus_webhook_2025
5

连接并测试

保存配置，然后向客户号码发送测试消息。AI 助手应在几秒内回复。

转移所有权

合作结束时，您可以将 WhatsApp 号码和账户移交给客户。

Meta Business Suite

  1. 打开 Business Settings，然后进入 WhatsApp Accounts
  2. 选择客户的 WABA
  3. 将客户添加为合作伙伴或分配其企业
  4. 授予客户对该账户的完全控制权
  5. 在客户确认后移除您自己的访问权限

Twilio

在 Twilio 中，您可以为客户创建子账户或将号码转移到客户的 Twilio 账户，也可以继续通过您的账户计费。

费用

  • Twilio 号码： 每月约 $1 到 $5
  • Meta 对话： 用户发起的对话在 24 小时内免费
  • 企业发起的对话： 每次对话约 $0.005 到 $0.05

故障排查

英国监管包被拒

请确保企业名称、注册号和地址与 Companies House 官方记录完全一致。

短信验证无效

Twilio 号码可能无法可靠地接收来自 Meta 的短信。请改用语音电话验证。

未收到验证电话

请确认 Twilio 号码已设置呼叫转移，且目标电话能够接听该来电。

号码不可用

如果无法在 Meta 中添加该号码，请确认它尚未在 WhatsApp 注册，且监管包已获批准。

账户未注册

如果消息因注册错误而失败，请将号码注册到 Cloud API：

curl -X POST "https://graph.facebook.com/v21.0/PHONE_NUMBER_ID/register" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"messaging_product": "whatsapp", "pin": "123456"}'

未找到电话号码

请确认您在 API Setup 中选择了正确的电话号码，且凭据与该号码匹配。

AI 助手没有回复

请检查 own_whatsapp_deployments 中是否存在部署记录，并确认该助手对此号码处于激活状态。

资源