Screen Zoho Recruit candidates with HireLayer

const HIRELAYER = 'https://hirelayer.co'
const headers = { 'X-API-Key': process.env.HIRELAYER_API_KEY! }
// API domain of your data center, e.g. https://www.zohoapis.eu for EU accounts
const RECRUIT = `${process.env.ZOHO_API_DOMAIN}/recruit/v2`
type Attachment = { id: string; File_Name: string; Created_Time: string }

const json = { 'Content-Type': 'application/json' }
const zoho = async (path: string, init: RequestInit = {}) => fetch(`${RECRUIT}/${path}`, {
  ...init, headers: { ...json, Authorization: `Zoho-oauthtoken ${await zohoAccessToken()}` },
})
// Zoho answers 204 with no body when a list is empty
const list = (path: string) =>
  zoho(path).then((r) => (r.status === 204 ? [] : r.json().then((body) => body.data)))

// params: the parameters configured on the Zoho Recruit webhook
export async function handle(params: { candidate_id: string; secret: string }) {
  if (params.secret !== process.env.ZOHO_WEBHOOK_SECRET) return 401
  const id = params.candidate_id

  // 1. The job opening and the latest attachment of the candidate
  const [opening] = await list(`Candidates/${id}/associate`)
  const [latest] = (await list(`Candidates/${id}/Attachments`)).sort(
    (a: Attachment, b: Attachment) => b.Created_Time.localeCompare(a.Created_Time))
  if (!opening || !latest) return 200

  // 2. Download and parse (about 35 s)
  const form = new FormData()
  form.append('file', await zoho(`Candidates/${id}/Attachments/${latest.id}`)
    .then((r) => r.blob()), latest.File_Name)
  form.append('application_id', id)
  const parsed = await fetch(`${HIRELAYER}/api/v3/parser`, {
    method: 'POST', headers, body: form, signal: AbortSignal.timeout(150_000),
  }).then((r) => r.json())

  // 3. Score with the criteria stored for this job opening
  const criteria = await loadCriteria(opening.id)
  const match = await fetch(`${HIRELAYER}/api/v1/matching/job-candidate`, {
    method: 'POST',
    headers: { ...headers, ...json },
    body: JSON.stringify({
      job_text: criteria.jobText,
      candidate_text: parsed.info_resume.text,
      matching_criteria: criteria.items,
    }),
  }).then((r) => r.json())

  // 4. Note and tag on the candidate
  await zoho('Notes', { method: 'POST', body: JSON.stringify({ data: [{
    Note_Title: 'HireLayer screening',
    Note_Content: `Score: ${Math.round(match.score * 100)}/100\n${match.summary}`,
    Parent_Id: id,
    se_module: 'Candidates',
  }] }) })
  if (match.score >= 0.7) {
    await zoho(`Candidates/${id}/actions/add_tags?tag_names=HireLayer%20strong%20match`, { method: 'POST' })
  }
  return 200
}