跳转到主要内容
◈hastdocs
简体中文
Hast 首页

AIP

接入 WhatsApp

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

开始前

AIP 页面新建 WhatsApp 渠道使用 Dualhook。由 FDE 引导你连接自己的 Dualhook 组织和 WhatsApp Business 账号，请由账号持有人完成授权。

同一 Profile 已接入的账号请使用已有渠道。将渠道加入知识库不需要再次授权。需要自动回复时，另准备一个已启用的 Agent。

1

准备账号授权

按 Dualhook 账号接入指南 准备组织和 WhatsApp Business 账号。确认使用的账号和号码属于本次接入。

需要历史记录时，在首次 WhatsApp 授权时选择导入，并在接入后 24 小时内发起。可用记录最多覆盖接入前 180 天；实际内容由供应商提供，不包含群聊和全部历史媒体。

2

在 AIP 创建渠道

打开“渠道 → 添加渠道”，选择 WhatsApp。填写名称，选择是否“导入可用历史记录”，点击“创建渠道”。

创建后会显示回调地址和验证 token。若尚未完成配置，可从渠道列表的“完成配置”继续。

3

配置消息回调

将 AIP 提供的完整回调地址和验证 token 填入当前 Dualhook 组织的接入配置，并完成账号授权。请妥善保管这两个值。

回调配置须属于当前渠道；不同账号不要互相覆盖已有回调。

4

保存账号信息

在 AIP 填写本次 Dualhook 接入提供的 WABA ID 和 Phone Number ID。它们是账号与号码标识，不是手机号本身。

获取 Outbound API key

按 Dualhook Runtime API 指南 获取对应组织的 Outbound API key，填入同名字段，点击“保存账号信息”。此字段使用 Dualhook 的出站 API 凭证。

保存后显示“账号已配置”。历史状态由供应商回调更新；显示“历史消息已接收”时，媒体仍可能另行到达。

5

关联 Agent 并测试

新内容自动同步，知识同步不依赖 Agent。打开渠道的“查看内容”，检查是否收到新消息；需要检索时，将该来源加入对应知识库。

需要自动回复时，在 Agent 的“渠道”中关联此连接并保存。启用 Agent 后，用另一个 WhatsApp 号码发送消息，确认原会话收到回复，再分别测试图片或文件。渠道关联与知识读取权限分别配置。

已有 Meta 接入

已有直接连接 Meta 的 WhatsApp 渠道仍可维护。在该渠道的“重新授权”中填写原账号的 phone_number_id、business_account_id、token_secret_value 和 app_secret_value，保存后测试消息。Token 与 App Secret 须来自同一 Meta App，且该 App 仍获目标 WABA 授权。

现有 Meta 接入与新的 Dualhook 接入使用不同凭证。维护已有连接时保留其账号和回调，不要为了更新凭证重复创建渠道。

常见问题

仍显示待完成配置

打开“完成配置”或设置中的“账号接入配置”，检查当前 Dualhook 组织的回调、WABA ID、Phone Number ID 与 Outbound API key，并保存账号信息。

已接入，但没有回复

先在“查看内容”确认是否收到新消息，再检查 Agent 是否启用、是否关联此渠道，以及渠道触发规则。知识同步成功不代表已开启自动回复。

历史记录尚未到齐

检查首次授权时是否请求导入，以及供应商显示的进度。历史导入有时间窗口和内容限制，不能保证所有媒体都到齐；不要通过重复授权创建第二个来源。

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