API 连接如何让 AI 聊天从聊天机器人变成真正的助手

"知道"和"去查"的区别

客户问题分为两类。第一类是通用的:你们的退货政策是什么?发货要多久?发往德国吗? 一个内容充实的知识库可以处理这些。

第二类是具体的:我的订单 #4521 在哪里?蓝色版本还有库存吗?这个月套餐还剩多少? 这些不存在于知识库中。它们存在于你的系统里——订单管理、库存、计费——并且每秒都在变化。

只能处理第一类的聊天机器人不过是一个华丽的 FAQ。能同时处理第二类的聊天机器人才是真正的助手。两者之间的区别就是 API 访问。

这个差距为什么让你流失客户

当今大多数"AI 聊天"都仅建立在知识库之上。它们能用十七种语言改写你的发货政策,但无法告诉客户他的包裹此刻到底在哪里。所以客户问,机器人回避,客户要么放弃,要么等待运营人员去查询那些机器人本可以在毫秒内取出的数据。

这就是聊天机器人的天花板。每一句"让我查一下"都是错失了一个在第一条消息内、客户意图还热乎时几秒内回答的机会。

API 连接到底做什么

在 enuchat 中,API 连接是聊天与你的某个后端服务之间配置好的桥梁。你只需定义一次:基础 URL、认证方式,以及若干带参数和响应映射方式的端点。

从此之后,AI 可以在对话中调用这些端点。当访客询问订单时,AI 提取订单号、调用你的订单端点、读取实时状态并把它编入回复。访客看到的是一句话:"您的订单 #4521 已于昨日发出,预计周四送达。" 这句话背后发生了一次真实的 API 调用。

客户看不到管道。客户只看到聊天确实知道。

五种认证方式,无需自定义代码

你想连接的大多数 API 已经在使用标准认证。enuchat 开箱即用支持五种:

  • ——用于不需要认证的公开 API
  • API Key——作为请求头或查询参数发送
  • Bearer Token——简单的基于令牌的认证
  • Basic Auth——用于遗留系统
  • OAuth 2.0 client credentials——用于 Salesforce、HubSpot 等现代提供商或你自己的 OAuth 服务器

对于 OAuth 2.0,enuchat 自动处理令牌生命周期——首次调用时获取、缓存到过期、需要时刷新。你只需配置一次凭证就可以忘记它们。所有凭证都使用 libsodium 静态加密,永远不会出现在 API 响应中。

变量、模板和响应映射

端点被定义为模板。像 /orders/{orderId} 这样的路径或引用 {customerId} 的 JSON 体会从会话变量中插入值——这些变量是 AI 或静态规则在对话中可以设置的。

当 API 响应时,你使用点表示法把 JSON 响应中的字段映射回会话变量。data.status 变成 order_statusdata.shipping.eta 变成 delivery_eta。然后 AI 把这些值编织进自然语言回复——以访客自己的语言。

覆盖大多数用例的三种模式

实际上,大多数 API 集成都属于三种形态之一。

查询并回答

访客提出一个一次 API 调用就能回答的问题。规则触发 CALL_API 后接 REPLY_AI。AI 用获取的数据组成有依据的、有上下文的回答。订单状态、账户余额、房间可用性、当前价格、包裹追踪——这些都属于这里。

查询并路由

API 调用返回足够信息以决定下一步。一个高价值账户被升级到资深客服。一个过期的订阅被路由到计费部门。AI 使用 CALL_API 后接 ASSIGN_TO_OPERATOR,基于真实客户数据而非猜测来做路由决策。

多步流程

第一条消息用 SET_VARIABLE 给对话打标,第二条在上下文足够时触发 API 调用,第三条组成答案。当你需要在 ping 后端之前确认意图时,或当数据查询取决于访客两条消息前所说内容时,这非常有用。

内置安全

把后端连接到聊天小工具会让一些团队感到紧张——这是应该的。enuchat 默认提供多层保护:

  • SSRF 防护阻止对 localhost、私有 IP 和内部主机名的调用
  • 5 秒超时防止慢速 API 让对话挂起
  • 租户隔离意味着不会跨租户泄露数据——你的端点只对自己的小工具可见
  • 测试按钮在你将连接和每个端点接入规则之前独立验证它们
  • 加密凭证永远不会以明文返回到仪表板

对你的客户来说有什么变化

聊天从 "让我找个能查的人" 转变为 "已查,答案如下"——以 60+ 种语言中的任何一种,在周日凌晨 3 点,当你的支持团队还在睡觉时。本会放弃购物车、订单或套餐的客户留了下来,因为答案在他们仍在询问时就送达了。

这就是聊天机器人和助手之间的区别。也是你的客户真正能感觉到的区别。

如何开始

如果你已经设置了 enuchat,API 连接位于 设置 → API 连接。挑选一个回答你团队每周打字一百次的问题的端点——订单状态通常是最高效的起点。配置连接,添加端点,连接到规则,然后在上线之前测试一次。完整流程参见 API 连接指南

如果你是 enuchat 新用户,可在 enuchat.com 注册。免费套餐从第一天起就包含 API 连接——无需信用卡、无按对话计费、无试用期到期。

五分钟接入第一个端点。第一个有用的答案通常当天就会到来。

← 返回博客