集成

集成通过连接到外部服务来扩展您的语音代理。本节涵盖所有可用集成及其配置方法。

可用集成

集成	用途	状态	套餐
Phone Numbers	电话号码和通话	可用	全部
SIP Trunk	自带运营商（sipgate、Placetel、TENIOS、easybell、Zadarma、Twilio BYO、Telnyx、Custom）	可用	全部 — 需要合规审批
Google Calendar	通过 Google 进行预约排期	可用	全部
Outlook Calendar	通过 Microsoft Outlook 进行预约排期	可用	全部
eTermin	实时查询可用时间并预约/改期/取消预约 — 参见 eTermin	可用	全部
resmio	实时将餐桌预订写入您的预订簿 — 参见 resmio	可用	全部
HubSpot CRM	从您的语音代理读写联系人和交易	可用	全部
MCP servers	自带 MCP 兼容的工具服务器，并将其工具暴露给代理 — 参见 MCP 服务器	可用	全部
API Keys	外部应用访问	可用	全部
Webhooks	实时事件通知	可用	全部

所有套餐

日历集成、SIP、HubSpot、MCP 服务器、API 访问和 webhooks 在包括 Free 在内的所有套餐上均可使用。SIP 中继在连接向导解锁前需要一次性的合规审批。

---

电话号码设置

电话号码让您的代理可以接听和拨打真实电话。

设置步骤

1. 在侧边栏中转到 Phone Numbers
2. 点击 "Buy Number"
3. 选择国家和号码类型
4. 完成购买
5. 为该号码分配一个代理

号码在购买后会自动配置并可立即使用。

---

SIP 中继集成

自带 SIP 运营商——HANC 原生支持 SIP，会将来电路由到您的语音代理（并将去电通过您的中继回传）。经过一次性合规审批后，在包括 Free 在内的所有套餐上均可使用。

支持的运营商

HANC 为以下运营商调优了适配器，此外还提供一个用于其他任何情况的通用选项：

运营商	通过 API 自动导入号码	备注
sipgate	是（Personal Access Token）	欧盟 SIP 中继
Placetel	手动	德国 VoIP，Webportal 凭证
TENIOS	手动	欧洲 SIP
easybell	手动	德国运营商，Kundencenter 凭证
Zadarma	是（可选 API 密钥）	全球号码
Twilio (BYO)	是	Account SID + Auth Token
Telnyx	是	由 API 驱动的 SIP 和 DID
Custom SIP trunk	手动	任何其他提供商 — 提供 host、port、transport

合规审批

SIP 运营商连接与去电营销活动共用同一套合规流程。在您的账户获批之前，Connect SIP 按钮会打开一个展示弹窗，列出所有支持的运营商，并带有一个 mailto:support@hanc.ai 的 CTA。审批通常在当个工作日内完成。

设置步骤（审批后）

1. 转到 Phone Numbers → Connect SIP。
2. 选择您的运营商。
3. 输入 SIP 凭证（如果您的运营商支持自动导入，还可输入可选的 API 密钥/密文）。
4. 对于 Custom SIP，还需提供 host、port（默认 5060）和 transport（UDP / TCP / TLS）。
5. 点击 Connect — HANC 会注册您的 SIP 用户，并在受支持的情况下列出您的电话号码。
6. 选择要导入的号码（或按 E.164 手动添加）。
7. 为每个号码分配一个来电和/或去电代理。

何时使用 SIP 而非购买号码

场景	建议
刚接触电话服务	通过 HANC 购买号码（更简单——无合规步骤）
已有 PBX 或运营商合同	通过 SIP 连接——保留您的号码
有严格运营商要求的企业电话	SIP，以获得完全控制
多个区域 / 号码池	SIP，以获得灵活性

---

Google Calendar 集成

连接 Google Calendar，让您的语音代理可以在通话中查询可用时间并预约。

设置步骤

1. 转到 Integration → Calendars
2. 点击 "Connect Google Calendar"
3. 使用 Google 登录
4. 授权 Hanc.AI 访问

请求的权限：

• 查看日历事件（用于查询可用时间）
• 创建日历事件（用于预约）

日历配置

连接后，在您的代理上配置日历工具：

设置	说明
calendar_id	用于排期的 Google 日历
timezone	预约排期的时区（例如 Europe/Vienna）
work_hours	可预约的时间（例如周一至周五 9:00-18:00）
slot_duration	默认预约时长（例如 30 分钟）
buffer	预约之间的间隔时间（例如 15 分钟）

代理中的日历使用

连接并配置后，代理可以：

• 查询特定日期和时间的可用情况
• 自动预约
• 遵守工作时间和间隔时间
• 处理改期请求

对话示例：

Customer: "Can I book an appointment for Tuesday at 3pm?"

Agent: [Checks calendar]
       "Yes, Tuesday at 3pm is available.
        May I have your name to complete the booking?"

---

Outlook Calendar 集成

连接 Microsoft Outlook Calendar，让您的语音代理可以进行预约排期。

设置步骤

1. 转到 Integration → Calendars
2. 点击 "Connect Outlook Calendar"
3. 使用您的 Microsoft 账户登录
4. 授权 Hanc.AI 访问

请求的权限：

• 查看日历事件（用于查询可用时间）
• 创建日历事件（用于预约）

日历配置

连接后，在您的代理上配置日历工具：

设置	说明
Calendar	用于排期的 Outlook 日历
Timezone	预约排期的时区（例如 Europe/Vienna）
Work Hours	可预约的时间（例如周一至周五 9:00-18:00）
Slot Duration	默认预约时长（例如 30 分钟）
Buffer	预约之间的间隔时间（例如 15 分钟）

与 Google Calendar 的区别

从代理的角度来看，两种日历集成的工作方式完全相同。唯一的区别是登录流程——选择您已经在使用的那种日历服务即可。

提示

您可以同时连接 Google 和 Outlook 日历，但每个代理只能使用一个日历工具。

取消预约

预约的来电者会收到一个取消链接。他们无需回电即可直接取消预约。

---

eTermin 预约

连接 eTermin，让您的代理可以在通话中实时查询可用时间并预约、改期或取消预约，直接写入您的 eTermin 日历和服务——并内置防重复预约保护。当您的预约已经存放在 eTermin 中，且您提供各有其时长和规则的不同服务时，请使用 eTermin 而非普通日历。

关于连接步骤、每个代理的配置以及防重复预约保护，请参见完整的 eTermin 页面。

---

resmio 餐桌预订

连接 resmio，让您的代理可以在通话中将餐桌预订直接写入您的预订簿——按时间和用餐人数查询真实可用情况，并处理改期和取消。当您的餐厅已经通过 resmio 接受预订时，请使用 resmio。

关于连接步骤和详情，请参见完整的 resmio 页面。

---

在工作流中通过已连接账户执行操作

除了代理在实时通话中使用的常驻工具外，工作流还有一个专门的 Integration 步骤（在 v2.8 中新增）。将 Integration 步骤放入工作流，即可让它在单个步骤中通过已连接的 Google Calendar、Outlook 或 HubSpot 账户执行操作——例如，作为更大型自动化流程的一部分创建日历事件或更新 HubSpot 交易。该步骤使用您在本页设置的相同账户级连接，因此无需额外授权。

---

HubSpot CRM 集成

连接您的 HubSpot 工作区，让您的语音代理可以在通话期间读写联系人和交易，并让 HANC 内置的 CRM 镜像您的 HubSpot 管道。

它能实现什么

• 实时工具 — HubSpot CRM，位于代理的 Actions 标签页中。代理可以按电话将来电者匹配到某个 HubSpot 联系人、获取交易阶段，并根据实时对话更新属性。参见 动作与工具。
• 管道镜像，在 HANC 的 CRM 中。您的 HubSpot 交易阶段会显示在 Deals 看板中，这样您就能并排查看通话和 HubSpot 上下文。
• 每管道 AI 开关 — 决定允许 AI 在哪些 HubSpot 管道上执行操作；其余全部保持只读。

设置步骤

1. 打开 Integrations 页面并点击 Connect HubSpot。
2. 在您的 HubSpot 账户中授权 HANC。
3. 选择应镜像哪些管道（可在 CRM → Pipeline 设置下查看），以及哪些应允许代理更新阶段。
4. 将 HubSpot CRM 工具添加到任何应在通话中操作 HubSpot 的代理上。

提示

您不必使用 HubSpot 才能使用 HANC 的 CRM。内置 CRM 可独立工作——HubSpot 集成纯粹是为那些已经在使用 HubSpot 且希望两个世界保持同步的组织准备的。

---

MCP 服务器

**模型上下文协议（MCP）**是一个用于将 AI 助手连接到外部工具的开放标准。如果您运行一个 MCP 兼容的服务器，就可以在集成页面上注册一次，让您的代理在对话过程中调用其工具。

设置步骤（概述）

1. 转到 Integration → MCP servers。
2. 点击 Connect MCP server，输入一个标签和您服务器的 HTTPS URL，选择身份验证方式（None 或 Bearer token），然后保存。
3. 打开您想使用这些工具的代理，转到 Actions → Add Action → MCP servers，并开启此代理应使用的连接。

代理会在每次通话开始时发现并使用该服务器的工具。

关于详细设置、故障排查以及 MCP 如何与内置工具并存，请参见完整的 MCP 服务器 页面。

---

API Keys

生成 API 密钥，将 Hanc.AI 与您自己的应用集成。

创建 API 密钥

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

1. 转到 Integration → API Keys
2. 点击 "Create API Key"
3. 输入一个名称（例如 "CRM Integration"）
4. 设置权限（read、write、admin）
5. 立即复制密钥（仅显示一次）

API 密钥安全

重要

• 安全存储密钥（环境变量、密文管理器）
• 切勿将密钥提交到版本控制
• 定期轮换密钥
• 删除未使用的密钥

使用 API 密钥

在 API 请求中包含：

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

API 密钥权限

权限	访问范围
Read	查看代理、通话、分析
Write	创建/修改代理、上传知识库
Admin	所有操作、删除、设置

可用端点

按资源分组的完整 API 端点列表（Calls、Agents、Knowledge Base、Phone Numbers、Voices、Subscription、Customers、Workspaces）存放在其独立页面上：

→ 完整 API 参考

---

Webhooks

配置 webhooks，以接收关于您 Hanc.AI 账户中事件的实时通知。

设置

1. 转到 Integration → Webhooks
2. 输入您的 webhook 端点 URL
3. 选择要订阅的事件
4. 保存配置

Webhooks 会向您的端点发送 HTTP POST 请求，事件数据采用 JSON 格式。

---

通话后动作

通话后动作会在语音代理对话结束后自动触发。请在各个代理上配置这些动作。

可用动作类型

动作	说明
Email	发送通话摘要的电子邮件（发给企业主、客户或两者）
SMS	通话后发送短信通知
WhatsApp	通话后发送 WhatsApp 消息
API Call	带通话数据向外部端点发起 HTTP 请求

设置

1. 转到 Voice Agents → 选择您的代理
2. 打开 Actions 标签页
3. 点击 "Add Action"
4. 选择动作类型并配置：
   • Trigger： 动作何时触发（例如每次通话后、仅在特定结果时）
   • Recipients： 谁接收通知
   • Content： 带通话数据变量的消息模板

---

自定义集成

使用 API

使用 Hanc.AI API 构建自定义集成：

Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON

API 文档

关于完整的可用端点列表，请参见 API 参考。

---

集成最佳实践

安全

• 安全存储凭证
• 定期轮换 API 密钥
• 将权限限制到所需的最小范围

可靠性

• 记录所有集成事件
• 监控集成健康状况

测试

• 先在预发布环境中测试集成
• 验证双向数据流
• 测试错误场景
• 记录集成设置

---

故障排查

集成无法连接

1. 验证凭证是否正确
2. 检查是否有拼写错误
3. 确保第三方账户处于活跃状态
4. 尝试断开连接并重新连接

日历不同步

1. 重新授权日历访问
2. 检查日历权限
3. 验证所选日历是否正确
4. 检查同步延迟（最多 5 分钟）

---

相关主题

• 电话号码 — 电话号码管理
• 语音代理 — 在代理中使用集成
• 分析 — 集成事件跟踪