回拨小部件
回拨小部件是一个小型的可嵌入表单,让您的网站访客可以留下他们的电话号码并接收来自您 AI 代理的回拨——通常在几秒钟内。不必让访客拨号,对话会主动找到他们。
这是第五种小部件类型,与浮动、药丸、内嵌和弹窗小部件并列——但工作方式截然不同。其他小部件在浏览器中开始语音对话。回拨小部件通过您的出站号码排队由您的代理拨打的真实电话。
何时使用
| 场景 | 为什么回拨小部件适合 |
|---|---|
| 潜在客户开发着陆页 | 访客通过电话号码作出承诺,代理在下一分钟内对其进行筛选 |
| 高意向产品页面 | "与专家交谈",无需让访客拨号 |
| 移动优先网站 | 在药丸上轻点一次,无权限提示,无需耳机 |
| 非工作时间覆盖 | 访客在下班后留下号码,代理在队列开放时拨号 |
| 与表单相比减少摩擦 | 访客提交单个字段并获得即时回答 |
资格
启用回拨小部件之前,您的账户需要三项条件:
| 要求 | 原因 |
|---|---|
| 付费套餐(Starter 或更高) | 回拨期间消耗的出站分钟按分钟计费 |
| 分配给代理的已验证出站电话号码 | 代理需要一个真实的号码来拨打 |
| 工作区中的已验证电子邮件 | 在解锁出站通话之前确认所有权 |
如果缺少其中任何一项,代理的小部件选项卡中的回拨小部件部分会显示警报,告诉您具体要修复什么。在三项都到位之前,小部件保持禁用。
回拨小部件在免费套餐上不可用,因为它会拨打出站电话。所有其他小部件类型(浮动、药丸、内嵌)仍然免费。
设置
1. 在代理上启用回拨
- 打开您的代理并转到小部件选项卡。
- 滚动到回拨小部件部分。
- 切换**"启用回拨小部件"**开启。
- 配置:
- 重试次数 — 如果访客不接听,代理重试的次数(1–5,默认 3)。
- 重试间隔 — 尝试之间的分钟数(1–30,默认 5)。
- 小部件语言 — 表单、状态消息和国家选择器向您的访客使用的语言(14 种语言可用——见下文)。
- 主题 — 浮动药丸和对话框的配色方案(使用与其他小部件相同的主题调色板)。
- 保存。
小部件的实时预览出现在设置旁边,以便您可以立即看到更改——无需部署来测试外观。
2. 复制嵌入代码片段
在同一部分中,复制 HTML 代码片段:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
将其一次性粘贴到您的网站中,通常就在 </body> 之前。小部件以浮动药丸的形式出现在页面的角落。
@latest 标签意味着您的网站在新小部件版本发布时会自动获取它们。如果您希望对升级有完全控制,请固定到特定版本(例如 hanc-webrtc-widgets@1.4.0)。
访客看到的内容
小部件引导访客通过四种状态:
| 状态 | 访客看到的内容 |
|---|---|
| 表单 | 角落中的浮动药丸。点击打开。左侧国家选择器,右侧电话输入,提交按钮。 |
| 已排队 | "您在队列中——大约 N 秒后我们会致电您。"实时更新。 |
| 正在拨号 | "我们正在致电您。"持续到通话连接或失败。 |
| 已完成 / 失败 | 简短的确认或友好的错误,提示"重新加载页面以进行另一次回拨"。 |
表单根据所选国家的国家格式自动验证电话号码,除非号码可信,否则拒绝提交。
国家覆盖
国家选择器涵盖欧洲(欧盟 + DACH + 英国)、北美(美国 + 加拿大)以及精选的广泛支持的其他国家集合。每个国家显示其国旗、名称和原生格式的示例占位符,以便访客知道要输入什么。
如果您的访客使用的国家未列出,请联系 support@hanc.ai — 覆盖范围会定期扩展。
HTML 属性
小部件在 <hanc-ai-callback> 标签上接受这些属性:
| 属性 | 必需 | 描述 |
|---|---|---|
agent-id | 是 | 您的代理的唯一标识符 |
locale | 否 | 为此页面覆盖小部件的 UI 语言(例如 locale="de")。如果您的网站是多语言的,并且页面区域设置与代理的默认设置不匹配,则非常有用。 |
theme | 否 | 为此页面覆盖颜色主题 |
position | 否 | 浮动药丸锚定的位置(bottom-right、bottom-left、top-right、top-left) |
您省略的任何内容都会回退到您在仪表板中代理上配置的内容。
示例:多语言网站上的德语页面
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
药丸文本、对话框标签、国家选择器和状态消息都切换为德语。代理本身仍然以其配置的任何语言说话——locale 仅影响访客在页面上阅读的内容。
小部件语言
小部件 UI 内置 14 种语言:
| 代码 | 语言 |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
代理按优先级从三个地方选择其语言:
- 嵌入上的
locale="…"属性(最高优先级) - 代理的小部件选项卡中设置的小部件语言
- 英语(默认)
小部件语言仅影响访客阅读的屏幕文本——标签、国家选择器、状态消息。实际的语音对话以您的代理配置的任何语言进行。
重试行为
如果访客在第一次尝试时没有接听,代理会等待配置的间隔并再次拨号——最多达到配置的尝试次数。
- 尝试:1–5(默认 3)
- 间隔:1–30 分钟(默认 5)
小部件向访客显示每次尝试的状态。所有尝试失败后,小部件切换到"我们无法联系到您"状态,附带礼貌消息。
三次尝试,每次间隔五分钟,对大多数潜在客户开发页面效果很好——足够快,以便访客仍在浏览,足够温和,不会感觉强迫。如果您的受众倾向于忽略陌生号码,请增加它。
每次页面加载一次回拨
一旦访客提交了他们的号码,小部件就会在该页面生命周期的其余时间内锁定自己:
- 关闭对话框会收起药丸,但不会重置表单。
- 重新打开显示当前状态(已排队 / 正在拨号 / 已完成 / 失败),而不是新表单。
- 要进行第二次回拨,访客需要重新加载页面。
这可以防止在通话已经在路上时意外重复提交。如果访客从对话框中明确取消其排队的回拨(已排队屏幕上的"取消"按钮),锁定将被释放,他们可以立即重新提交。
如果他们在回拨中途重新加载会怎样?
如果访客在代理仍在重试其号码时重新加载页面,小部件会检测到同一号码的活动回拨已存在并静默重新连接到它——没有重复拨号,没有第二个队列条目。访客只是看到他们现有的状态从中断处继续。
并发和吞吐量
单个代理可以同时进行最多 10 次回拨。超出该数量的提交在队列中等待,并在容量释放时拨号。
代理释放后再拨号的循环持续耗尽队列——如果您没有接近并发上限,大多数访客在提交后几秒内被拨号。
存在每号码速率限制(同一代理每小时只能将一个号码排队几次)以防止滥用。达到此限制的访客会看到友好的"我们将很快与您联系"消息,而不是已排队屏幕。
仪表板中的实时预览
小部件选项卡在设置旁边显示回拨小部件的实时预览。您所做的任何更改——主题、语言、重试数——都会立即更新预览。您无需部署您的网站即可查看小部件的外观。
预览使用具有完整国家列表和演示资格的模拟清单,因此即使在尚未提供出站回拨的套餐上,小部件也会渲染。
嵌入式跟踪
小部件发出与其他小部件相同的 call-start 和 call-end 事件。如果您想触发自己的分析,请在 JavaScript 中监听它们:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// 访客的回拨刚刚连接 — 跟踪为转化
});
widget.addEventListener('call-end', () => {
// 回拨完成 — 跟踪持续时间、结果等
});
套餐可用性
| 套餐 | 回拨小部件 |
|---|---|
| Free | 不可用(需要出站通话) |
| Starter / Pro / Business / Enterprise | 可用 |
所有付费套餐都获得相同的小部件功能集。每次通话费用遵循您的常规出站费率——请参阅计费。