跳到主要内容
跳转到主要内容
接入企业微信(微信客服)

AIP

接入企业微信(微信客服)

将 Agent 接入微信客服,在微信中解答客户问题。

开始前

准备一个已启用的 Agent,以及企业微信管理员账号。

1

准备企业微信应用

在企业微信管理后台进入“应用管理 → 自建”,创建或选择本次接入的应用。创建时填写名称、图标和可见范围。

创建自建应用应用详情入口

在“我的企业 → 企业信息”复制企业 ID(Corp ID)。

企业 ID 所在位置
2

准备回调凭证

返回应用,打开“接收消息 → 设置 API 接收”。生成并保存 Token 和 EncodingAESKey,暂不提交 URL。

设置 API 接收入口
字段填写内容
Token生成的 3–32 位校验字符串
EncodingAESKey生成的 43 位消息加密密钥,完整保留
3

在 AIP 创建渠道

在 AIP 的“渠道”中新增“微信客服”,填写渠道名称、Corp ID、Token 和 EncodingAESKey。创建后,在安装配置中查看回调 URL、域名验证地址及可信 IP。

4

验证域名并添加可信 IP

页面要求验证域名时

下载企业微信提供的 WW_verify_*.txt 文件,在 AIP 渠道安装配置中原样上传(不超过 4 KiB)。打开验证文件地址,确认能读取文件原文,再回企业微信点击验证。域名栏只填安装配置提供的域名,不含 /webhooks/ 路径。

域名验证文件与验证按钮

在应用的“企业可信 IP”中添加 AIP 安装配置列出的全部 IP,保存。

5

保存回调配置

回到“API 接收消息”设置,填写以下内容并保存。

项目配置
URLAIP 提供的完整回调 URL,包含 /webhooks/wechat_kf/ 路径
Token、EncodingAESKey创建 AIP 渠道时使用的同一组值
接收事件勾选“微信客服消息与事件”
回调字段及微信客服消息与事件
查看保存后的页面
回调保存后的页面示例
6

授权微信客服账号

进入“微信客服”,创建或选择客服账号,填写客服名称和头像。

创建客服账号

展开客服账号的 API 设置,在“可调用接口的应用”中点击“修改”,选择刚才的应用。

客服账号 API 设置入口

在“企业内部开发”中将客服账号关联到该应用。确认应用可管理本次接入的客服账号。

选择可调用接口的应用关联应用与客服账号
7

完成 AIP 安装

在已授权应用的详情中点击“查看 Secret”,按企业微信提示在客户端获取。

查看应用 Secret 的入口

回到 AIP 安装配置,填写该 Secret,获取客服账号列表并按名称选择目标账号,完成验证。只有一个可管理账号时会自动选择。随后绑定已启用的 Agent。

8

用微信测试回复

用客户微信打开客服链接或扫码,发送一条消息,确认收到 Agent 回复,再测试图片或语音。

常见问题

域名或回调验证失败

确认验证文件可公开访问且内容未改;回调使用完整 URL,两边 Token 和 EncodingAESKey 一致。

无法获取客服账号

核对 Corp ID、Secret 的所属企业与应用,确认应用已获客服授权,并已添加全部可信 IP。

收到消息但没有回复

检查“微信客服消息与事件”、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通过项目内对话读取资料或发起后台操作。运行状态与常见问题检查排队、依赖和结果,避免把未完成误当作无数据。套餐与用量查看当前身份的权益、使用情况和账单。