Setting Up Presence Checks

Plan-gated feature. Presence checks require a plan that includes them. If your plan doesn't, the Safety Checks section on the site form is shown disabled — upgrade your plan first.

What it does

While a worker is checked in, the system sends them a Telegram message every N hours. The worker taps the link, takes a selfie, GPS is captured, and the result is logged. If they don't respond before the grace window expires, the attendance record is flagged and admins are emailed.

Per-site configuration

1. Edit a site → scroll to Safety Checks (Telegram)
2. Tick Enable presence checks for this site
3. Choose an interval: 2h, 4h, 6h, or 8h between checks
4. Set the grace window (5–60 minutes) — how long after the scheduled time the worker can still submit
5. Toggle Require photo and Require GPS as needed (both default on)

How workers link Telegram

The first time a worker checks in at a presence-enabled site, the success page shows a "Link Telegram for safety pings" button. The worker taps it once — Telegram opens, they tap Start, and they're linked. See the worker-side guide: Linking Your Telegram.

Alternatively, you can pre-link workers via CSV import. The bulk importer accepts an optional telegram_chat_id column.

Reviewing checks

Each PresenceCheck appears in the attendance record's history with status (pending / notified / completed / missed / cancelled), submission time, photo, GPS coordinates, and distance from the site. Missed checks email super_admins immediately.

What if a worker has no Telegram?

The check is still scheduled but marked with delivery_channel='none'. Admins see it as pending. You can either ask the worker to link via the post-checkin button next time, or pre-link them via CSV.