Nudge Hireflix candidates who never recorded their interview

On a cron trigger every weekday morning at 9am, chase the candidates who were invited to a Hireflix video interview but never recorded it, so my completion rate stops leaking.

Start with the Hireflix "List Positions" operation to pull my positions, and skip anything archived so I am only chasing candidates on roles I am still hiring for.

For each active position, use Hireflix "List Interviews for Position" to pull every interview still sitting in a pending or not started state, meaning the candidate was invited but has not submitted a recording. These list queries are cursor paginated: pass pagination: { limit, lastCursor } and keep feeding the returned lastCursor back in until there are no more results. Do not assume a single call covers a busy position.

For every unfinished interview, work out how many days ago the candidate was invited using the invite timestamp on the interview record. Hireflix timestamps are Unix epoch milliseconds.

Nudge on a two tier schedule based on that age. At day 2, send a gentle first reminder. At day 5, send a clearly final one. Send at most two reminders per candidate in total, and never two in the same day. Because day 2 and day 5 each come around once per candidate, nudging only when someone actually lands on a threshold enforces both rules on its own. If a threshold slipped past because this only runs on weekdays, catch it on the next weekday run, but still send just one email that run, the one that matches where the candidate actually is.

Send the reminders with the Gmail "Send a Message" action so they come from my own inbox and candidates can reply straight to me. Hireflix has no resend or reminder operation of its own, which is exactly why the nudge goes out over Gmail. Keep each email short, warm and personalized with the candidate's name and the role they applied for. The day 2 note should reassure them that it takes about 10 minutes and they can do it right from their phone. The day 5 note should make clear it is the last reminder and that the role will move on without them.

Include the candidate facing interview link from the interview record returned by List Interviews for Position. If that field is not exposed on the record, do not invent or guess a URL. Ask the candidate to use the link in their original Hireflix invite email instead.

Once a candidate is more than 7 days past their invite and still has not recorded, stop emailing them entirely. There is no third nudge. Collect them into a list for me to close out manually, so I can reject them or extend the deadline myself.

Finish with a single digest to my hiring Slack channel using the Slack Bot "Send a Message" action. Group it by position and cover three things: who got nudged today and which tier they received, who has aged out past 7 days and needs a decision from me, and how many interviews came in since yesterday. Post one message per run even on a quiet day, and keep it short enough to read on a phone.

Never email a candidate whose interview is already complete. If Hireflix returns an error for one position, carry on with the rest and note the failure at the bottom of the digest rather than aborting the whole run.