TEASEDocs
ProductsClubHow-to

Clock in/out and see your own KPIs

Start and end a worked shift from the Chatters tab, and read your own reply-time, PPV, and revenue numbers for the day.

Clocking in

POST /chatters/clock-in opens an unbounded shift row (source: clock_in, no end time) for whichever operator you're linked to. It's idempotent on a double-click: if a shift is already open, the call just returns it instead of opening a second one.

POST /chatters/clock-out closes it (end_ts = now). Clicking clock-out with nothing open isn't an error — it just answers clocked_in: false, the same as if you'd never clicked clock-in.

A second, separate self-service screen exists too

If your workspace ties access to being on shift, there's a dedicated Shift screen (/api/admin/shift/*) that works even for a member with no tabs granted at all — because showing up for work is a fact about yourself, not workspace data. Its clock-in can open a real shift, start a timed off-schedule window, or file a request for a manager to approve, depending on how the workspace is configured. See Team access for the full on/off-shift mechanics — this page covers the plain Chatters-tab clock button.

Seeing your own KPIs

The leaderboard (GET /chatters/leaderboard) and the quality read (GET /chatters/quality) both self-scope automatically for a team member linked to a roster row: you get back your own row and nothing else — no other operator's numbers, no account-wide "off shift" bucket. An owner or manager sees the whole team; the endpoint doesn't need a different call, just a different caller.

What's on your row:

  • Net revenue attributed to you for the window (sale attribution — see the concepts page for how a sale gets credited to an operator).
  • Response time, PPV unlock rate, and messages per sale from the quality read.
  • Your hours worked, from your shift rows.

Money can be hidden even on your own row

If the workspace has turned off the "Amounts on the leaderboard" grant for your role, dollar figures are nulled server-side and replaced with percentage shares — this happens whether or not it's your own row, so a masked leaderboard still shows your rank without the exact number.

What's next

On this page