Entrevista de triagem

Envie endereços de e-mail dos candidatos, perguntas, metadados do trabalho e um callback URL. Curriculo envia um link para a entrevista para cada candidato, hospeda a gravação, transcreve cada resposta e envia cada resposta para o seu callback_url à medida que elas chegam. Um endereço falho não cancela os outros.

Preço: $0.02 por convite efetivamente enviado. Convites falhos não são cobrados.

Esses endpoints ainda não estão na especificação OpenAPI ou Swagger UI. Chame-os diretamente com sua chave da Console.

Solicitação

application/json

curl -X POST https://api.curriculo.me/public/screening-interview \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{
    "candidate_emails": ["[email protected]"],
    "questions": ["Tell us about a system you shipped."],
    "callback_url": "https://example.com/screening",
    "job_title": "Backend engineer"
  }'

Resposta

A chamada responde 202 com um screening_id, um callback_secret mostrado uma vez, sent_count, e uma lista invites . Cada convite é sent ou failed. Armazene o callback_secret.

Retornos de Chamada

Cada resposta é uma assinatura POST para o seu servidor. X-Curriculo-Signature é sha256= mais o hexadecimal em minúsculas HMAC-SHA256 do corpo bruto, chaveado com o callback_secret do 202 (usado como está). Verifique exatamente como para retornos de chamada de tarefas em segundo plano .

{
  "screening_id": "...",
  "email": "[email protected]",
  "question": "Tell us about a system you shipped.",
  "question_index": 0,
  "transcript": "I shipped the billing service.",
  "recording_url": "https://api.curriculo.me/public/screening-interview/.../recording",
  "media_kind": "video",
  "duration_seconds": 142,
  "completed": false
}

• question_index começa em 0.
• completed permanece false até que o candidato tenha uma resposta final para cada pergunta.
• O recording_url é um link de mídia privado Curriculo, destinado à página de resultados ATS, onde os recrutadores podem assistir à resposta ao lado da transcrição.

O callback URL é o seu backend URL, não uma página de candidato e nem um painel de recrutador. O Curriculo envia resultados assinados e legíveis por máquina para lá; o seu produto decide como os recrutadores os veem.

Obtenha uma triagem

curl https://api.curriculo.me/public/screening-interview/<screening_id> \
  -H 'Authorization: Bearer key_abc123_yoursecret'

Leia os resultados de uma triagem a qualquer momento. Se um link de gravação antigo expirou, solicite a triagem novamente para receber um novo mídia URL.

Manipulação de dados

As entrevistas de triagem mantêm convites, respostas de candidatos e gravações para que o seu ATS possa recuperar gravações e transcrições concluídas. Veja Manipulação de dados.