跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

常见问题

查找有关 Hanc.AI 平台最常见问题的答案。

一般问题​

什么是 Hanc.AI?​

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

我需要技术技能才能使用 Hanc.AI 吗?​

不需要。该平台为没有编程经验的业务用户设计。您通过可视化界面配置代理、用普通语言编写指令,并上传文档以创建知识库。

Hanc.AI 支持哪些语言?​

平台 UI 可用于:

  • 英语 (EN)
  • 德语 (DE)
  • 西班牙语 (ES)
  • 法语 (FR)
  • 意大利语 (IT)
  • 匈牙利语 (HU)

语音代理支持 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 秒,必须显式启用)
  • 情感分析 —— 通话期间分析来电者情感(默认关闭)
  • 通话摘要 —— 通话后生成摘要(默认关闭)
  • 录音 —— 录制通话(默认关闭,请检查当地有关同意的法律)
  • 语言 —— 设置代理的主要语言
  • 退出敏感数据存储 —— 敏感数据的隐私选项

什么是数据检索字段?​

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

  • 文本 —— 自由格式文本(例如来电者姓名、邮箱)
  • 数字 —— 数值(例如预算、数量)
  • 布尔值 —— 是/否值(例如"对演示感兴趣?")
  • 选择器 —— 从预定义选项中选择(例如首选产品)

提取的数据在通话记录中可用,并可通过通话后操作发送到外部系统。

知识库​

什么是知识库?​

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

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

支持的格式:

  • 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 或电话系统。

通话会被录音吗?​

录音是可选的,按代理可配置(recording_enabled 设置,默认关闭)。如果启用:

  • 录音被安全存储
  • 您可以在 Call Logs 中访问它们
  • 请检查当地关于通话录音同意的法律

如果代理无法帮助会发生什么?​

您可以配置升级规则:

  • 转给人工坐席(呼叫转接工具)
  • 留言以回拨
  • 提供替代联系信息
  • 安排预约

网站小组件​

有哪些小组件类型?​

可用四种小组件类型:

  • 浮动通话小组件(hanc-ai-floating-call) —— 页面上的浮动按钮
  • 药丸通话小组件(hanc-ai-pill-call) —— 紧凑的药丸形按钮
  • 内联通话小组件(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 套餐不包含外呼通话,所以无法运行回呼。所有其他小组件类型(Floating、Pill、Inline)在浏览器中运行并保持免费。

国家选择器支持哪些国家?​

选择器涵盖欧洲(EU + DACH + UK)、北美(US + Canada),以及一组精选的广泛支持的其他国家。每个国家都显示国旗、名称,以及电话输入中的母语格式示例占位符。如果您需要的国家未列出,请发邮件至 support@hanc.ai —— 覆盖范围根据需求扩展。

如果访客提交、重新加载页面并再次提交相同号码会发生什么?​

小组件检测到该代理已存在该号码的活跃回呼,并静默重新附加到它。无重复拨号。访客看到他们现有的状态从中断处继续。

为什么小组件说"重新加载页面以进行另一次回呼"?​

小组件在成功提交后自我锁定。这可以防止在通话进行中意外重复提交。如果访客想要进行第二次回呼(不同号码、错过通话后的第二次尝试等),他们重新加载页面,表单将再次新鲜。排队屏幕上的明确"Cancel"按钮释放锁定而无需重新加载。

为什么我的回呼显示"队列已满"?​

单个代理同时处理最多 10 个回呼。如果队列已满,新提交将等待,直到有空闲槽位 —— 小组件显示友好的"我们很快会联系您"消息。随着进行中的通话完成,吞吐量恢复。

我如何更改小组件 UI 语言?​

两种方式:

  • 每个代理默认 —— 打开代理的 Widgets 标签 → 回呼小组件部分 → Widget language。从 14 种支持的语言中选择。
  • 每页覆盖 —— 在 <hanc-ai-callback> 标签上添加 locale="de"(或任何支持的代码)。覆盖胜过代理默认值。

小组件语言仅影响访客在页面上读到的内容 —— 实际的语音对话以代理配置的任何语言进行。

我可以让代理用与小组件 UI 不同的语言回呼吗?​

可以。小组件 UI 语言和代理的语音语言是独立的。多语言着陆页上的法语小组件可以与说英语的代理配对,反之亦然。

最大通话时长设置对回呼有什么作用?​

如果您在代理上设置的最大通话时长小于回呼的安全上限(10 分钟),您的较短设置获胜。如果您设置长于10 分钟,10 分钟的回呼上限仍然适用。大多数回呼场景受益于 3-5 分钟的上限,以保持成本可预测。

操作与工具​

代理在通话期间可以使用哪些工具?​

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

代理在通话后可以执行哪些操作?​

操作用途
Send Email带有通话数据的邮件通知
Send SMS带有通话数据的短信
Send WhatsApp带有通话数据的 WhatsApp 消息
API Call将数据发送到外部系统(CRM、Webhook)

代理可以预订预约吗?​

可以。连接您的 Google 日历并启用 Google Calendar 工具。代理将在通话期间直接检查您的可用性并预订预约。在所有套餐上可用。

Google Calendar 设置包括:

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

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

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

提示词与配置​

什么是提示词?​

提示词是告诉您的代理如何行为的指令集。它定义个性、提供什么信息、如何处理情况以及采取什么操作。

我的提示词应该有多长?​

  • 最小: 10 个字符(系统最低)
  • 最大: 15,000 个字符(系统最高)
  • 推荐: 500-1,000 词以获得全面的行为

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

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

Temperature 控制代理响应的创造性或可预测性:

  • 低(0.1-0.3): 更一致、确定性的响应
  • 中(0.4-0.6): 平衡(推荐用于大多数用途)
  • 高(0.7-1.0): 更多样、创造性的响应

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

我可以更改代理的声音吗?​

可以。您可以从各种声音中选择:

  • 男性或女性
  • 不同的年龄和风格
  • 各种口音
  • 不同的语速

将声音与您的品牌个性匹配。

集成​

有哪些集成可用?​

集成状态套餐
电话号码可用所有
SIP 中继可用所有
Google 日历可用所有
API 密钥可用所有

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

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

故障排查​

我的代理对通话没有响应​

检查这些步骤:

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

代理提供错误信息​

解决方案:

  1. 检查知识库包含正确信息
  2. 验证 KB 已连接到代理
  3. 在提示词中添加明确指令以仅使用 KB
  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非常短欢迎

清单:上线前​

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

相关主题​