Partner API ile giden arama

Kendi sisteminizden API ile arama siparişi verin, soruları çağrıya taşıyın ve görüşme transkriptini geri alın.

Partner API, kendi yazılımınızdan SCC'ye programatik olarak giden arama siparişi vermenizi sağlar. Tipik kullanım: işe alım platformunuz adaya sorulacak soruları API ile gönderir, SCC adayı arar ve soruları sırayla sorar, görüşme bitince transkripti yine API üzerinden çekersiniz.

Bu özellik kurumsal müşterilere açıktır ve API anahtarı gerektirir. Anahtarınızı SCC ekibinden talep edersiniz; anahtar yalnız bir kez gösterilir ve sizin tarafınızda güvenle saklanmalıdır.

Nasıl çalışır

  1. Sisteminiz POST /api/partner/interviews ucuna aranacak numarayı, kişi bilgisini ve sorulacak soruları gönderir.
  2. SCC aramayı kuyruğa alır; isterseniz ileri bir tarih ve saate zamanlayabilirsiniz.
  3. Yapay zekâ asistanı kişiyi arar, soruları sırayla sorar, cevapları dinler; yorum yapmaz, karar bildirmez.
  4. Görüşme bitince GET /api/partner/interviews/{id} ile durumu, sonucu ve konuşmanın tam transkriptini alırsınız.

Kimlik doğrulama

Her istekte X-Api-Key başlığı gönderilir. Anahtar geçersiz ya da iptal edilmişse yanıt 401 olur. Anahtarınızın sızdığından şüpheleniyorsanız SCC ekibine bildirin; anahtar anında iptal edilir ve yenisi verilir.

Sipariş alanları

  • phone (zorunlu): Aranacak numara.
  • questions (zorunlu): Sırayla sorulacak sorular; 1 ile 15 arasında.
  • consent (zorunlu): Kişinin aranacağı konusunda bilgilendirildiğini ve gerekli izne sahip olduğunuzu beyan edersiniz. Bu beyan olmadan sipariş kabul edilmez.
  • candidateName, position: Kişiye hitap ve görüşme bağlamı için.
  • opener: Özel açılış cümlesi. Boş bırakılırsa doğal bir açılış üretilir.
  • notes: Bu görüşmeye özel ek yönergeler.
  • scheduledAtUtc: İleri tarihli zamanlama (en fazla 30 gün).
  • externalRef: Kendi sisteminizdeki kayıt numaranız; yanıtlarla birlikte geri döner.

Uyumluluk

Partner API, SCC'nin giden arama kurallarının hiçbirini atlamaz. Her arama öncesi izin kaydı, İYS ret kontrolü ve arama saati penceresi (08:00-20:00) uygulanır; görüşmenin yapay zekâ destekli olduğu her çağrıda açıkça beyan edilir. Ayrıntı için Giden arama ve KVKK sayfasına bakın.

Aranan kişilerin kişisel verileri bakımından veri sorumlusu sizsiniz; SCC veri işleyen sıfatıyla hareket eder. Entegrasyon öncesi bir veri işleme sözleşmesi imzalanır.