跳到正文

将 AI 面试连接到你的 ATS、API 或招聘页面.

AI 面试的 ATS 集成、带 Webhook 的公开 API,或嵌入招聘页面的面试:各自能做什么、如何选择,以及如何设置和测试。

更新于 2026年11月17日 · 阅读约 9 分钟

本页内容

简而言之

  • 三种接入方式: 原生 ATS 连接、带 Webhook 的公开 API,或嵌入你招聘页面的面试。可以同时使用多种。
  • ATS: 把 Workable、Greenhouse、Teamtailor、Recruitee 或 Breezy HR 中的职位和阶段关联到已发布的面试。每位移入该阶段的候选人只会被邀请一次,结果以备注形式回传。
  • API: 用限定权限的 API 密钥从你自己的系统创建候选人和邀请,并通过带签名的 Webhook 了解发生了什么。
  • 嵌入: 用一段脚本在你自己的网站中运行面试,仅限你允许的网站。
  • 先测试: 上线前发送 Webhook 测试事件,让测试候选人走过该阶段,并查看投递日志和活动日志。

连接 AI 面试的三种方式

AI 面试的 ATS 集成能让招聘专员免去复制粘贴:从你已在用的系统中邀请候选人,结果也回传到这个系统。如果你的 ATS 没有原生连接,或你通过自己的门户招聘,公开 API 和嵌入只需写一些代码就能实现同样的效果。

  • 原生 ATS 连接。 支持 Workable、Greenhouse、Teamtailor、Recruitee 和 Breezy HR。无需代码:粘贴密钥,关联职位和阶段,把候选人移入该阶段就会发送邀请。
  • 公开 API 和 Webhook。 你的系统通过 REST 创建候选人和邀请并获取结果;有事件发生时,Webhook 会通知它。
  • 嵌入 SDK。 一段脚本即可在你招聘页面的框架中运行面试。它需要邀请链接,因此要配合 API 使用。
视频教程,3:16。 连接 Greenhouse,把某个职位的阶段关联到一场面试,然后是 Slack、API 密钥和 Webhook。 英文讲解,带字幕。

三种方式都需要付费套餐和公司管理员。面试与候选人通过邮件链接打开的完全相同,包括用打字代替说话的选项。

在 ATS、API 和嵌入之间如何选择

原生 ATS 连接公开 API 和 Webhook嵌入 SDK(配合 API)
适合使用五款受支持 ATS 之一的团队其他任何 ATS 或你自己的流程你自己掌控的招聘页面或门户
所需代码无API 调用和一个 Webhook 接收端页面上几行代码,外加 API
触发邀请的方式把候选人移入已关联的阶段你的 API 调用你的 API 调用;链接挂载在你的页面上
结果回传形式ATS 中候选人的一条备注收到结果 Webhook 后由你获取同上;页面只会得知候选人已完成

如果你的 ATS 有原生连接,就从它开始。需要控制邀请谁、何时邀请时,选择 API。希望候选人留在你的网站上时,再加上嵌入。

设置 AI 面试的 ATS 集成

连接 ATS 并关联职位

  1. 发布面试。 只有已发布的面试才能关联到职位。
  2. 打开“集成 → ATS”,点击“连接 ATS”。 粘贴 ATS 的凭据(在哪里找到)。testee 会先用 ATS 验证凭据再保存,然后加密存储,只显示脱敏后的提示。
  3. 设置 Webhook。 Workable 和 Breezy HR 无需任何操作,testee 会自动注册。对于 Greenhouse、Teamtailor 和 Recruitee,请在 ATS 中用连接页 Webhook 卡片上的地址添加 Webhook,并按卡片说明交换密钥。
  4. 关联职位。 “职位”标签页列出 ATS 中开放的职位。打开一个职位,选择已发布的面试和触发邀请的阶段,然后保存。
  5. 标记纽约市的职位 :在关联上勾选后,邀请会附上你的 Local Law 144 告知,并在 10 个工作日后开放。
一个 Workable 连接:它的设置、webhook 以及关联到面试的职位。
一个 Workable 连接:设置、Webhook 卡片,以及各自关联到已发布面试的职位。

每位候选人会经历什么

  • 只邀请一次, 无论 ATS 发送多少次事件。未关联的职位或阶段的事件会被忽略。
  • 固定字段: 候选人的邮箱和姓名、职位和阶段,以及 ATS 中的引用 ID。无需配置字段映射。
  • 结果以备注形式回传: 覆盖度评分(供审阅参考,并非录用决定)、摘要和结果链接。你可以按连接关闭回写。
  • 失败处理: 服务中断会重试约八小时;被拒绝的情况(例如面试分钟数已用完)会显示在日志中。
  • 额外时间 :为提出申请的候选人在仪表板的邀请页面中设置,候选人开始前均可修改。

“暂停”会挂起邀请和备注,直到你恢复。如果之后 ATS 拒绝该密钥,连接会显示“需要重新连接”,备注会等待发送。

使用 AI 面试 API 和 Webhook

公开 REST API 能完成招聘专员在仪表板里做的事:列出已发布的面试、创建候选人、发送邀请并获取结果。参考文档见 AI 面试 API 文档。

API 密钥

  • 创建密钥 :在“集成 → API 密钥”中创建。密钥(aik_live_…)只显示一次,以 Bearer 令牌发送,绝不放在 URL 中。
  • 权限范围: 每个密钥只授予其系统用到的权限,例如 invitations:write 和 results:read。
  • IP 白名单: 最多 50 个地址或地址段,例如你服务器的出站地址。
  • 有效期: 30 天、90 天(默认)、1 年、2 年内的任意日期,或永不过期。列表会提前 7 天提醒。
  • 速率限制: 每个密钥每分钟 120 次请求。
API 密钥标签页:有效和已吊销的密钥,及其权限和 IP 规则。
API 密钥标签页:每个密钥的权限和 IP 规则,已撤销的密钥也会保留备查。

从你的系统邀请候选人

  1. GET /v1/interviews 列出你已发布的面试。
  2. POST /v1/candidates 传入姓名和邮箱。同一邮箱的第二个候选人会被拒绝,所以请保存返回的 id。
  3. POST /v1/invitations 传入两个 id。响应中包含面试链接,只显示一次;testee 也会把链接通过邮件发给候选人。
  4. 发送 Idempotency-Key 请求头 :每个 POST 都要带上。超时后用同一个键重试,不会重复创建任何内容(键的有效期为 24 小时)。
可选的邀请字段作用
externalId你自己的 id(例如职位申请的 id)。它会出现在邀请和每个 Webhook 中
returnUrl完成面试后,候选人会看到一个返回该 https 地址的按钮(嵌入模式下不显示)
extraTime为提出申请的候选人增加 25%、50% 或 100% 的时间;一场面试最长 60 分钟,包括额外时间。API 不会返回该值,Webhook 中也不会发送
nycNotice候选人居住在纽约市:邮件会附上你的告知内容,面试在 10 个工作日后开放
skipSignIn你的网站已让候选人登录:仅凭链接即可打开面试(见嵌入)

Webhook

在“集成 → Webhook”中添加端点:一个公开的 https URL 及其订阅的事件,包括 invitation.created、invitation.opened、invitation.resent、invitation.revoked、invitation.expired、session.started、session.completed、results.failed、review.decision_changed、candidate.erased 和 results.ready。负载只包含 id 和你的 externalId,绝不包含姓名或分数;收到 results.ready 后,调用 GET /v1/sessions/{id}/results 获取结果。

  • 验证每个签名: 签名是用端点密钥对时间戳和原始请求体计算的 HMAC-SHA256。请用恒定时间比较,并拒绝超过 5 分钟的时间戳(Webhook 文档中的代码)。
  • 在 10 秒内返回 2xx。 失败的投递会以退避方式重试约 24 小时。
  • 做好重复和乱序的准备: 跳过已处理过的事件 id,并从 API 读取当前状态。

把面试嵌入你的招聘页面

在招聘页面嵌入面试,可以让候选人留在你的网站上:一段脚本把面试放进框架中,并报告候选人的操作(嵌入 SDK 文档)。

嵌入面试

  1. 允许你的网站 :在“集成 → 嵌入”中添加不带路径的 https 来源,最多 20 个。面试不会在其他任何地方的框架中加载。
  2. 在你的服务器上创建邀请 ,并把链接传给页面。API 密钥绝不放在页面中。
  3. 挂载面试 :调用 TesteeEmbed.mount,传入容器、链接和 onEvent 函数。仪表板的“嵌入”标签页会显示代码片段。
  4. 处理事件: ready、login_required、started、completed、feedback_submitted 和 error,每个事件只带 id。

跳过登录验证码

默认情况下,候选人在框架内用邮件收到的 6 位验证码登录,你的页面看不到这个验证码。如果你的网站已让候选人登录,可以通过 API 创建带 skipSignIn 的邀请,仅凭链接即可打开面试。仪表板无法设置此项。

  • 代价: 链接成了唯一的钥匙,任何拿到它的人都能参加面试。请把有效期控制在一两天内,在候选人开始前才创建邀请,并且只在你自己的登录之后展示。
  • 留档记录: 邀请会显示“已跳过登录”,结果中会注明身份由你公司的网站验证。

上线前先测试

一次测试运行

  1. 使用测试候选人 ,并填写你能收到的邮箱;团队成员的预览不会发送 Webhook。
  2. 发送 Webhook 测试事件 :从端点菜单发送一个带签名的 test.ping,顺便检查你的签名验证代码。
  3. 查看投递日志 :在端点页面上。“重新发送”会用同一 id 再次投递,可检验你是否会跳过重复事件。
  4. 把候选人移入已关联的阶段 ,然后查看 ATS 连接的“活动”标签页:每个事件、邀请和备注的状态为已完成、重试中、失败或已忽略。
  5. 参加面试 ,然后确认收到了 results.ready,或 ATS 中出现了备注。常见问题的解决方法见 ATS 故障排查文档。

安全须知

  • 密钥只留在服务器上, 每个系统一个,只授予所需的权限范围,并设置 IP 白名单和有效期。怀疑泄露的密钥要立即撤销。
  • 先验证,再信任: 拒绝签名或时间戳校验失败的 Webhook,并从 API 读取数据。
  • 只允许你自己的网站 使用嵌入。
  • 邀请链接仅限本人使用: 切勿记录到日志或分享,使用 skipSignIn 时尤其如此。

Slack 通知

在“集成 → Slack”中,通过“添加到 Slack”或传入 Webhook 进行连接,选择要推送的通知(例如结果已就绪),并发送一条测试消息(Slack 文档)。

总结

  • 如果使用五款受支持 ATS 之一, 就用原生连接:把每个职位和阶段关联到已发布的面试。
  • 否则, 使用 API,配合限定权限、会过期的密钥和 Idempotency-Key 请求头,并验证每个 Webhook。
  • 想让候选人留在你的网站上, 就加上嵌入,并且只在你自己的登录之后才跳过登录验证码。
  • 正式上线前, 用一位测试候选人完整跑一遍流程。

常见问题

testee 能与 Greenhouse 或 Workable 集成吗?

能,原生支持,还支持 Teamtailor、Recruitee 和 Breezy HR。你把职位和阶段关联到已发布的面试;每位移入该阶段的候选人只会被邀请一次,结果以备注形式回传。

有 AI 面试 API 吗?

有。REST API 可以创建候选人和邀请、报告其状态,并返回结果、PDF 报告和 CSV 导出。带签名的 Webhook 会在有事件发生时通知你的系统。

我的 ATS 不在支持列表中,还能连接吗?

能,通过 API:候选人进入相应阶段时创建邀请,在邀请上保存你的 externalId,收到 results.ready 后获取结果。

候选人能在我们的招聘页面上参加面试吗?

能,使用嵌入 SDK:在“集成 → 嵌入”中允许你的网站,用 API 创建邀请,再把它挂载到你的页面上。

结果会在 ATS 中推进候选人吗?

不会。testee 从不推进或拒绝候选人。备注中包含覆盖度评分,并注明仅供审阅、不是录用决定;由人来做决定。

ATS 集成检查清单应包含哪些内容?

哪些职位和阶段触发邀请、谁负责管理密钥、如何验证 Webhook、哪些内容回传到 ATS、如何发现失败、如何处理纽约市的候选人和便利安排申请,以及一次测试运行。

来源

  1. testee 开发者文档:ATS 集成
  2. testee 开发者文档:REST API
  3. testee 开发者文档:Webhook
  4. testee 开发者文档:嵌入 SDK
  5. testee 开发者文档:Slack
  6. Standard Webhooks 规范
  7. RFC 2104, HMAC: Keyed-Hashing for Message Authentication

用你的下一个岗位试试看。

几分钟内,根据你的职位描述创建一场结构化 AI 面试。免费 14 天,无需绑定银行卡。