跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

常见问题

在这里找到关于 Hanc.AI 平台最常见问题的答案。

一般问题​

什么是 Hanc.AI？​

Hanc.AI 是一个用于创建 AI 驱动语音代理的平台，这些代理能够自动处理电话通话。你的语音代理可以回答客户问题、预约、转接电话等等——全天候 24/7，无需人工干预。

Hanc.AI 是一个更广阔生态系统的核心，该生态系统还包括 Hanc Studio（一个能从简单描述构建代理的 AI 架构师）、Hanc Voice（语音合成与克隆）以及 Hanc Phone（一个内置实时 AI 代理的浏览器电话）。参见 Hanc 生态系统。

想在注册前先四处看看？一个只读交互式演示让你无需创建账户即可探索仪表板。

使用 Hanc.AI 需要技术技能吗？​

不需要。该平台是为没有编程经验的业务用户设计的。你通过可视化界面配置代理、用大白话编写指令，并上传文档来创建知识库。

Hanc.AI 支持哪些语言？​

平台界面提供 14 种语言：

  • English (EN)、German (DE)、Czech (CS)、Spanish (ES)、French (FR)、Hungarian (HU)、Italian (IT)、Kazakh (KK)、Polish (PL)、Portuguese (PT)、Russian (RU)、Turkish (TR)、Ukrainian (UK)、Chinese (ZH)

语音代理支持 25 种语言。你可以为每个代理单独设置语言。代理还能在通话中自动切换语言，以匹配来电者。

AI 如何理解来电者？​

你说话，AI 理解你的用词、处理其含义，并用语音自然地回应。平台在幕后处理了所有复杂性，使对话感觉自然流畅。

账户与账单​

我如何创建账户？​

注册流程以电话优先——你的电话号码是你的主要标识符：

  1. 访问 Hanc.AI 网站
  2. 点击 "Sign Up" 或 "Get Started"
  3. 输入你的电话号码
  4. 用短信发送的验证码进行验证。如果你的号码是无法接收短信的固定电话，验证码会改由自动语音呼叫送达
  5. 添加你的邮箱并完善个人资料

如果你的号码完全无法使用（参见我的电话号码为什么被拒绝？），系统会请你换一个。

有哪些套餐可选？​

Hanc.AI 提供五个套餐层级：

  • Free——一次性信用额度发放，1 个代理上限。适合测试。
  • Starter——每月信用额度，无限代理。适合小型企业。
  • Pro——更多信用额度，更低的每分钟费率。适合成长中的企业。
  • Business——高额信用额度、优先支持、99.9% SLA。适合成熟企业。
  • Enterprise——定制定价、专属客户经理、白标、SSO/SAML。适合大型组织。

年度账单可享受相比按月付费的折扣。当前定价请前往 Settings > Billing 查看。

基于信用额度的计费如何运作？​

每个套餐都包含每月信用额度（package_credits）。所有使用量都会从你的信用额度余额中按以下类别扣除：

  • 电话通话信用额度——电话通话的每分钟费用
  • 网页通话信用额度——小组件通话的每分钟费用（通常费率更低）
  • 短信信用额度——作为通话后动作发送的每条短信
  • 呼叫转接信用额度——每次转接给人工的通话
  • 电话号码信用额度——每个启用电话号码的每月费用

价格以你的所在地区货币显示（不仅限于 USD 或 EUR）。未使用的信用额度会结转到下一个计费周期。

我可以更改套餐吗？​

可以。升级立即生效（按比例计费）。降级在下一个计费周期生效。前往 Settings > Billing 更改你的套餐。

接受哪些付款方式？​

  • 信用卡/借记卡（Visa、Mastercard、American Express）——通过 Stripe
  • 银行转账（仅限 Enterprise）

未使用的信用额度会结转吗？​

会。未使用的信用额度会结转到下一个计费周期。只要你的账户处于活跃状态，它们永不过期。

语音代理​

什么是语音代理？​

语音代理是一个由 AI 驱动的虚拟助手，负责处理电话对话。它接听来电、理解来电者的需求、从你的知识库提供信息，并能执行诸如预约或转接电话等动作。

我可以创建多少个代理？​

  • Free 套餐： 1 个代理
  • 付费套餐（Starter、Pro、Business、Enterprise）： 无限代理

一个代理能处理多个电话号码吗？​

可以。如果多个电话号码都应表现出相同的行为，你可以把它们全部分配给单个代理。

我可以为不同用途设置不同的代理吗？​

可以。许多企业为以下用途使用独立的代理：

  • 销售咨询
  • 客户支持
  • 预约
  • 非工作时间接待

我可以复制一个代理吗？​

可以。使用复制功能可克隆一个现有代理，连同它的所有设置、提示词和配置。这对于创建变体或测试更改很有用。

我如何在上线前测试我的代理？​

  1. 使用仪表板中的 "Talk to Agent" 按钮
  2. 在浏览器中允许麦克风访问
  3. 自然地说话并测试各种场景
  4. 每次测试通话后查看转录

来电者能察觉到自己在和 AI 对话吗？​

现代语音代理听起来非常自然，但我们建议对来电者保持透明。许多企业会在问候语中简短提及："您好，您已接通我们的虚拟助手……"

我可以配置哪些通话设置？​

每个代理都有可配置的通话设置：

  • 提醒触发——来电者沉默时代理发送提醒前的等待时间（默认：30 秒）
  • 最大提醒次数——代理结束通话前的最大提醒次数（默认：3 次）
  • 沉默后结束通话——在持续沉默后自动结束通话（默认：10 秒，必须显式启用）
  • 情感分析——在通话中分析来电者情感（默认关闭）
  • 通话摘要——在通话后生成摘要（默认关闭）
  • 录音——录制通话（默认关闭，请查阅当地关于同意的法律）
  • 语言——设置代理的主要语言
  • 选择退出敏感数据存储——针对敏感数据的隐私选项

什么是数据检索字段？​

数据检索字段让你的代理能从对话中提取结构化信息。支持的类型：

  • 文本——自由格式文本（如来电者姓名）
  • 数字——数值（如预算、数量）
  • 邮箱——经校验的电子邮件地址
  • 电话——经校验的电话号码
  • 选择器——从预定义选项中选择（如首选产品）
  • 复选框——是/否值（如"有意参加演示？"）

提取的数据可在通话记录中查看，并可通过通话后动作发送到外部系统。

知识库​

什么是知识库？​

知识库是你的代理用于回答问题的信息集合。它包含你的业务详情、FAQ、产品信息、政策，以及来电者可能问到的任何其他内容。

我可以上传哪些文件格式？​

支持的格式：

  • PDF (.pdf)
  • Word 文档 (.docx, .doc)
  • Excel 文件 (.xlsx, .xls)
  • 文本文件 (.txt)
  • Markdown (.md)
  • HTML (.html)
  • CSV (.csv)
  • RTF (.rtf)
  • JSON (.json)

我的知识库可以有多大？​

  • 单个文件：每个最大 10 MB
  • 每个知识库最多 10 个文件

我应该多久更新一次知识库？​

在以下情况更新你的知识库：

  • 价格变动
  • 营业时间变动
  • 新增产品/服务
  • 政策更新
  • 你注意到代理提供了过时信息

我可以批量导入知识库吗？​

可以。使用 ZIP 导入功能可一次上传多个知识库文件。详见导入知识库。

为什么我的代理没有使用知识库？​

检查这些常见问题：

  1. 知识库未连接到代理（Agent Settings > Knowledge Base）
  2. 信息结构不清晰
  3. 内容与客户提问的方式不匹配
  4. 文件上传失败或仍在处理中

电话号码与通话​

我需要有自己的电话号码吗？​

你有三个选择：

  1. 购买号码——直接通过平台购买
  2. 导入现有号码——连接你已拥有的电话号码
  3. 连接 SIP——使用你现有的 SIP 中继提供商

我可以使用 SIP 中继吗？​

可以。SIP 中继集成在包括 Free 在内的所有套餐上均可用。通过 SIP 连接你现有的 PBX 或电话系统。

我的电话号码为什么被拒绝？​

为保障你的安全，Hanc.AI 会屏蔽常被用于话费欺诈的号码类型。如果你看到 "this number can't be used, try another"（此号码无法使用，请换一个），说明该号码属于以下之一：

  • 高费率或共享费用号码（如 0900 / 0180 类号码）——始终被屏蔽
  • 结构上无效的号码——长度或格式与该国家/地区不符
  • 某些固定电话——运营商查询失败

解决办法很简单，换一个号码即可——手机号或普通固定电话号码几乎总能通过。无法接收短信的固定电话会改用自动语音呼叫进行验证，验证码会以你的界面语言送达。

通话会被录音吗？​

录音是可选的，可按代理配置（recording_enabled 设置，默认关闭）。如果启用：

  • 录音会被安全存储
  • 你可以在通话记录中访问它们
  • 请查阅当地关于通话录音同意的法律

如果代理帮不上忙会怎样？​

你可以配置升级规则：

  • 转接给人工坐席（呼叫转接工具）
  • 记录留言以便回拨
  • 提供其他联系方式
  • 安排预约

网站小组件​

有哪些小组件类型？​

有五种小组件类型：

  • 浮动通话小组件（hanc-ai-floating-call）——页面上的浮动按钮
  • 胶囊通话小组件（hanc-ai-pill-call）——紧凑的胶囊形按钮
  • 胶囊浮动通话小组件——与 Pill 相同的紧凑胶囊形状，但它像浮动小组件一样随页面跟随访客
  • 内联通话小组件（hanc-ai-inline-call）——直接嵌入你的页面布局中
  • 回拨小组件（hanc-ai-callback）——一个收集访客电话号码的表单；你的代理会回拨给他们。它与其他小组件不同——它发起的是真实的外呼电话，而非启动浏览器语音通话。参见下面的回拨小组件部分。

有哪些颜色主题？​

小组件支持 12 种颜色主题，可从仪表板配置：

Default、Purple、Blue、Cyan、Emerald、Amber、Tangerine、Rose、Ember、Black、White 以及 Tangerine Neon。

通过小组件元素上的 theme 属性，或通过仪表板中代理的小组件设置来设定主题。

小组件会发出哪些事件？​

小组件会发出可供你监听以进行集成的事件：

  • status-changed——当内部 LiveKit 连接状态改变时触发。状态包括：idle、connecting、connected、agent-connected、disconnecting、disconnected、error
  • call-start——通话开始时触发
  • call-end——通话结束时触发
  • state-change——小组件状态改变时触发。状态包括：idle、connecting、active、ending、error
  • error——出错时触发
  • audio-track——接收到远端音轨时触发
  • local-audio-track——创建本地音轨时触发

小组件有哪些技术要求？​

小组件需要：

  • WebGL 2.0（用于球体动画）
  • Web Audio API
  • WebRTC（用于实时语音通信）

回拨小组件​

为什么回拨小组件需要付费套餐？​

回拨小组件会发起真实的外呼电话——每次回拨都会消耗你套餐中的外呼分钟数。Free 套餐不包含外呼，因此无法运行回拨。所有其他小组件类型（浮动、胶囊、内联）都在浏览器中运行，且保持免费。

国家/地区选择器支持哪些国家/地区？​

该选择器涵盖欧洲（EU + DACH + UK）、北美（US + Canada），以及一组精选的、广泛受支持的额外国家/地区。每个国家/地区都会在电话输入框中显示国旗、名称和一个原生格式的示例占位符。如果你需要的国家/地区未列出，请发邮件至 support@hanc.ai——覆盖范围会根据需求扩展。

如果访客提交后刷新页面又再次提交相同号码会怎样？​

小组件会检测到该代理已存在一个针对该号码的活跃回拨，并静默地重新关联到它。不会重复拨号。访客会看到其现有状态从中断处继续。

为什么小组件显示 "Reload the page to make another callback"（刷新页面以发起另一次回拨）？​

小组件在成功提交后会锁定自己。这可防止在通话进行中意外重复提交。如果访客想发起第二次回拨（不同号码、未接来电后再次尝试等），他们刷新页面后表单会重新变为可用。排队界面上明确的 "Cancel" 按钮无需刷新即可释放锁定。

为什么我的回拨显示 "Queue full"（队列已满）？​

单个代理最多同时处理 10 个回拨。如果队列已满，新提交会等待直到有空位释放——小组件会显示一条友好的 "we'll be in touch shortly"（我们很快就会联系您）消息。随着进行中的通话完成，处理能力会恢复。

我如何更改小组件的界面语言？​

有两种方式：

  • 按代理设置默认值——打开代理的 Widgets 选项卡 → 回拨小组件部分 → 小组件语言。从 14 种受支持语言中选择。
  • 按页面覆盖——在 <hanc-ai-callback> 标签上添加 locale="de"（或任意受支持的代码）。覆盖设置会优先于代理默认值。

小组件语言只影响访客在页面上看到的文字——实际的语音对话会以代理被配置说的那种语言进行。

我可以让代理用与小组件界面不同的语言回拨吗？​

可以。小组件界面语言和代理的说话语言是相互独立的。一个法语小组件放在多语言落地页上，可以搭配一个说英语的代理，反之亦然。

最大通话时长设置对回拨有什么影响？​

如果你为代理设置的最大通话时长小于回拨的安全上限（10 分钟），你设置的较短值优先。如果你设置的值大于 10 分钟，则 10 分钟的回拨上限仍然适用。大多数回拨场景受益于 3-5 分钟的上限，以保持成本可预测。

动作与工具​

代理在通话中可以使用哪些工具？​

工具用途套餐
呼叫转接转接给人工所有套餐
Google Calendar / Outlook检查可用时段并预约所有套餐
API Tool RAG从 API 获取实时数据所有套餐
HubSpot CRM在通话中读写 HubSpot 联系人和交易所有套餐
代理转接将通话交给你账户上的另一个语音代理所有套餐
MCP 服务器从你注册的 MCP 服务器暴露工具——见 MCP 服务器所有套餐

代理在通话后可以执行哪些动作？​

动作用途
发送邮件带通话数据的邮件通知
发送短信带通话数据的短信
发送 WhatsApp带通话数据的 WhatsApp 消息
API 调用将数据发送到外部系统（CRM、Webhook）

代理可以预约吗？​

可以。连接你的 Google Calendar 并启用 Google Calendar 工具。代理会检查你的可用时段，并在通话中直接预约。在所有套餐上均可用。

Google Calendar 设置包括：

  • 时段时长： 15、30、45、60、75、90、105 或 120 分钟
  • 工作时间： 可配置的开始和结束时间（默认 09:00-18:00）
  • 工作日： 可配置（默认周一至周五）
  • 时区： 可按日历配置

代理可以预订到专用预订系统吗？​

可以。除了 Google 和 Outlook Calendar，Hanc.AI 还连接到专门的预订服务——eTermin（通用预约排期）和 resmio（餐厅和酒店餐饮预订）。连接后，代理会在通话中检查可用性并直接预订到该系统，就像它对日历所做的那样。

代理可以发送 WhatsApp 消息吗？​

可以。为你的代理添加一个 "Send WhatsApp" 动作。配置消息模板、收件人号码和触发条件。WhatsApp 消息可以包含从对话中提取的检索变量。

CRM​

Hanc.AI 有内置 CRM 吗？​

有。Hanc.AI 包含一个内置 CRM，让你的通话自动转化为结构化记录。它追踪：

  • 联系人——你的代理交谈过的人，附带他们的详情和历史
  • 交易——在各阶段流转的商机管道
  • 提醒——与联系人或交易关联的跟进任务
  • 建议——基于你的对话由 AI 生成的下一步推荐

代理可以在通话中和通话后读写 CRM，因此一次预约或一个合格线索会更新你的记录，无需手动录入数据。这个内置 CRM 与可选的 HubSpot CRM 集成是分开的，后者与外部 HubSpot 账户同步。

提示词与配置​

什么是提示词？​

提示词是告诉你的代理如何表现的一组指令。它定义了性格、要提供哪些信息、如何处理各种情况以及采取哪些动作。

我的提示词应该多长？​

  • 最少： 10 个字符（系统下限）
  • 最多： 15,000 个字符（系统上限）
  • 推荐： 500-1,000 字，以实现全面的行为

质量比长度更重要。要具体而清晰。

代理设置中的 "temperature" 是什么？​

Temperature 控制代理响应的创造性或可预测程度：

  • 低（0.1-0.3）： 更一致、更确定的响应
  • 中（0.4-0.6）： 均衡（推荐用于大多数场景）
  • 高（0.7-1.0）： 更多样、更有创造性的响应

对于业务用途，较低的 temperature 通常更好。

我可以更改代理的语音吗？​

可以。你可以从多种语音中选择：

  • 男声或女声
  • 不同年龄和风格
  • 各种口音
  • 不同的说话速度

让语音契合你的品牌性格。

集成​

有哪些集成可用？​

集成状态套餐
Phone Numbers可用所有
SIP Trunk可用所有——需要合规审批
Google Calendar可用所有
Outlook Calendar可用所有
HubSpot CRM可用所有
MCP 服务器可用所有
API Keys可用所有
Webhooks可用所有

我可以创建多少个 API 密钥？​

每位用户最多可创建 3 个 API 密钥。

故障排查​

我的代理没有响应来电​

检查这些步骤：

  1. 代理已设为 "Active" 状态
  2. 电话号码已分配给代理
  3. 电话连接（或 SIP 中继）处于活跃状态
  4. 首条消息已配置
  5. 你的信用额度余额有资金

代理提供错误信息​

解决方法：

  1. 检查知识库是否包含正确信息
  2. 核实知识库已连接到代理
  3. 在提示词中添加明确指令，只使用知识库
  4. 降低 temperature 设置（0.3-0.5）

通话质量差​

尝试这些修复：

  1. 检查你的网络连接（推荐 5+ Mbps）
  2. 查看平台状态页面
  3. 尝试其他语音选项
  4. 进行浏览器测试时，使用有线连接

我无法登录我的账户​

解决步骤：

  1. 核实电子邮件地址是否正确
  2. 尝试用 "Forgot Password" 重置
  3. 清除浏览器缓存和 Cookie
  4. 尝试无痕/隐私模式
  5. 如问题持续存在，请联系支持团队

安全与隐私​

我的数据安全吗？​

安全。平台使用：

  • 静态数据的 AES-256 加密
  • 传输中数据的 TLS 1.3 加密
  • 安全的云基础设施（欧盟数据中心）
  • 定期安全审计
  • 带电话验证的 Firebase 身份验证

谁可以访问我的通话录音？​

只有你组织内拥有相应权限的用户才能访问录音。你通过团队管理设置和基于角色的权限（Owner、Admin、Member）来控制访问。

平台符合 GDPR 吗？​

符合。平台遵守 GDPR 要求：

  • 提供数据处理协议
  • 支持删除权
  • 提供数据导出
  • 针对录音的隐私控制
  • 选择退出敏感数据存储选项

我可以删除我的数据吗？​

可以。你能够：

  • 删除单条通话录音
  • 清空知识库内容
  • 删除代理
  • 请求完全删除账户

获取帮助​

我如何联系支持团队？​

  • 邮箱： support@hanc.ai
  • 标准响应： 24 小时内
  • Pro/Business 响应： 4 小时内

我在哪里可以找到教程？​

  • 本文档
  • 设置指南与模板——可下载的指南
  • 视频教程（如有）
  • 应用内工具提示和指南

我可以请求新功能吗？​

可以！将功能请求发送至 support@hanc.ai。我们会积极考虑用户反馈用于产品开发。

有社区或论坛吗？​

请查看 Hanc.AI 网站以获取社区资源和更新。

快速参考​

常见使用场景的推荐设置​

使用场景Temperature响应长度语音风格
客户支持0.3-0.4短平静、乐于助人
销售0.5-0.6中等有活力、友好
预约0.3-0.4短专业
接待0.3-0.5非常短热情

检查清单：上线之前​

  • 代理提示词完整且已测试
  • 知识库已上传并连接
  • 首条消息听起来自然
  • 升级规则已配置
  • 电话号码已分配
  • 测试通话成功完成
  • 团队成员拥有相应访问权限

相关主题​