Support

Linked Microsoft accounts

For: Members and external admins

Work inside a customer’s Microsoft 365? Link that account so the OneShift agent can also read it when it proposes your day. This page is for the member who links it and for the customer’s admin who approves it.

01

What linking does

A linked account is a second Microsoft 365 account, usually one a customer gave you in their own tenant. OneShift reads it in addition to your own workspace account.

  • You do not need it for your own account. When your workspace admin has connected Microsoft 365, the agent already reads your account there. See Connect Microsoft 365. Link only accounts from other organizations.
  • It is private. A link belongs to you and to the workspace you made it in. Your colleagues cannot see it, and a link made in one workspace is not used in another.
  • It shapes the day review. The agent reads the linked account’s calendar, sent mail, Teams chats and channel posts. How that shows up in the agent’s messages is in the Agent guide.
04

Get the other tenant’s admin to approve

Until the customer’s admin approves, the agent reads your calendar and sent mail, and your Teams chats with your own permission, but no channel posts. To get the full read, send the admin an approval link.

Under the linked account, the line below the name tells you where it stands:

ButtonState
Get approval linkNo approval has been requested. Chats are read with your own permission; channel posts are not read.
Copy link againWaiting for the tenant admin to approve Teams chats and channel posts.
Re-request approvalTeams chats and channel posts approved by the tenant admin. The button stays available in case approval is later withdrawn.

As the member

  1. Under the linked account select Get approval link. OneShift copies the link and says “Approval link copied. Send it to the tenant admin.” If your browser blocks the copy, it shows the link in a box titled “Copy this link”.
  2. Or select Email the admin. This opens a new email in your mail program with the subject “Please approve OneShift Connect for Teams access”, an explanation of what is read, and the link. No recipient is filled in; choose your admin.
  3. After the admin says they approved, select Check approval. OneShift asks Microsoft whether every role above is granted in that tenant.
Check approval saysWhat to do
Teams chats and channel posts are approved in the tenant.Done. The line says approved.
Approval incomplete. Missing: …Some roles are not granted in the tenant. Ask the admin to approve again.
Approval check failed. …Microsoft could not issue a token for the tenant, with Microsoft’s error code. Ask the admin to open the link again.

As the customer’s admin

  1. Open the link from the member. Sign in with an account that can grant tenant-wide admin consent.
  2. Review the permissions OneShift Connect asks for, the five application roles above, and accept.
  3. You land on a OneShift page headed Approval recorded: “OneShift Connect can now read Teams chats and channel posts for the people in your organisation who linked their account.” You can close the tab. You do not need a OneShift account.

If you decline or the roles are not all granted, the page says Approval not completed and may add “The administrator did not grant access.” or “Microsoft admin consent failed.” Nothing is recorded as approved.

Approval verifies itself. OneShift records a tenant as approved only after Microsoft issues it a token that carries every required role, not just because the link was opened.
05

Reconnect and re-approve

A link can need attention later: your sign-in may stop being valid, or OneShift may start asking for a new permission. Approval can also be withdrawn in the customer’s tenant.

  • Needs reconnect. The pill turns amber. Hover or focus it for the reason; for a new permission it reads “New permissions required: …”. The Connect accountbutton changes to Reconnect (“Reconnect: sign in again to refresh a linked account that needs attention.”). Select it and sign in again; the account’s sign-in is replaced in place and you do not lose the link.
  • Approval no longer valid. If the customer’s admin removes OneShift Connect, or a role is missing after an update, the line reads “The tenant admin’s approval is no longer valid; ask for it again.” Use Get approval link or Email the admin again, then Check approval. The admin must also approve again whenever OneShift adds a role.

Until you reconnect, the agent skips that account. Your workspace account and other linked accounts keep working.

07

What is read

Reads are limited to you, to the day being reviewed, and to proposing time to you.

  • Calendar events, sent mail. Read with your own delegated permission.
  • Teams chats. Read with your own permission until the admin approves, and afterwards with the approved role, still only the messages you wrote.
  • Channel posts. Only after the admin approves. They are not read with a member’s permission alone.

It does the same as for your workspace account: it proposes time entries to you, you confirm them, and the activity is held in memory for up to five minutes. In the day review, an unmatched line whose items all come from one linked account ends with the account’s address. The sign-in OneShift keeps for a linked account is stored encrypted. The privacy policy describes what is read and how it is used.