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.
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
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.
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
You
▶ tapped Confirm
What's happening
Everything in one sentence
- 1Customer, task, duration and a description were all present, so nothing has to be asked.
- 2The quick confirm card. Nothing is written yet — this is the gate.
- 3The card is replaced by its result, so your chat stays an easy record of what happened.
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 type | Agent logs | Card shows |
|---|---|---|
| 2 hours | 120 minutes | 2:00 |
| 1h 30m | 90 minutes | 1:30 |
| 1:30 | 90 minutes | 1:30 |
| 5.5 hours | 330 minutes | 5:30 |
| 90 | 90 minutes | 1:30 |
| half an hour | 30 minutes | 0:30 |
| add one more hour | 60 minutes — a new, separate entry | 1:00 |
| log an hour | 60 minutes, task asked for with buttons | 1: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 type | Agent uses | Card shows |
|---|---|---|
| (nothing) | Today, in your Teams time zone | Tue, Mar 31 |
| yesterday | Resolved before anything is logged | Mon, Mar 30 |
| on Friday | The most recent Friday | Fri, Mar 27 |
| 2026-03-24 | Exactly that date | Tue, Mar 24 |
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
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.
| What | How it works |
|---|---|
| Logging time | Nothing 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 & locking | Each half is approved or rejected on its own. One half being locked does not lock the other. |
| Why | Monthly reports and invoices need clean month totals — a week may not smear hours across two months. |
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.
(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”.
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.
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.
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.
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.
Rules & limits
The handful of behaviours that surprise people. None of them are bugs.
| Situation | What happens |
|---|---|
| Timesheet submitted or approved | Everything 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 it | Only 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 options | The card shows five buttons and says so. Type a more specific name to reach the rest. |
| “log my day” after a summary | Only the unlogged suggestions are logged. Already-recorded time is never duplicated. |
| Activities that match no task | Grouped and shown as a hint without durations. Tell it the task and duration to log them. |
| Submit button missing | It appears from Friday onward, or whenever submission is actually due. |
| Answer looks wrong | AI-written replies carry an “AI generated” label and 👍/👎. Use them — feedback is read. |
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
| When | What the agent says |
|---|---|
| Sign-in card | Sign 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 in | You're signed in to OneShift. Workspace: **{organizationName}**. Send "sign out" to switch workspace. |
| Sign-in not completed | Sign-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 expired | Your OneShift sign-in expired. Please sign in again. |
| End of day, not signed in | Sign in to OneShift to get your daily summary. |
| Start of day, not signed in | Sign in to OneShift to see the timesheets that need your attention. |
| Project checklist, not signed in | Sign in to OneShift to get your project checklist reminders. |
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 are | The tool can also |
|---|---|
| Timesheet manager or team lead |
|
| Workspace manager |
|
| Billing manager |
|
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.
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.