Support

OneShift Agent guide

The OneShift agent lives in your Microsoft Teams chat. It watches your calendar and app activity, proposes the time you probably worked, and logs it once you confirm. This guide covers every conversation it understands — and how to talk to it.

Works in any language. Write to it the way you normally would and it replies in kind. The examples below are in English, but nothing here is English-only.
01

The three commands

Behind the chat there are exactly three actions the agent can take on your behalf. Knowing them makes its behaviour predictable.

Summarize day

Maps today's meetings, emails and app activity onto your tasks, subtracts what you already logged, and shows what's left.

  • › summarize my day
  • › how does my day look?
  • › wrap up

Enter time

Logs hours against one task. Missing details are asked for with buttons — you never have to know a project code.

  • › 2h on development for Contoso
  • › log an hour
  • › 30m QA yesterday

Submit timesheet

Shows the week’s totals and utilization, then submits for approval. Weeks run Monday to Sunday.

  • › submit my timesheet
  • › submit last week
  • › I'm done for the week
Anything else is a conversation. Questions like “what have I logged today?” or “which tasks do I have?” are answered straight from context — no card, no action, nothing changed.

When something is missing — no comment (when comments are required), or you tap Edit on a card — it opens a full form where you fill in the date, task, minutes and comment yourself. The task box is searchable, so you never need to know a project code.

02

Conversations, replayed

Pick a scenario. The chat replays exactly as it happens in Teams, and the notes alongside explain what the agent is doing at each step.

Logging time

Reviewing & submitting

It messages you

It remembers you

Signing in

Edge cases

OneShift AgentAI time tracking assistant

You

I spent 2 hours on development for Contoso — sprint work on the checkout flow

▶ tapped Confirm

✅ Logged 2:00 on Development (Contoso).

What's happening

Everything in one sentence

  1. 1Customer, task, duration and a description were all present, so nothing has to be asked.
  2. 2The quick confirm card. Nothing is written yet — this is the gate.
  3. 3The card is replaced by its result, so your chat stays an easy record of what happened.
03

How to say time

Durations and dates are read out of your sentence. You never type minutes unless you want to — though cards always display h:mm, so 90 minutes reads back as 1:30.

Duration

You typeAgent logsCard shows
2 hours120 minutes2:00
1h 30m90 minutes1:30
1:3090 minutes1:30
5.5 hours330 minutes5:30
9090 minutes1:30
half an hour30 minutes0:30
add one more hour60 minutes — a new, separate entry1:00
log an hour60 minutes, task asked for with buttons1:00
5:50 is not five and a half hours. The colon always reads hours:minutes — in chat and in the duration boxes on the Timesheets page alike. 5:50 means 5 h 50 min. For five and a half hours enter 5:30, or say “5.5 hours” and the agent converts it. A bare number is minutes: 90 becomes 1:30.

Date

You typeAgent usesCard shows
(nothing)Today, in your Teams time zoneTue, Mar 31
yesterdayResolved before anything is loggedMon, Mar 30
on FridayThe most recent FridayFri, Mar 27
2026-03-24Exactly that dateTue, Mar 24
Comments are required by default — and honest. Unless your workspace says otherwise, every entry needs a short description. The agent writes one from your words or your calendar, and will happily be generic (“Development work”) rather than invent a feature you never mentioned. Comments read as a work log, not as you speaking: “I fixed the printer” becomes “Fixed printer issue”, and an email subject is kept as is, including its “RE:” prefix, because on support work the thread subject is the clearest description. If nothing describes the work, it opens the full form and asks you. A workspace admin can turn the requirement off with “Require time entry comments” in Workspace settings. Then logging without a comment goes straight to the Log Time card, the quoted comment line is left out, and the Comment field on the Enter Time form is optional.
Project-only entries. Logging on a project without a task works only on projects where “Allow logging time without a task” is on (in the project settings or the project template). There, the card shows Project (Customer) where a task would appear. A project that also has tasks still asks “Which task?” — unless you say to log on the project itself (“no task”, “just the project”, “project only”), or tap Just the project — no task on the question card. That button, the Enter Time form's Project — No task (Customer) option and the day review's project suggestions appear only for such projects. On any other project the bot replies with one of these. If the project has no tasks: “{Project} ({Customer}) has no tasks yet and requires one. Ask a workspace manager to add a task or allow logging on the project.” If it has tasks but you asked for project-only: “{Project} ({Customer}) requires a task. Tell me which task to log the time on.”
Say several things at once. “1h Acme dev and 30m design for House for AI yesterday” produces two separate confirmation cards, each with its own date. “Log 2 hours on development and submit my timesheet” logs, then opens the submit card.
04

One week, two timesheets

Timesheets follow the calendar week — Monday to Sunday — but never cross a month boundary. When a month ends mid-week, the week splits into two timesheets, one per month.

Week of Aug 31 – Sep 6

Mo31 Aug
Tu1 Sep
We2 Sep
Th3 Sep
Fr4 Sep
Sa5 Sep
Su6 Sep
August timesheetMon only — closes AugustApproved
September timesheetTue – Sun — opens SeptemberOpen

One calendar week, two timesheets — submitted, approved and locked independently.

The Timesheets page still shows the whole week in one grid, with a divider where the month changes; each side of the divider is its own timesheet with its own status. See it pinned onthe annotated Timesheets page.

WhatHow it works
Logging timeNothing changes. Log entries on any day as usual — each entry lands in the timesheet that owns its date.
Submitting“submit my timesheet” targets the timesheet containing today. The other half is submitted separately — name a date in it, e.g. “submit my timesheet for August 31”.
Approval & lockingEach half is approved or rejected on its own. One half being locked does not lock the other.
WhyMonthly reports and invoices need clean month totals — a week may not smear hours across two months.
05

When it messages you first

A few messages arrive without you asking. All are dismissible, and none log anything on their own — you always confirm.

  • End of dayYour day review, pushed to you late in the afternoon. On submission day it adds a reminder and a Submit button. See the End of day nudge scenario.
  • Start of dayOnly when a timesheet is overdue or your manager sent one back — a morning heads-up with a Submit button.
  • Checklist reminderWhen a project checklist item is due. Mark it complete and a pre-filled card appears — see the Checklist done scenario.
  • Timesheet approved or rejectedA plain heads-up when your manager acts; rejections include the reason. See Rejected by your manager.
Day review follows your day. The day is worked out in your own time zone, and calendar events marked out of office are left out, so a day off does not turn into suggested work. The Timesheets page in the web app offers the same suggestions through Assist.
Linked accounts. Your own account in this workspace needs no link: when the workspace admin has connected Microsoft 365, the Account page says so under the provider and the agent already reads it. Work for a customer that gave you a Microsoft 365 account of their own? Link that account under Account → Connected accounts while working in the workspace it belongs to (a link is private to you and to that workspace) and the agent also reads its calendar, sent mail, Teams chats and channel posts when it proposes your day. In the day review, an unmatched line whose items all came from one linked account ends with (via name@customer.com), naming that account. Teams chats of a linked account are read with your own permission, but channel posts (and complete chat coverage) appear only after that organisation’s admin approves OneShift Connect. The Account page offers “Get approval link” (later “Copy link again” or “Re-request approval”), “Email the admin” and “Check approval”.
06

What it remembers

The agent remembers in two ways. Within a conversation it holds on to what you just said — “make it two hours”, “the second one”, “that was for Contoso” all refer back to the last card, so you never repeat yourself. It also remembers a few lasting facts about how you work — day to day and even weeks later — and applies them on its own, so you don't have to say them again.

A

You tell it something

Say a lasting preference in plain words, as its own message — “the bank means Contoso Financial”, “always round my time to 15 minutes”. It picks these out as you chat; there is no separate settings screen to fill in. A rule tucked into a request to log time applies to that entry but is not kept.

B

It keeps the gist

It saves a short note of the point, not the whole conversation. Tell it something new that contradicts an old note and the old one is updated — nothing piles up. It keeps a few dozen notes at most and lets the oldest go when there are more.

C

It uses it when it fits

It brings all of its notes about you into every conversation and applies the ones that fit, so they shape what the agent does — you never have to remind it.

Yours to change. What it remembers is private to you — never shared with colleagues — only ever comes from your own chats, and is stored inside your OneShift workspace, not with a third party. Tell it to forget the rounding rule and it drops it. You can also see and remove every note on your Account page. If it does something you didn't want, correct it in the same breath — “no, exactly 50 minutes” — and the entry is fixed on the spot; to make the change permanent, say the rule on its own — “don't round my entries”.
07

Rules & limits

The handful of behaviours that surprise people. None of them are bugs.

SituationWhat happens
Timesheet submitted or approvedEverything is frozen: “🔒 Your timesheet has been submitted or approved. No changes are allowed.” Ask your manager to reject it if you need to edit.
“yes” with anything after itOnly a bare yes / yep / ok / confirm / go ahead counts as a tap. “yes but make it 2 hours” is treated as an edit — you get a corrected card, not a surprise entry.
More than five optionsThe card shows five buttons and says so. Type a more specific name to reach the rest.
“log my day” after a summaryOnly the unlogged suggestions are logged. Already-recorded time is never duplicated.
Activities that match no taskGrouped and shown as a hint without durations. Tell it the task and duration to log them.
Submit button missingIt appears from Friday onward, or whenever submission is actually due.
Answer looks wrongAI-written replies carry an “AI generated” label and 👍/👎. Use them — feedback is read.
08

Signing in

The agent asks you to sign in with your OneShift account before it does anything, then works as you until you sign out.

The first time you message the agent, and again if your sign-in expires or you sign out, it asks you to sign in to OneShift. Tap Sign in and use your OneShift account. You pick the workspace while signing in, and the agent works in that workspace until you sign out. Whatever the agent changes for you appears in History under your name, marked as made via the agent.

Replay both conversations under Signing in in the player above: your first sign-in, and switching workspace.

What you will see

WhenWhat the agent says
Sign-in cardSign in with your OneShift account to continue. You only need to do this once. Don't have an account? Get started at oneshift.ai.
After you sign inYou're signed in to OneShift. Workspace: **{organizationName}**. Send "sign out" to switch workspace.
Sign-in not completedSign-in didn't complete. Send me any message to try again.
You send "sign out" (also: signout, log out, logout, switch workspace, change workspace)You're signed out of OneShift. Send me any message to sign in again, for example to pick a different workspace.
Your sign-in expiredYour OneShift sign-in expired. Please sign in again.
End of day, not signed inSign in to OneShift to get your daily summary.
Start of day, not signed inSign in to OneShift to see the timesheets that need your attention.
Project checklist, not signed inSign in to OneShift to get your project checklist reminders.
Daily messages need sign-in too. If you are not signed in when a daily message is due, you get a short prompt with a Sign in button instead of the usual card. Tap it, finish signing in, and the next message arrives as normal.
09

Connecting AI tools

You can connect an AI tool such as Microsoft 365 Copilot to OneShift and work with your time from there. Everyone gets the self-service tools; the manager read tools are available to people who already have those manager permissions in OneShift, through their own sign-in.

The connection uses MCP (Model Context Protocol), a standard way for AI tools to talk to other apps. When you connect a tool you sign in with your OneShift account and choose the workspace at sign-in. From then on the tool acts for you only.

What the tool can do for everyone

  • See the customers, projects and tasks you can log time on.
  • Get suggested entries for a day, based on your own activity.
  • Read your time entries for a day.
  • See your timesheet with its status and totals, with a link that opens it in OneShift.
  • Log time.
  • Submit your timesheet for approval.

Extra abilities for managers

If you have a management role, the tool can also read the following. These abilities are read-only: the tool can look, never change. Team leads see their own teams only.

If you areThe tool can also
Timesheet manager or team lead
  • List timesheets for a period, by person and status.
  • List the timesheets waiting for approval.
  • Open one person’s timesheet with totals and review flags.
  • Get logged time for a period grouped by customer, project, task or person.
Workspace manager
  • List and open projects and customers.
  • See each project’s budget status: budget, time used, time remaining, whether it is over budget and, where available, the forecast date it runs out. For monthly and annual budgets, “used” is the current month or year.
Billing manager
  • List and open statements.
  • Get the number of statements and their totals by status (draft, in review, approved, invoiced), with amounts shown per currency.

What it sees and links to

  • A tool sees exactly what you can see in OneShift, no more. Without a management role you get none of the manager abilities above.
  • Answers include links that open the timesheet, approvals list, project, customer, budget or statement in OneShift. A link opens in the workspace you are signed in to in the browser.
  • As a manager you do not see the contents of other people’s emails, meetings or chats through a tool. Review flags show totals only.

What it cannot do

  • Approve or reject timesheets.
  • Edit other people’s time.
  • Change projects, customers, budgets, statements or workspace settings.

The only changes a tool can make are logging your own time and submitting your own timesheet.

Changes need your confirmation. Logging time and submitting your timesheet are changes, so the tool should ask you to confirm first. They appear in History under your name, marked as made via an AI tool (for example “Maria Ivanova via AI tool”).

In Microsoft 365 Copilot. Where your organization has enabled it, you can also reach the agent from Microsoft 365 Copilot. It behaves the same there as in your Teams chat.

Nothing is ever logged or submitted without your confirmation.