跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

集成

集成通过连接到外部服务来扩展您的 AI 语音代理。本部分涵盖所有可用的集成以及如何配置它们。

可用集成​

集成用途状态套餐
电话号码电话号码和通话可用所有
SIP 中继带上您自己的运营商(sipgate、Placetel、TENIOS、easybell、Zadarma、Twilio BYO、Telnyx、自定义)可用所有 — 需要合规批准
Google 日历通过 Google 进行预约安排可用所有
Outlook 日历通过 Microsoft Outlook 进行预约安排可用所有
HubSpot CRM从 AI 语音代理读取/写入联系人和交易可用所有
MCP 服务器带上您自己的 MCP 兼容工具服务器并将其工具暴露给代理 — 参阅 MCP 服务器可用所有
API 密钥外部应用程序访问可用所有
Webhook实时事件通知可用所有
所有套餐

日历集成、SIP、HubSpot、MCP 服务器、API 访问和 Webhook 在所有套餐(包括免费套餐)上可用。SIP 中继在连接向导解锁之前需要一次性的合规批准。

电话号码设置​

电话号码允许您的代理接收和拨打真实的电话。

设置步骤​

  1. 转到侧边栏中的电话号码
  2. 点击**"购买号码"**
  3. 选择国家和号码类型
  4. 完成购买
  5. 将代理分配给号码

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

SIP 中继集成​

带上您自己的 SIP 运营商——HANC 原生支持 SIP 并将入站呼叫路由到您的 AI 语音代理(并通过您的中继路由回出站呼叫)。在一次性合规批准后,**所有套餐(包括免费套餐)**可用。

支持的运营商​

HANC 为以下运营商调整了适配器,以及一个用于其他任何运营商的通用选项:

运营商通过 API 自动导入号码备注
sipgate是(个人访问令牌)欧盟 SIP 中继
Placetel手动德国 VoIP,Webportal 凭据
TENIOS手动欧洲 SIP
easybell手动德国运营商,Kundencenter 凭据
Zadarma是(可选 API 密钥)全球号码
Twilio (BYO)是Account SID + Auth Token
Telnyx是API 驱动的 SIP 和 DID
自定义 SIP 中继手动任何其他提供商——提供主机、端口、传输

合规批准​

SIP 运营商连接与出站活动共享相同的合规流程。在您的账户被批准之前,连接 SIP 按钮会打开一个展示模态框,列出所有支持的运营商,并附有 mailto:support@hanc.ai CTA。批准通常在同一工作日。

设置步骤(批准后)​

  1. 转到电话号码 → 连接 SIP。
  2. 选择您的运营商。
  3. 输入 SIP 凭据(以及如果您的运营商支持自动导入的可选 API 密钥/密钥)。
  4. 对于自定义 SIP,还要提供主机、端口(默认 5060)和传输(UDP / TCP / TLS)。
  5. 点击连接 — HANC 注册您的 SIP 用户并在支持的情况下列出您的电话号码。
  6. 选择要导入的号码(或通过 E.164 手动添加)。
  7. 在每个号码上分配呼入和/或呼出代理。

何时使用 SIP 与购买号码​

场景推荐
电话服务新手通过 HANC 购买号码(更简单——无合规步骤)
现有 PBX 或运营商合同通过 SIP 连接——保留您的号码
具有严格运营商要求的企业电话SIP 以获得完全控制
多个区域/号码池SIP 以获得灵活性

Google 日历集成​

连接 Google 日历,以使您的 AI 语音代理能够在通话期间检查可用性并预约。

设置步骤​

  1. 转到集成 → 日历
  2. 点击**"连接 Google 日历"**
  3. 用 Google 登录
  4. 授权 Hanc.AI 访问

请求的权限:

  • 查看日历事件(以检查可用性)
  • 创建日历事件(以预约)

日历配置​

连接后,在您的代理上配置日历工具:

设置描述
calendar_id用于安排的 Google 日历
timezone预约安排的时区(例如,Europe/Vienna)
work_hours预订的可用时间(例如,周一至周五 9:00-18:00)
slot_duration默认预约长度(例如,30 分钟)
buffer预约之间的缓冲时间(例如,15 分钟)

代理中的日历使用​

连接和配置后,代理可以:

  • 检查特定日期和时间的可用性
  • 自动预约
  • 尊重工作时间和缓冲时间
  • 处理重新安排请求

示例对话:

客户:"我可以预约周二下午 3 点吗?"

代理:[检查日历]
       "是的,周二下午 3 点可用。
        请问您的姓名以完成预订?"

Outlook 日历集成​

连接 Microsoft Outlook 日历,以通过您的 AI 语音代理进行预约安排。

设置步骤​

  1. 转到集成 → 日历
  2. 点击**"连接 Outlook 日历"**
  3. 用您的 Microsoft 账户登录
  4. 授权 Hanc.AI 访问

请求的权限:

  • 查看日历事件(以检查可用性)
  • 创建日历事件(以预约)

日历配置​

连接后,在您的代理上配置日历工具:

设置描述
日历用于安排的 Outlook 日历
时区预约安排的时区(例如,Europe/Vienna)
工作时间预订的可用时间(例如,周一至周五 9:00-18:00)
时段时长默认预约长度(例如,30 分钟)
缓冲预约之间的缓冲时间(例如,15 分钟)

与 Google 日历的差异​

从代理的角度来看,两种日历集成的工作方式相同。唯一的区别是登录过程——选择您已经使用的任何日历服务。

提示

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

取消预约​

预订预约的来电者会收到取消链接。他们可以直接取消预约,无需回拨。

HubSpot CRM 集成​

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

启用的功能​

  • 代理的动作选项卡中的实时工具 — HubSpot CRM。代理可以通过电话将来电者与 HubSpot 联系人匹配,获取交易阶段,并从实时对话中更新属性。参阅动作和工具。
  • HANC CRM 中的管道镜像。您的 HubSpot 交易阶段显示在交易看板中,以便您可以并排看到通话和 HubSpot 上下文。
  • 每管道 AI 切换 — 决定 AI 允许在哪些 HubSpot 管道上操作;其他所有内容保持只读。

设置步骤​

  1. 打开集成页面并点击连接 HubSpot。
  2. 在您的 HubSpot 账户中授权 HANC。
  3. 选择哪些管道应该被镜像(在 CRM → 管道设置下可见),以及哪些应该允许代理阶段更新。
  4. 将 HubSpot CRM 工具添加到任何应该在通话期间触及 HubSpot 的代理。
提示

您不必使用 HubSpot 来使用 HANC 的 CRM。内置 CRM 独立工作—— HubSpot 集成纯粹是为已经在 HubSpot 中生活并希望两个世界同步的组织。

MCP 服务器​

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

设置步骤(概述)​

  1. 转到集成 → MCP 服务器。
  2. 点击连接 MCP 服务器,输入标签和您服务器的 HTTPS URL,选择认证(None 或 Bearer 令牌),然后保存。
  3. 打开您想使用工具的代理,转到动作 → 添加动作 → MCP 服务器,然后切换此代理应使用的连接。

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

请参阅完整的 MCP 服务器页面,了解详细设置、故障排除以及 MCP 如何与内置工具配合。

API 密钥​

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

创建 API 密钥​

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

  1. 转到集成 → API 密钥
  2. 点击**"创建 API 密钥"**
  3. 输入名称(例如,"CRM 集成")
  4. 设置权限(读、写、管理员)
  5. 立即复制密钥(仅显示一次)

API 密钥安全​

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

使用 API 密钥​

在 API 请求中包含:

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

API 密钥权限​

权限访问
读查看代理、通话、分析
写创建/修改代理、上传 KB
管理员所有操作、删除、设置

可用端点​

按资源(通话、代理、知识库、电话号码、声音、订阅、客户、工作区)分组的完整 API 端点列表位于自己的页面上:

→ 完整 API 参考

Webhook​

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

设置​

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

Webhook 将 HTTP POST 请求发送到您的端点,事件数据以 JSON 格式提供。

通话后动作​

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

可用动作类型​

动作描述
电子邮件发送通话摘要的电子邮件(给业务所有者、客户或两者)
短信通话后发送短信通知
WhatsApp通话后发送 WhatsApp 消息
API 调用使用通话数据向外部端点发出 HTTP 请求

设置​

  1. 转到 AI 语音代理 → 选择您的代理
  2. 打开动作选项卡
  3. 点击**"添加动作"**
  4. 选择动作类型并配置:
    • 触发器: 何时触发动作(例如,每次通话后、仅在特定结果时)
    • 接收者: 谁接收通知
    • 内容: 带有通话数据变量的消息模板

自定义集成​

使用 API​

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

基本 URL: https://api.hanc.ai/v1
认证: Bearer 令牌(API 密钥)
格式: JSON

API 文档​

请参阅 API 参考了解可用端点的完整列表。

集成最佳实践​

安全​

  • 安全存储凭据
  • 定期轮换 API 密钥
  • 将权限限制为所需的最小值

可靠性​

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

测试​

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

故障排除​

集成无法连接​

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

日历不同步​

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

相关主题​