Telegram Safety Pings Not Working

I'm not receiving any safety check messages

Possible causes:

• You haven't linked yet. Re-scan a QR at a presence-enabled site and tap the Link Telegram button on the success page.
• The site doesn't have presence checks on. Not every site uses this — check with your admin.
• Your plan doesn't include presence checks. Admins: see Plans & Pricing.
• You blocked the bot. Open your Telegram chat with @ClockMiBot and tap Restart. Then re-link from the check-in success page.
• You're not actually checked in. Pings only fire while you have an open check-in.

The link in the message says "expired"

The grace window has passed. Each safety check expires (typically 15 minutes after it's sent). You're not in trouble — the record is just flagged for your admin's review. Wait for the next ping.

The page won't accept my submission

• "Location is required" error — allow location access in your browser. iOS: Settings → Safari → Location. Android: Chrome → Site Settings → Location.
• "Location accuracy too low" error — move outdoors or to a window. Indoor GPS can be off by 200m+.
• "Photo too large" error — your phone's full-resolution photo is over 8MB. Newer phones with high-res cameras can hit this; reduce image quality in your camera app.
• "This check has expired" — the grace window passed before submit. Will be marked missed.

Admin: a worker says they're getting nothing

1. Verify the bot is enabled in SaaS Admin → Telegram and the webhook is set
2. Verify the worker's record has a telegram_chat_id (check the worker detail page)
3. Check the activity log for "Telegram blocked" events — the worker may have blocked the bot
4. Try sending a test message from the SaaS admin Telegram panel using the worker's chat ID

Admin: how do I unlink a worker

Open the worker detail page and click Unlink, OR have the worker send /unlink to the bot themselves. They can re-link from the next check-in success page.