Favourites & Presence
TeamBook Connected Org helps you stay connected to the colleagues you work with most. Favourites let you pin people for instant access; Presence gives you a live view of who is available right now; the Out-of-Office badge tells you who’s away and when they’re back.
Pinning a colleague (favourites)
Every person card has a star icon in the corner.
- Click the star to pin that colleague.
- Click it again to unpin.
Pinned colleagues are:
- Visually marked with a filled gold star
- Shown in a dedicated Pinned strip at the top of the directory — always above your normal search results
- Stored in your browser’s local storage so they persist across sessions
Microsoft Teams presence
When presence is enabled by your admin, a small coloured dot is overlaid on each profile photo. It reflects the colleague’s current Microsoft Teams status, read live from the Microsoft Graph Presence API:
| Indicator | Meaning |
|---|---|
| 🟢 Green | Available — online and active |
| 🟢 Green ring | Available, idle |
| 🔴 Red | Busy or Do Not Disturb |
| 🔴 Red ring | Busy, idle |
| 🟣 Purple | Presenting (e.g. in a Teams meeting share) |
| 🟡 Yellow | Be Right Back |
| ⚪ Grey | Away, Off Work, or Offline |
Presence refreshes every few minutes while the page is open and on demand when you open someone’s detail panel.
Out-of-Office badge
Independent of presence, the directory shows an OOO badge on any colleague who has an active Outlook auto-reply.
- The badge appears as a small amber pill on the card.
- The detail panel surfaces the full out-of-office message and start / end dates (if set in Outlook).
- The OOO filter in the toolbar lets you see only people currently out of office — useful for “who’s covering for whom” conversations.
OOO data comes from the Microsoft Graph MailboxSettings API. Colleagues without an Exchange Online mailbox (most commonly Microsoft Entra guest accounts) won’t show OOO status, even if they’ve configured an auto-reply elsewhere.
Privacy and permissions
- Presence and OOO are read-only — TeamBook never changes any colleague’s status.
- The
Presence.Read.AllandMailboxSettings.ReadMicrosoft Graph permissions must be approved by your tenant admin for these features to work. Without them, the indicators are simply hidden — the rest of the directory works as normal. - Pinned-colleague choices live entirely in your own browser. Nothing is uploaded to SharePoint or anywhere else.