Skip to content
Docs menu

The overnight queue in People

Switch a saved Reach view to run every night and find the people it picked on Today each morning, each with the reason and a drafted message to approve, edit or skip. Venom sends nothing unless you set a bot to.

View .md

Save a Reach search such as "payments, Singapore and nearby, director and up", switch it to run every night, and each morning Today (/people/today) opens with the people it picked. Each one comes with the reason and a message drafted in your voice. You send it, edit it, or skip it. Venom never sends anything itself, unless you set one of your bots to send through Venom Comms: then that bot's messages go out under its own limits, and its drafts land here too, their reason starting with the bot's name.

Switch a view on

Two places:

  • Reach → Views: the moon next to a saved view switches it on or off.
  • People → Settings → Overnight: every saved Reach view with a switch and how many people it picks a night (1 to 20, 10 by default), and Run now.

At most three views run every night, and a night picks at most 30 people across them. Nothing runs until you switch a view on.

What a night does

Once a day, after 04:00 in your time zone (the one in your calendar profile, else your organisation's Comms default, else UTC), each nightly view runs its Reach ranking and keeps its top people. These are left out:

  • people you are waiting on (you wrote in the last 7 days and they have not answered);
  • people already in the queue in the last 30 days, whatever you did with them;
  • people you skipped from the queue in the last 60 days;
  • people with an open follow-up or draft on Today;
  • people you marked Not yet, until it lapses;
  • people in an active or paused Outreach sequence.

If two views pick the same person, the first view keeps them. Running a night again (or Run now) never adds anyone twice. It only tops up what the views' counts still allow. Run now only picks: the drafts follow within 10 minutes, or straight away with a pick's Draft button.

If a view cannot run (a saved filter that no longer works), the other views still run and Settings marks that view "This view could not run last night". It is tried again the next night.

Then a message is drafted for each pick with the same drafter as Today's follow-ups, using your earlier messages for tone. The route shapes the message: closing an open loop reads differently from re-warming an old contact or a first message to a cold one. For an intro pick, the message goes to the introducer, one of your own warm contacts, and asks them to introduce you. The card says "Ask Dana for an intro to Lee".

The People AI budget

Every draft is one call (two if the first answer fails the checks) under your organisation's daily People AI cap. A night stops drafting once the organisation's People AI spend for the day reaches half the cap, so daytime use is never starved. Picks without a draft still show, with their reason and a Draft button that drafts on demand under the full cap. Nobody gets a template pretending to be personal.

The morning queue

The Overnight section is the first thing on Today when it has picks. It is hidden when it has none, and the Today tab shows how many are waiting. Its header line gives the latest night's numbers, for example "12 picked from 2 views · 9 drafted · $0.04": the cost is what the night's drafts cost.

Each card shows the name, title and company, the seniority mark, warmth, the route, the reason and the draft, which you can edit in place. Then:

  • a channel (WhatsApp, Telegram, email, copy) opens your own app with the text and logs it as sent on the person (or on the introducer). Tapping twice logs it once;
  • Skip takes the pick out of the queue without a question;
  • Not yet is the same as on Today, with a reason and how long;
  • Redraft writes the message again;
  • the funnel icon adds the person to a pipeline, the same as Reach's bulk action.

Keys while the queue has focus: j/k move, e edits the draft, s skips.

A pick you have not acted on for 7 nights expires, so the queue never piles up.

Privacy

A night picks only your own people, and each reason uses only your own data. An introducer is always one of your own contacts. A colleague's contacts, shared or private, are never picked, named or shown, and nobody else sees your queue.

Agents

  • people_overnight_list: the queue (route, reason, draft, its source and channel, the introducer), your saved Reach views with their nightly switches, and the latest night's numbers. REST: GET /api/v1/people/overnight.
  • people_overnight_update: edit, sent (after the member sent it; logged once), skip, not_yet or redraft a pick. REST: POST /api/v1/people/overnight/picks/{pick}.
  • people_overnight_run: pick the member's night now, under the same limits (drafts follow from the cron). REST: POST /api/v1/people/overnight/runs.
  • people_view_update: switch a saved Reach view to nightly, or off, and set its count. REST: PATCH /api/v1/people/views/{view}.

The cron behind it is GET /api/cron/people-overnight, every 10 minutes. It expires old picks, then picks for every member whose night is due, then drafts, starting with a different member each run. It acts only for people still in the organisation. A draft starts only when two model calls can still finish before the run's time is up, so no paid call is cut off. A night whose picking fails is retried after 1 hour, then 2, 4 and up to 12. Starting a new night closes the last one, so a pick never waits for a draft that will not come.