Singkatnya
- Tiga cara: koneksi ATS bawaan, API publik dengan webhook, atau wawancara yang disematkan di halaman karier Anda. Anda bisa memakai lebih dari satu.
- ATS: tautkan lowongan dan tahap di Workable, Greenhouse, Teamtailor, Recruitee, atau Breezy HR ke wawancara yang dipublikasikan. Setiap kandidat yang dipindahkan ke tahap itu diundang sekali, dan hasilnya dikirim kembali sebagai catatan.
- API: buat kandidat dan undangan dari sistem Anda sendiri dengan kunci API yang dibatasi izinnya, dan ketahui apa yang terjadi lewat webhook bertanda tangan.
- Embed: jalankan wawancara di dalam situs Anda sendiri dengan satu skrip, dari situs yang Anda izinkan.
- Uji dulu: kirim peristiwa uji webhook, pindahkan kandidat uji melewati tahapnya, dan baca log pengiriman serta log aktivitas sebelum mulai digunakan.
Tiga cara menghubungkan wawancara AI
Integrasi ATS untuk wawancara AI membebaskan rekruter Anda dari salin-tempel: kandidat diundang dari sistem yang sudah Anda pakai, dan hasilnya kembali ke sana. Jika ATS Anda belum punya koneksi bawaan, atau Anda merekrut lewat portal sendiri, API publik dan embed melakukan hal yang sama dengan sedikit kode.
- Koneksi ATS bawaan. Workable, Greenhouse, Teamtailor, Recruitee, dan Breezy HR. Tanpa kode: tempelkan kunci, tautkan lowongan dan tahap, dan memindahkan kandidat ke tahap itu akan mengirim undangan.
- API publik dan webhook. Sistem Anda membuat kandidat dan undangan lewat REST dan mengambil hasilnya; webhook memberi tahu sistem saat sesuatu terjadi.
- SDK embed. Satu skrip menjalankan wawancara dalam frame di halaman karier Anda. Embed memerlukan tautan undangan, jadi dipakai bersama API.
Ketiganya memerlukan paket berbayar dan admin perusahaan. Wawancaranya sama dengan yang diterima kandidat dari tautan email, termasuk pilihan untuk mengetik alih-alih berbicara.
Memilih antara ATS, API, dan embed
| Koneksi ATS bawaan | API publik dan webhook | SDK embed (dengan API) | |
|---|---|---|---|
| Paling cocok untuk | Tim yang memakai salah satu dari lima ATS yang didukung | ATS lain atau alur kerja Anda sendiri | Halaman karier atau portal yang Anda kelola |
| Perlu kode | Tidak ada | Panggilan API dan penerima webhook | Beberapa baris di halaman, ditambah API |
| Pemicu undangan | Memindahkan kandidat ke tahap yang ditautkan | Panggilan API Anda | Panggilan API Anda; tautannya dipasang di halaman Anda |
| Hasil kembali sebagai | Catatan pada kandidat di ATS | Hasil yang Anda ambil setelah webhook hasil | Sama; halaman hanya tahu bahwa kandidat sudah selesai |
Mulailah dengan koneksi bawaan jika ATS Anda memilikinya. Pilih API jika Anda perlu mengendalikan siapa yang diundang dan kapan. Tambahkan embed jika kandidat sebaiknya tetap berada di situs Anda.
Menyiapkan integrasi ATS untuk wawancara AI
Hubungkan ATS dan tautkan lowongan
- Publikasikan wawancaranya. Hanya wawancara yang sudah dipublikasikan yang dapat ditautkan ke lowongan.
- Buka Integrasi → ATS lalu tekan Hubungkan ATS. Tempelkan kredensial ATS (cara menemukannya). testee mencobanya ke ATS sebelum menyimpan, lalu menyimpannya dalam bentuk terenkripsi dan hanya menampilkan petunjuk yang disamarkan.
- Siapkan webhook. Workable dan Breezy HR tidak perlu apa-apa: testee yang mendaftarkannya. Untuk Greenhouse, Teamtailor, dan Recruitee, tambahkan webhook di ATS dengan alamat dari kartu Webhook pada koneksi tersebut, lalu tukarkan rahasianya sesuai petunjuk di kartu.
- Tautkan lowongan. Tab Lowongan menampilkan lowongan terbuka di ATS. Buka salah satunya, pilih wawancara yang sudah dipublikasikan dan tahap yang mengirim undangan, lalu simpan.
- Tandai lowongan di New York City pada tautannya, agar undangan memuat pemberitahuan Local Law 144 Anda dan baru terbuka 10 hari kerja kemudian.


Yang terjadi untuk setiap kandidat
- Diundang sekali saja, berapa kali pun ATS mengirim peristiwanya. Peristiwa untuk lowongan atau tahap yang belum Anda tautkan diabaikan.
- Kolom tetap: email dan nama kandidat, lowongan dan tahapnya, serta referensi ATS. Tidak ada pemetaan yang perlu dikonfigurasi.
- Hasil sebagai catatan: skor cakupan (untuk ditinjau, bukan keputusan rekrutmen), ringkasan, dan tautan ke hasil. Anda dapat menonaktifkan pengiriman balik ini per koneksi.
- Kegagalan: gangguan layanan dicoba ulang selama sekitar delapan jam; penolakan, misalnya karena menit wawancara habis, muncul di log.
- Waktu tambahan bagi kandidat yang memintanya diatur di halaman undangan di dasbor, selama kandidat belum mulai.
Jeda menahan undangan dan catatan sampai Anda melanjutkannya. Jika ATS kemudian menolak kuncinya, koneksi menampilkan Perlu dihubungkan ulang dan catatan menunggu.
Menggunakan API dan webhook wawancara AI
REST API publik melakukan hal yang sama seperti rekruter di dasbor: menampilkan wawancara yang dipublikasikan, membuat kandidat, mengundang mereka, dan mengambil hasilnya. Referensinya ada di dokumentasi API wawancara AI.
Kunci API
- Buat kunci di Integrasi → Kunci API. Rahasianya (aik_live_…) hanya ditampilkan sekali dan dikirim sebagai bearer token, tidak pernah di dalam URL.
- Cakupan izin: beri setiap kunci hanya izin yang dipakai sistemnya, misalnya invitations:write dan results:read.
- Daftar IP yang diizinkan: hingga 50 alamat atau rentang, misalnya alamat keluar server Anda.
- Masa berlaku: 30 hari, 90 hari (default), 1 tahun, tanggal hingga 2 tahun ke depan, atau tanpa batas. Daftar kunci memberi peringatan 7 hari sebelumnya.
- Batas permintaan: 120 permintaan per menit untuk setiap kunci.


Mengundang kandidat dari sistem Anda
- GET /v1/interviews menampilkan wawancara Anda yang sudah dipublikasikan.
- POST /v1/candidates dengan nama dan email. Kandidat kedua dengan email yang sama akan ditolak, jadi simpan id-nya.
- POST /v1/invitations dengan kedua id tersebut. Respons berisi tautan yang hanya ditampilkan sekali; testee juga mengirimkannya ke kandidat lewat email.
- Kirim header Idempotency-Key pada setiap POST. Percobaan ulang dengan kunci yang sama setelah timeout tidak membuat apa pun dua kali (kunci berlaku 24 jam).
| Kolom undangan opsional | Fungsinya |
|---|---|
| externalId | Id milik Anda sendiri (misalnya lamaran kerjanya). Id ini dikembalikan pada undangan dan di setiap webhook |
| returnUrl | Setelah selesai, kandidat melihat tombol untuk kembali ke alamat https ini (tidak di dalam embed) |
| extraTime | Tambahan waktu 25, 50, atau 100 persen bagi kandidat yang memintanya; wawancara berlangsung paling lama 60 menit, termasuk waktu tambahan. Tidak pernah dikembalikan oleh API atau dikirim dalam webhook |
| nycNotice | Kandidat tinggal di New York City: email memuat pemberitahuan Anda, dan wawancara baru terbuka 10 hari kerja kemudian |
| skipSignIn | Situs Anda sudah memproses masuk kandidat: tautannya saja sudah membuka wawancara (lihat embed) |
Webhook
Tambahkan endpoint di Integrasi → Webhook: URL https publik beserta peristiwanya, yaitu invitation.created, invitation.opened, invitation.resent, invitation.revoked, invitation.expired, session.started, session.completed, results.failed, review.decision_changed, candidate.erased, dan results.ready. Payload hanya berisi id dan externalId Anda, tidak pernah nama atau skor; saat results.ready, ambil GET /v1/sessions/{id}/results.
- Verifikasi setiap tanda tangan: HMAC-SHA256 dari timestamp dan body mentah, dengan rahasia endpoint sebagai kuncinya. Bandingkan dalam waktu konstan dan tolak timestamp yang lebih dari 5 menit (kode di dokumentasi webhook).
- Balas dengan 2xx dalam 10 detik. Kegagalan dicoba ulang dengan backoff selama sekitar 24 jam.
- Siap menerima pengulangan dan urutan acak: lewati id peristiwa yang sudah Anda tangani, dan baca status terkini dari API.
Menyematkan wawancara di halaman karier Anda
Embed wawancara di halaman karier membuat kandidat tetap berada di situs Anda: satu skrip menempatkan wawancara dalam frame dan melaporkan apa yang dilakukan kandidat (dokumentasi SDK embed).
Sematkan wawancara
- Izinkan situs Anda di Integrasi → Sematkan: origin https tanpa path, hingga 20. Wawancara tidak akan dimuat dalam frame di tempat lain.
- Buat undangan di server Anda lalu teruskan tautannya ke halaman. Kunci API tidak pernah dimasukkan ke halaman.
- Pasang dengan TesteeEmbed.mount: sebuah container, tautannya, dan fungsi onEvent. Tab Sematkan di dasbor menampilkan cuplikan kodenya.
- Tangani peristiwanya: ready, login_required, started, completed, feedback_submitted, dan error, masing-masing hanya berisi id.
Melewati kode masuk
Secara default, kandidat masuk di dalam frame dengan kode 6 digit yang dikirim lewat email; halaman Anda tidak pernah melihatnya. Jika situs Anda sudah memproses masuk kandidat, buat undangan lewat API dengan skipSignIn, dan tautannya saja sudah membuka wawancara. Opsi ini tidak dapat diatur dari dasbor.
- Konsekuensinya: tautan menjadi satu-satunya kunci, sehingga siapa pun yang memilikinya bisa mengikuti wawancara. Batasi masa berlakunya satu atau dua hari, buat undangan tepat sebelum kandidat mulai, dan tampilkan hanya di balik proses masuk Anda sendiri.
- Dalam catatan: undangan menampilkan “Proses masuk dilewati”, dan hasilnya menyebutkan bahwa identitas diverifikasi oleh situs perusahaan Anda.
Uji sebelum mulai digunakan
Uji coba
- Gunakan kandidat uji dengan email yang dapat Anda baca; pratinjau oleh anggota tim tidak mengirim webhook.
- Kirim peristiwa uji webhook dari menu endpoint: test.ping bertanda tangan, sehingga kode verifikasi tanda tangan Anda ikut teruji.
- Baca log pengiriman di halaman endpoint. Kirim ulang mengirimkan lagi sebuah pengiriman dengan id yang sama, untuk menguji bahwa Anda melewati pengulangan.
- Pindahkan kandidat ke tahap yang ditautkan dan periksa tab Aktivitas pada koneksi ATS: setiap peristiwa, undangan, dan catatan berstatus selesai, dicoba ulang, gagal, atau diabaikan.
- Ikuti wawancaranya dan pastikan results.ready sudah tiba, atau catatan muncul di ATS. Solusi untuk masalah umum ada di dokumentasi pemecahan masalah ATS.
Catatan keamanan
- Kunci tetap di server, satu per sistem, hanya dengan izin yang dibutuhkan, daftar IP yang diizinkan, dan masa berlaku. Cabut kunci yang Anda curigai bocor.
- Verifikasi dulu, baru percaya: tolak webhook yang tanda tangan atau timestamp-nya gagal diverifikasi, dan baca datanya dari API.
- Izinkan hanya situs Anda sendiri untuk embed.
- Tautan undangan bersifat pribadi: jangan pernah mencatatnya di log atau membagikannya, terutama dengan skipSignIn.
Notifikasi Slack
Di Integrasi → Slack, hubungkan dengan Tambahkan ke Slack atau incoming webhook, pilih notifikasi yang akan diposting, misalnya hasil siap, lalu kirim pesan uji (dokumentasi Slack).
Ringkasan
- Jika memakai salah satu dari lima ATS yang didukung, gunakan koneksi bawaan: tautkan setiap lowongan dan tahap ke wawancara yang dipublikasikan.
- Jika tidak, gunakan API dengan kunci yang dibatasi izinnya dan punya masa berlaku serta header Idempotency-Key, dan verifikasi setiap webhook.
- Agar kandidat tetap di situs Anda, tambahkan embed, dan lewati kode masuk hanya di balik proses masuk Anda sendiri.
- Sebelum mulai digunakan, jalankan satu kandidat uji dari awal sampai akhir.
Tanya jawab
Apakah testee terintegrasi dengan Greenhouse atau Workable?
Ya, secara bawaan, juga dengan Teamtailor, Recruitee, dan Breezy HR. Anda menautkan lowongan dan tahap ke wawancara yang dipublikasikan; setiap kandidat yang dipindahkan ke tahap itu diundang sekali, dan hasilnya dikirim kembali sebagai catatan.
Apakah ada API wawancara AI?
Ya. REST API membuat kandidat dan undangan, melaporkan statusnya, serta mengembalikan hasil, laporan PDF, dan ekspor CSV. Webhook bertanda tangan memberi tahu sistem Anda saat sesuatu terjadi.
ATS saya tidak didukung. Apakah tetap bisa dihubungkan?
Ya, lewat API: buat undangan saat kandidat mencapai tahap yang tepat, simpan externalId Anda di dalamnya, dan ambil hasilnya saat results.ready tiba.
Bisakah kandidat mengikuti wawancara di halaman karier kami?
Ya, dengan SDK embed: izinkan situs Anda di Integrasi → Sematkan, buat undangan dengan API, lalu pasang di halaman Anda.
Apakah hasilnya memajukan kandidat di ATS?
Tidak. testee tidak pernah memindahkan atau menolak kandidat. Catatan memuat skor cakupan dengan label untuk ditinjau, bukan keputusan rekrutmen; manusialah yang memutuskan.
Apa saja isi daftar periksa integrasi ATS?
Lowongan dan tahap mana yang mengirim undangan, siapa yang memegang kunci, cara webhook diverifikasi, apa yang dikirim kembali ke ATS, cara kegagalan diketahui, cara menangani kandidat di New York City dan permintaan akomodasi, serta satu uji coba.