跳到主要内容
跳转到主要内容
接入 WhatsApp

AIP

接入 WhatsApp

让客户通过 WhatsApp 向 Agent 提问、发送文件并获取回复。

开始前

准备一个已启用的 Agent，以及能管理 Meta 业务资产组合、WhatsApp 企业账户（WABA）和应用的账号。

1

准备 WhatsApp 企业账户

打开 Meta Business Suite，选择业务资产组合，进入“设置 → 账户 → WhatsApp 账户”。已有账户和号码可直接使用。

WhatsApp 账户与添加入口
首次使用：登录并创建账户

按页面选择登录方式。

Meta 登录入口

点击“添加 → 新建 WhatsApp Business 业务账户”。

新建业务账户

填写真实公司或品牌名称、类别，按提示完成验证。

账户名称与类别

按账户提供的选项选择号码；使用自己的号码时完成号码验证。

号码选项与继续按钮

创建完成后返回账户列表。名称审核和号码状态以 Meta 后台为准。

账户创建完成提示
2

准备 Meta 应用

打开 Meta for Developers，选择或创建本次使用的业务应用，并关联到 WABA 所在的业务资产组合。

我的应用与创建应用入口
没有应用：查看创建流程

填写应用名称和联系邮箱。优先选择 WhatsApp 用例。

应用名称和联系邮箱旧版其他用例入口业务应用类型

选中目标业务资产组合，确认后创建应用。

关联业务资产组合
3

取得号码与账户 ID

回到 Business Suite 的 WhatsApp 账户，复制账户详情中的“编号”，作为 Business Account ID（WABA ID）。

账户详情中的 WABA ID

打开“电话号码”，点击目标号码。

电话号码列表

复制弹窗顶部的“编号”，作为 Phone Number ID；另记带国家区号的完整号码。

号码 ID 和国际格式号码
4

配置权限并取得凭证

在 Business Suite 打开“用户 → 系统用户”，选择已有系统用户；需要新建时，角色选择 Employee。

创建 Employee 系统用户

点击“分配资产”，选择本次使用的 App 和 WABA，按下表授权。

资产所需权限
Meta App开发应用
WhatsApp 账户目标号码管理、消息收发
App 资产与开发权限入口WABA 号码和消息权限入口

确认 App 和 WABA 都在“已分配的资产”中，再点击“生成口令”。

已分配资产与生成口令

选择同一个 App，设置有效期，并选择以下两项权限：

Permission
whatsapp_business_messaging
whatsapp_business_management
Token 权限下拉框与生成口令
查看应用和有效期选择
选择 Token 所属 App

有效期按使用计划设置。截图中的“永不”不代表 Token 无法撤销或失效。

Token 有效期选项

生成后复制访问 Token。

访问 Token 复制入口，值已脱敏

在同一 App 的“应用设置 → 基本”中查看并复制 App Secret。

应用密钥与显示按钮
从 Business Suite 打开应用设置

也可从“账户 → 应用”选中 App，点击菜单中的“在应用面板中打开”。

打开应用面板
5

在 AIP 创建渠道

打开“渠道 → 新建渠道”，选择 WhatsApp，填写名称和国际格式号码，点击“下一步”。

渠道名称、WhatsApp 号码与下一步

填写 Phone Number ID、Business Account ID、Meta 访问 Token 和 Meta App Secret，创建渠道。

复制安装页的完整回调 URL 和 Webhook Verify Token，用于下一步。

回调 URL 与 Webhook Verify Token
6

配置消息回调

  1. 在 Meta for Developers 打开当前 App 的 Webhook，选择 WhatsApp Business Account。
  2. 填入 AIP 回调 URL 和 Webhook Verify Token，验证并保存。
  3. 在订阅字段中开启 messages。
  4. 按 Meta 提示完成真实消息接收要求；需要上线时切换到 Live。
多个 WABA 共用一个 App

保留原有 App 回调与 messages 订阅。由管理员为新 WABA 的 subscribed_apps 设置 override_callback_uri 和 verify_token，再查询确认。覆盖按 WABA 生效；同一 WABA 的多个号码需先确认路由。

7

选择 Agent 并测试

回到 AIP，点击“我已完成平台配置，继续”，选择已启用的 Agent 并保存。

Agent 与准入授权设置

用另一个 WhatsApp 号码发送“你好”，确认原会话收到回复，再测试图片或文件。若启用了“需要准入授权”，其他用户需按提示使用邀请码。

常见问题

找不到权限或 Token 失效

检查系统用户是否已分配目标 App 和 WABA，以及 Token 是否包含上述两项权限。Token 失效时更新渠道凭证。

回调验证通过，但没有回复

检查 messages、WABA 的 App 订阅、号码 ID、Agent 状态和准入设置。真实回调返回 401 时，核对 App Secret 是否属于同一个 App。向管理员提供渠道名、发送时间和错误码。

发送受限或显示名未通过

131047 表示客户会话窗口已关闭，让客户再次发消息后重试；窗口外主动发送需获批模板。131037 时，在 WhatsApp Manager 检查该号码的显示名审核与拒绝原因。

文字正常，附件失败

在 Agent 中启用“可写工作区”“执行命令”和“访问网络”。用小文件分别测试读取与返回；仍失败时检查媒体格式、大小限制和发送回执。

认识 Hast了解 Hast AIP、Hast Agent、Hast GTM，以及 FDE 团队的交付方式。AIP 产品介绍了解 FDE 交付平台的定位，以及 Agent 工作台如何支持业务接入。创建第一个 Agent用一个不依赖外部服务的例子，完成配置、保存和调试。配置与管理 Agent设置职责、模型和能力，维护当前生效的配置。管理 Skills编写、导入和选择 Agent 使用的技能文件。添加知识库把网址或文件加入资料库，等待索引后供 Agent 检索。管理业务密钥保存凭证并绑定到 Agent，避免在配置示例中写入真实值。连接业务工具让 Agent 调用已有 HTTP 服务，并明确参数和认证方式。设置长期记忆决定 Agent 能读取哪些记忆，以及新记忆写到哪里。调试 Agent测试保存后的配置，检查连续对话和工具结果。导入、导出与复制复用配置，并在迁移后重新检查资源和凭证。HTTP 接入从服务端调用 Agent，继续对话、读取回复并停止生成。MCP 接入连接外部 Agent 客户端，通过同一把 Public API Key 使用 AIP 工具。接入 Slack将 Agent 加入 Slack，在频道或私聊中提问、处理文件，与团队一起使用。接入 WhatsApp让客户通过 WhatsApp 向 Agent 提问、发送文件并获取回复。接入企业微信（微信客服）将 Agent 接入微信客服，在微信中解答客户问题。Task Agent 产品介绍了解 Hast Agent 如何规划、执行并交付任务，持续使用文件、工具与业务背景。完成第一个任务从需求描述开始，确认计划并检查最终结果。规划、执行与管理对话调整计划，停止当前执行，并管理历史对话。上传、查看与下载文件为任务提供输入资料，并保存执行产物。连接应用与设置能力授权外部应用，并维护任务需要的长期上下文。创建定时任务配置周期、时区和任务要求，查看每次运行结果。Task Agent 常见问题按当前状态检查权限、连接、任务和文件。快速开始创建个人 API 密钥，提交第一条任务并读取执行事件。事件流连接 SSE，处理 HAST Event v2，并在断线后恢复读取。API 文档按 OpenAPI JSON 查看公开接口的参数、认证与响应结构。GTM 产品介绍从网站建立共享项目背景，衔接市场调研、可见度分析和营销内容工作。创建第一个 GTM 项目输入网站，等待初始化，并检查第一批分析结果。管理项目与网站资料切换项目、刷新网站上下文，维护项目名称。公司分析与项目文档检查产品、竞品和营销资料，作为内容任务的背景。SEO 与网站性能阅读 PageSpeed 结果，分别检查移动端和桌面端。AI 品牌提及查看买家问题，以及模型回答是否提到你的品牌。连接 Google Analytics授权账户、选择 GA 属性，并查看流量报告。生成与发布 X 草稿生成帖子，检查预览，再到 X 完成发布。生成文章草稿设定风格、语言和读者，审阅并复制 Markdown。使用 Growth Agent通过项目内对话读取资料或发起后台操作。运行状态与常见问题检查排队、依赖和结果，避免把未完成误当作无数据。套餐与用量查看当前身份的权益、使用情况和账单。