Guide · Add-on

Incident Management

Everything Incident Management does in the new design: how a problem is reported with a QR code or a form, how your team assigns, plans and closes it, and how an administrator sets up areas, categories and the team.

  • Facility teams, administrators and employees
  • 47 min read
  • Updated

Where to start

Overview

In one minute

Incident Management makes every place in your buildings somewhere a problem can be reported. Someone scans the QR code on the wall and says what is wrong. Your team gets it straight away, with a priority and a deadline taken from what the problem is about. The team gives it to someone, plans it and marks it done, and someone who reported it with their BmyGuest account can follow along.

The incident list at Northgate Copenhagen: the incident menu on the left, the counters, the quick filters and the deadline strip, then one block per incident.
The incident list at Northgate Copenhagen: the incident menu on the left, the counters, the quick filters and the deadline strip, then one block per incident.

The add-on is a handful of screens:

ScreenWho uses itWhat it is for
The report formAnyone who scans an area's QR code, with or without an accountSay where the problem is and what it is about, add a photo, send.
IncidentsAdministrators of the company, receptionists, incident administrators, managers and office managersEvery open incident at a location, with counters, quick filters and a deadline strip. Create, assign, plan and close.
Incident detailsEveryone who works on the incidentEverything about one incident, changed in place: priority, area, executor, due date, photos, checklist, time and comments.
My workExecutors and contractorsThe work you are responsible for.
SchedulerPlanners, once the Scheduler is switched onWho does what on which day, by drag and drop or with Auto-plan. Executors get My week.
My reportsAnyone who reported something with their BmyGuest accountHow far each report has come, and messages to the team.
Areas, Categories, Team, Module settingsAdministratorsThe setup: the places, what can be reported, who does what, and the optional features.

Assets, the things inside your areas such as a coffee machine or a projector, have a guide of their own: Asset Management. The setup both share is described here.

Key idea

An incident always belongs to an area and a category. The area says where it is, and its QR code is how people report it. The category says what it is about, and decides the priority and the deadline. Set those two up well and the rest follows.

Words used in this guide

WordMeans
AreaA place where problems are reported: a building, a floor, a room, a car park. Areas sit inside each other. Every area has its own QR code.
AssetA thing in an area, such as a coffee machine. See the Asset Management guide.
CategoryWhat a problem is about, such as Plumbing or Cleaning.
SLAThe time allowed to resolve an incident in a category. It gives the incident its deadline.
PriorityUrgent, High, Medium or Low.
ExecutorThe person responsible for an incident, who does the work.
StakeholdersOther people added to an incident to follow it.
Due dateWhen the incident must be resolved.
Scheduled dateThe day the work is planned for.

Who does what

Everyone keeps their usual BmyGuest role. On top of that, the Team page gives people a role in the incident module, per location.

Company administrator

  • Switches the add-on on for a location and chooses its incident administrators.
  • Gets the Incident Management workspace in the menu, for the company's locations that have the add-on.
  • Gives people their roles on the Team page, and invites people from outside. Only a company administrator can.
  • Changes the module settings.

Incident administrators and the Admin role

Incident administrators are chosen on the add-on's own page, and the Team page lists them as Admin. They are hosts who run the module at a location without being administrators of the company: they manage every incident there, and can open the setup guide and change the module settings. They cannot give people roles.

The Admin role can also be given on the Team page itself. On its own, it tells someone about every new incident at the location and lets them set up its areas and categories, but the incident list is for administrators of the company, receptionists, incident administrators, managers and office managers. So put a host who should run the module on the incident administrators list.

Receptionist

  • Gets the Incident Management workspace at the locations where they are a receptionist, with the administrator's menu, so they can register and follow up incidents.
  • Cannot open Module settings: the menu has Activity log in its place. The Team and Suppliers pages are for administrators of the company only.
  • Is not told about new incidents unless they also hold a role on the Team page.

Manager and office manager

These two roles are offered only when Teams and scoped access is switched on in Module settings.

  • A Manager sees the incidents their filter groups cover, and plans the work.
  • An Office manager sees everything at the location and can report and comment, but changes nothing.

Executor

  • Does the work. Can be given incidents, and has a lane on the Scheduler.
  • Finds their work on My work, and with the Scheduler on, their plan on My week.
  • Adds photos, ticks off the checklist, writes comments, logs time and marks their incidents done.

External (contractors)

  • Someone from outside the company, invited by e-mail with a sign-in link.
  • Sees only the work they are given, and lands on My work when they sign in.
  • Never sees private comments.

Reporter, and everyone else

Everyone can report a problem, with or without a role and with or without an account. Reporter is the role for people who should do nothing else: they report problems and follow their own reports on My reports.

How to get there

  • Administrators of the company and receptionists: the Incident Management workspace in the menu opens Incidents. The incident pages have their own menu: Work (Incidents, Scheduler), Your site (Areas, Assets, Categories), People (Team, Suppliers; administrators of the company only) and Module settings, or Activity log for receptionists. Assets, Scheduler and Suppliers appear only when they are switched on.
  • Incident administrators: the workspace opens Incidents too, with the same menu but without People. Managers and office managers also start on Incidents, with a shorter menu.
  • Executors and external people: the workspace opens My work, and the incident menu has My work and, with the Scheduler on, My week. External people also land on My work when they sign in. The buttons in the incident e-mails, such as Open the incident and Open my work, lead there too.
  • Reporters: the workspace opens My reports, and the incident menu has My reports and Report a problem.
  • Someone whose only role on the Team page is Admin: the workspace opens Areas.
  • My incident notifications is in the profile menu on the incident pages.
  • The Incident Management workspace is worked out when you sign in. After the add-on has been switched on, or after you have been given a role, sign out and in again to see it.

Security

Every action is checked against the location the incident belongs to, read from the database, not just against your role. A receptionist in Copenhagen cannot open or change an incident in Aarhus, even with a direct link. Private comments are shown to staff only, never to the person who reported the problem or to people from outside the company.

Setup

Turning it on

Incident Management is switched on per location, not per company. An administrator of the company does this.

  1. In the Reception menu, open Company settings → Locations, open the location, and go to its Add-ons section.
  2. Find the incident add-on in the list (the search box above the list finds it when you type incident) and press Set up, or Configure if it is already on. An add-on that is not part of your subscription shows Contact sales instead.
  3. On the add-on's page, Incidents, choose any incident administrators (below), then press Save and switch on.
  4. Repeat for every location that should take reports.

Once the add-on is on, its page has an Incident module card with Start the setup guide (while nothing is set up yet), Open module settings and, while Assets is switched on, Open templates for the asset templates. Everything else is set on the module's own pages.

Incident administrators

List of hosts

Hosts who administer incidents at this location without being administrators of the company. They manage every incident there and can change the module settings. Company administrators can do this already. Only an administrator of the company can change who is on the list, and anyone who is no longer a host of the company is taken off it when you save.

The setup guide

A built-in guide takes a new location from nothing to its first test report in seven short steps.

The setup guide's Categories step: ready-made categories, each with a deadline and a priority.
The setup guide's Categories step: ready-made categories, each with a deadline and a priority.

Each step explains one idea in a few sentences and lets you make the first of it right there. Everything can be changed later on the full pages.

StepWhat you do
How it worksRead how a report travels from the QR code to the person who fixes it.
AreasMake your first areas: a building, its floors, its rooms. Add at least one to go on.
CategoriesUnder Pick some to start with, tick ready-made categories that come with an SLA and a priority, or make your own, and choose where each is offered.
AssetsOptional. Add a first asset with a name, the area it is in and a type, and tick what can be reported on that type. Adding one switches Assets on. Skip assets if reporting on areas is enough for now.
TeamGive someone from the company a role, or invite someone from outside. Only an administrator of the company can.
NotificationsPick how much the module tells people: Essentials, Standard or Everything.
Try it: report a test incidentThe page shows the QR code of an area or an asset you choose. Scan it with your phone, report something, and see what happens next.

The guide opens by itself when someone who may set up the module (an administrator of the company or an incident administrator) opens Incidents at a location where nothing is set up yet: no areas, no categories of its own and never an incident. I'll set it up myself on the first step, Skip for now and Finish and go to Incidents stop that for that location in this browser.

To come back to it later, press Open next to Setup guide under More on Module settings, or Open the setup guide on the checklist at the top of the incident list.

The checklist

Until the first incident arrives, people who may set up the module see Get this location ready at the top of the incident list: Add your areas, Create categories, Choose the categories each area offers, Add your team and Report a test incident. The first four are ticked off from what you have made and link to their page. The last opens the report form. Hide hides the checklist in this browser, and it goes away by itself with the first incident.

Areas

An area is a place where problems are reported: a building, a floor, a room, a car park. Areas sit inside each other, so a location usually has its buildings at the top, their floors inside them and the rooms inside those. Open Areas in the incident menu.

The area tree at Northgate Copenhagen: three addresses at the top, their floors and rooms inside them.
The area tree at Northgate Copenhagen: three addresses at the top, their floors and rooms inside them.

Building the tree

  1. Press New area, give it a Name and press Create area, or Create and add another for the next one.
  2. To put an area inside another, choose Add sub-area in the other area's actions menu.

The actions menu on each area has Open area, Add sub-area, Rename, Copy, Move and Delete. Expand all and Collapse all open and close the whole tree. Area map shows the whole tree as a map you can drag, zoom and search. Click an area to open it. On an area's own page the map opens on that area, marked Here.

  • Move puts an area somewhere else in the tree. Everything in it moves along: its sub-areas, assets, categories and incidents.
  • Copy makes a new area with the same sub-areas, up to 50 copies at once. Under Include, choose whether the Categories (with their SLA and priority) and the Assets come along.

Tip

The quickest way to set up a building: finish one floor completely, with its rooms and categories, then copy it for the other floors.

Watch out

Delete removes the area together with everything in it: its sub-areas, its assets and their category assignments. If anything is in it, you type the area's name to confirm. It cannot be undone. An area with incidents in it, or in an area below it, cannot be deleted: delete those incidents first, or move the area instead.

An area's page

Open area shows everything about one area:

  • Categories: what people can choose when they report a problem here.
  • Its sub-areas and, with Assets switched on, its assets (see Asset Management).
  • With the Meeting rooms add-on, its Meeting rooms: the Microsoft 365 meeting room the area is, or the room it sits in, and the sub-areas below it that are rooms of their own. Rooms are linked to areas under Link rooms to areas in Module settings.
  • With Suppliers switched on, its Suppliers: the suppliers whose contract covers the area, because their scope names the area, an area it sits in, or no area at all. Preferred suppliers come first, and each shows any limits, such as categories. A supplier's scope is changed under Scope and priority on the supplier's page (see Suppliers).
  • With the Scheduler switched on, its Address, for travel planning (see Addresses and travel time).
  • Its QR code.
  • Its incidents, counted for the area and everything below it: Active, Overdue, Within the deadline, Average age and the Newest incidents.

What can be reported in an area

An area offers only the categories ticked on it.

  1. On the area's page, press Choose categories.
  2. Tick a category to offer it, untick it to take it off. Sub-categories are listed under their category, and each is ticked on its own.
  3. Under Also change, tick the sub-areas that should get the same change.
  4. Press Save. Incidents already reported under a category you take off keep it.

SLA and priority on a category's row gives the category its own SLA and priority in this area. Leave a field empty to use the category's own value.

You can also work the other way round: on the Categories page, Areas on a category's card ticks that category on many areas at once.

Nothing is passed down

A category ticked on a building is not offered in its rooms. Tick it on every area where people should be able to choose it, with Also change or with Areas on the Categories page, where ticking an area also ticks the areas inside it. An area with no categories offers only Other. (Areas made inside another area in the setup guide are the exception: they start with the same categories as the area around them.)

Area QR codes

Every area gets its own QR code the moment it is saved. You never type or choose a code. Scanning it opens the report form at that area.

  1. Open the area and press QR code.
  2. Download QR code saves it as a PNG image to print. The copy button next to it (Copy link) copies the address in the code, for an e-mail or an intranet page.
  3. Print it and put it up where people will see it: by the door of a room, in a corridor, next to the coffee machine.

A code on a building or a floor works too: the form then asks which area inside it the problem is in, and the reporter can also report on the building or floor itself.

Assets have QR codes of their own, which open the form at the asset. Pre-printed QR stickers are linked to an area or an asset with Scan a QR code on the area's page. Both are in the Asset Management guide.

The QR code of Meeting room Skyline, ready to download.
The QR code of Meeting room Skyline, ready to download.

Tip

Scan a new code with your own phone before you put it up. The form should open on the right area and offer the categories you expect.

Categories

A category says what a problem is about, such as Plumbing, Cleaning or Doors and locks. It decides what a new incident starts with: its priority, and its SLA, the time allowed to resolve it. Open Categories in the incident menu.

Area categories at Northgate Copenhagen, each with its SLA, its priority and where it is offered.
Area categories at Northgate Copenhagen, each with its SLA, its priority and where it is offered.
TypeOffered when
AreaSomeone reports a problem in a room or space. Can have sub-categories.
AssetSomeone reports a problem with an asset, for example after scanning its QR sticker. Offered on single assets or on whole asset types. No sub-categories. See Asset Management.

Making a category

  1. Press New category.
  2. Give it a Name: what reporters and your team see.
  3. Choose the Type. It cannot be changed later.
  4. Under SLA and priority, set the Default SLA (a number and a Unit: Minutes, Hours or Days) and the Default priority.
  5. Press Create category. The panel that chooses where it is offered opens by itself: tick the areas and press Save. Ticking an area ticks the areas inside it.

Under each list, New area category, New asset category or New maintenance category does the same with the type already chosen.

Add sub-category on an area category lets people be more precise, for example Blocked drain under Plumbing. A sub-category starts with its parent's SLA and priority, and can be added straight to the areas that offer the parent.

SLA and priority

A reported problem gets the priority and the SLA of its category, or the area's own priority and SLA where the area sets them for that category. The SLA gives it its deadline, shown as SLA deadline in the details. Without an SLA, an incident gets no due date and never shows on the SLA risk list.

There are four priorities: Urgent, High, Medium and Low. They are the same at every location and cannot be renamed or added to. A reporter who switches on Mark as urgent makes the incident Urgent.

Other

Every location has Other, marked System. It is always there and offered in every area, so people can report something that fits nowhere else. It cannot be renamed or deleted, but its SLA and priority can be changed. Someone who chooses Other must describe the problem.

The figures on a category

Once a category has been used, its card shows how: Open now (open at the moment), and for the last 30 days its Average resolution time against its SLA, its SLA breaches and its number of Incidents (an asset category shows Assets covered instead). A line at the top of the page warns about categories that are offered nowhere, so nobody can choose them, and about categories without an SLA.

Watch out

Decide the list before you start: a category's type cannot be changed later. Deleting a category also deletes its sub-categories, takes it off every area and asset, and cannot be undone. Incidents already filed under it keep it, but no new incident can be filed under it.

Team and roles

The Team page decides who works with incidents at a location, and what each of them may do. Open it in the incident menu, under People. Only administrators of the company can open it. If the company uses the module at several locations, the location menu next to the title switches between them.

  1. Press Add a person and pick someone from the company under Person.
  2. Under Roles, choose what they do here (see the table below).
  3. Press Add to the team. The person's card shows their role from then on.

Edit on a card changes the role later. Remove from the team, in the card's menu, takes away their role at this location. Their user account stays, and so do any filter groups they are in, until you edit them.

The team at Northgate Copenhagen: Laura is the admin, Tom, Priya and Sam are executors.
The team at Northgate Copenhagen: Laura is the admin, Tom, Priya and Sam are executors.
RoleWhat they do here
AdminHears about every new incident at the location and can set up its areas and categories. To work the incident list as well, they must also be an administrator of the company, a receptionist here or an incident administrator. Incident administrators are listed here as Admin.
ExecutorDoes the work: can be given incidents, and has a lane on the Scheduler.
ReporterReports problems and follows their own reports.
ExternalSomeone from outside the company, such as a contractor. Sees only the work they are given.
ManagerPlans and follows the work their filter groups cover. Only with Teams and scoped access.
Office managerReads everything at the location, reports and comments, and never changes anything. Only with Teams and scoped access.

Executor on top of another role

Executor on top of Admin, Manager or External also gives a person work and a lane on the Scheduler. This is how you set up the facility manager who runs the module and also fixes things, or a contractor you hand jobs to: tick both. An external person cannot also be an admin.

Inviting someone from outside

  1. Press Invite an external person.
  2. Under The person, fill in their details. If the e-mail address already has a BmyGuest account, that account is used.
  3. Under Executor access, choose No executor access (the default), Executor, any work at this location or one of the executor filter groups. They can be given incidents to do only with executor access, which also lets the Scheduler plan their day. Without it they can still be added to an incident as a stakeholder.
  4. Leave Email notifications on to send them incident e-mails as well as the notifications in BmyGuest.
  5. Press Send invitation. They get the External role and a sign-in link by e-mail.

Filter groups and skills

With Teams and scoped access switched on, the Team page also has Filter groups. A filter group is a named set of areas, categories and assets, for example Plumbing or Building A, made with New filter group. It decides which work its members see as Manager, or are given as Executor. Several people can share one.

An executor group works as a skill: the Scheduler and Auto-plan only give its members work the group covers, and being in one also makes someone an executor. A group's role is set when it is made, so make a new group for the other role.

Suppliers

With Suppliers switched on in Module settings, administrators of the company get Suppliers in the incident menu. It is a register of the outside firms you work with. Each supplier has its People, its Scope and priority and its Purchase orders, and Invoicing gathers the costs they register, with Export to CSV.

A supplier's people find the work in their firm's scope under Work from client in their menu. A supplier's manager lands there when signing in, and the supplier's executors land on My work.

Module settings

Module settings switches the optional features on and off for one location, and sets its notifications and the Scheduler's calendar options. Open Module settings at the bottom of the incident menu. Administrators of the company and incident administrators can open it, and receptionists cannot. If you look after several locations, choose one under Location.

Incidents, areas, categories, the team and QR codes are always on. The rest is off until the location needs it, and the menu shows only what is on.

The Features card at Northgate Copenhagen. Assets and the Scheduler are in use, so they stay on.
The Features card at Northgate Copenhagen. Assets and the Scheduler are in use, so they stay on.

Features

Assets

On / off

A register of the things in your areas, such as machines, furniture and installations, with types, templates and documents. Shows Assets in the menu. See Asset Management.

Equipment hand-out

On / off

Assets people borrow and return, such as laptops and keys, with a record of who holds what. Needs Assets, and adds the Equipment tab to the asset register. See Asset Management.

Scheduler

On / off

Plan who does what on which day, by drag and drop or automatically. Shows the Scheduler in the menu, My week for executors, and the Scheduler card on this page. See Planning the week.

Teams and scoped access

On / off

Managers who see part of the work, office managers who read everything and change nothing, and filter groups that decide who sees what. Offers those roles and filter groups on the Team page.

Suppliers

On / off

External firms with their own people, a scope of work, purchase orders and invoicing. Shows Suppliers in the menu, and Work from client for suppliers' people. See Suppliers.

Why a switch will not go off

A feature in use cannot be switched off. The line under it says In use and what is using it, and it stays on until those are gone, so nothing keeps working out of sight. A feature nobody has set yet is worked out from what the location has used, and the line under it says so. Press Save changes, and the page reloads with the new menu.

To give the company's other locations the same features, use Use these features at your other locations at the bottom of the page and press Copy. It copies this location's features as they are now. A feature in use at another location stays on there. The card shows when other locations of the company have the add-on.

The Scheduler card

Shown while the Scheduler is on. Under Travel time, Open next to Addresses opens the address book (see Addresses and travel time). Under Outlook calendar there are three options:

Show when people are busy

On / off

Reads executors' Microsoft 365 calendars and shows their meetings on the Scheduler. Your Entra administrator must first consent to calendar reading.

Allow meeting titles

On / off

Lets a planner switch on the titles of meetings (Appointment details on the Scheduler). Meetings marked private never show their title. Needs Show when people are busy.

Meetings use up working time

On / off

A day with meetings has less time left for planned work. Off, the day runs that much longer instead; work is never planned during a meeting either way. Needs Show when people are busy.

Notifications

The Notifications card: the level at the top, then one row per notification.
The Notifications card: the level at the top, then one row per notification.

Essentials / Standard / Everything

Choice · default Standard

  • Essentials: people hear about work handed to them, urgent incidents, mentions and their own overdue work. Administrators hear about new incidents. Reporters hear when it is fixed, and those who are not the location’s own staff also get a receipt.
  • Standard (recommended): Essentials, plus messages on the incidents people work on (at most one mail an hour per incident), a warning the day before work is due, and when tasks are completed or incidents reopened.
  • Everything: Standard, plus plan changes, overdue work in a manager's area, and every message on incidents in their area (at most one mail every 15 minutes per incident).

A level sets defaults, not limits: everyone can still change their own. Change a single row's Default on afterwards and the card says Custom. Picking a level again puts the rows back.

Default on · E-mail · Teams / Slack

Three switches per notification

Default on is what people get until they choose for themselves. Switching E-mail or the chat switch off stops that notification on that channel for everybody at the location, and nobody can switch it back on for themselves. The chat column shows when your company uses the BmyGuest bot in Microsoft Teams or Slack, and is headed Teams, Slack or Teams / Slack after what you use. A notification that belongs to a feature that is off is not listed.

Default message cooldown

Every message, or at most every 15 minutes, every hour, every 4 hours or once a day · default from the level

After a message on an incident, further messages wait this long and then come together in one notification. If the person opens the incident first, they are not sent. Mentions always come straight away. People can choose their own.

Urgent priorities

Priorities

An incident with one of these priorities sends the Urgent incident notification. Until you save, Urgent counts as urgent.

More

The More card opens the Setup guide, the Activity log and, for administrators of the company, the Incident administrators list, which is kept on the add-on's own page.

Addresses and travel time

For sites spread over several addresses, the Scheduler and Auto-plan can count the driving time between jobs. With the Scheduler switched on, open Module settings and press Open next to Addresses, under Travel time.

  1. Add the places where work happens. Each address is looked up on the map when you save it, and shows On the map, Not on the map yet or Not found.
  2. Under Executors' start addresses, give each executor the address where their day starts. Without one, the day starts at the first incident.
  3. On each area's page, Set address picks one from the address book, and Also change gives it to the sub-areas you tick. Nothing is passed down: every area has its own, and an area without one is left out when the Scheduler plans travel between jobs.

Needs the map service

Travel time relies on a map service on the BmyGuest server. Where it is not available, the Addresses page says so, and planning works without driving times.

Reporting

Reporting a problem with a QR code

The form a QR code opens is built for a phone. Nobody needs an account or an app.

  1. Scan the QR code with the phone's camera and open the link.
  2. Select area: if the scanned area has areas inside it, the form says where you are and lists them. Pick the one the problem is in (an area with more areas inside it opens those), or press Continue to report on the area you are at.
  3. What's the issue?: tap what the problem is about. A category with sub-categories opens them. Where the area has assets, they are shown after the categories: tap one, and the form shows what can be reported on it.
  4. Describe the problem: write a short description (required for Other), add a Photo taken with the camera or chosen from the phone, and switch on Mark as urgent if it needs attention right away.
  5. Press Report. Someone who is not signed in is then asked for an e-mail address (below).
  6. Thank you! confirms the report has been sent. Report another starts again at the same area.

If you are signed in to BmyGuest on the phone, the form leaves out the e-mail step: the report is filed under your name, and you see it on My reports straight after.

Already reported

Once a category is chosen, the form looks for open reports of the same thing in the same place (not for Other). If it finds one, Already reported lists it. Press Report anyway if what you see looks different or has got worse. Cancel ends with Nothing reported: no new report was created, and Report something else goes back to What's the issue? for the same area.

That keeps ten reports of the same broken coffee machine down to one, without ever stopping someone with a new problem.

The coffee machine already has an open report.
The coffee machine already has an open report.

Without an account

  1. Your email: We use this to connect the report to you. No password needed. Type the address and press Continue.
  2. If the address belongs to someone in the company (a host, a receptionist or an administrator), the report is sent straight away under their name. It shows on their My reports, and they are told about it as if they had reported it signed in.
  3. If not, Your details asks for a Name and a Mobile phone number, both required. Press Report.

What an anonymous reporter gets

Someone whose e-mail address the company does not know gets an on-screen confirmation only. There is no receipt by e-mail, and no way to follow the report. Their name, e-mail address and phone number are kept on the incident, so the team can get in touch.

What happens to the report

The report is on the Incidents list at once, as Unassigned, with the priority of its category, or the area's own (Urgent, if it was marked as urgent) and a deadline from its SLA. The people who oversee the location are told (see Notifications). From there the team takes over: Giving an incident to someone.

Reporting from the menu

Report a problem in the reporter's menu opens the whole form on one page:

  1. Where is it?: pick the room or area. Type to search.
  2. What is wrong?: if it is about one thing in the room, pick it under Item (optional) first. Then tap what the problem is about.
  3. Describe it: a few words, Add photos or Take a photo (JPG, PNG, GIF, BMP or WEBP, up to 10 MB each), and Mark as urgent if it needs attention right away.
  4. Press Send report.

An open report of the same thing in the same place is shown before you send, as on the QR form. If you hold equipment borrowed from the location, the form also offers Or report something you are carrying. After sending, Thank you, your report is in appears at the top of My reports.

Report a problem, signed in as Grace.
Report a problem, signed in as Grace.

My reports

My reports lists everything you have reported, under Open (newest first) and Done (most recently done first), with a search box. Each report shows how far it has come, Received, With the team, Planned or Done, with a line such as Waiting to be picked up or the day it is planned for. Updated marks a report where something has happened since you last looked.

Grace's reports: one received, one with the team, one planned, one done.
Grace's reports: one received, one with the team, one planned, one done.

Click a report to open its details: Progress, with a line saying what happens next, then Details, the description, any photos and Messages.

  • Messages: write to the team handling your report. Their answers show up here.
  • Edit report: change where it is, what it is about or how you described it, until somebody on the team picks it up or it is done.
  • Withdraw report: for the first five minutes after you report something, and only while nobody on the team has picked it up, you can take it back. It is removed and the team will not work on it. On the list it is in the menu next to Edit.

What you are told

When something you reported is marked done, you get Your report is resolved. If you are not one of the location's own staff, you also get Your report was received when you report something. Both come by e-mail, and in Teams or Slack where your company uses the BmyGuest bot. You see the team's messages to you, never their private comments.

Daily work

The incident list

Open Incidents in the incident menu. Each open incident is a block, and once it is split into tasks, its tasks are rows under it. Click a block to open the details.

The list shows one location at a time, and opens at the location you last worked at. If you look after several, the location menu next to the title switches between them, and the incident menu follows the location you choose.

Counters

CounterCounts
UnassignedOpen incidents nobody has been given yet.
AssignedIncidents with an executor but no planned day.
ScheduledIncidents planned for today or a later day.
Reschedule!Incidents planned for a day that has passed.
DoneIncidents marked done.

Click a counter to see only those. A red badge on a counter shows how many of them are past their due date.

Search and filters

  • Search incidents... finds incidents by their description, number, place, category, executor, status or stakeholders.
  • Next to All (every open incident) are the quick filters Done, SLA risk (open incidents past their SLA deadline, or in the last quarter of their SLA) and Deleted.
  • Filters narrows the list by priority, category, area, executor and more. Save current view keeps a filter, which then shows as a button in the toolbar.
  • The chart button, Deadlines, shows or hides the strip of the coming two weeks: how many incidents are due each day, how many are overdue and how many have no deadline. Click a day to see only the open incidents due that day. Click it again, or the × on the filter it adds, to see them all.

Seeing it as another role

View as in the top bar switches between Admin view, Manager view, Executor view and Reporter view, so you see the module as that role does. Administrators get all four, and managers all but Admin view. The bell beside it holds your notifications.

Registering an incident yourself

For a problem that was phoned in or spotted on a round, press Create incident.

  1. Under Location, choose the area. Then choose the Category, or an Asset if the area has assets.
  2. Write a Description. It is required.
  3. Set what you already know: Priority, Target due date, who it is Assigned to, Stakeholders, and photos under Attachments. An administrator can also choose who it is Reported by: Myself, or someone they report it for.
  4. Press Save incident.

The checklist is added afterwards, in the incident's details.

Incident details

Click an incident to open its details in a panel from the right. You change things in place: click a row, make the change, and it is saved. A pen marks what you may change. The category and the status are shown under the title. The Open the incident button in the e-mails opens the same details on a page of its own.

The details of Projector not working, in Meeting room Skyline.
The details of Projector not working, in Meeting room Skyline.
SectionWhat it holds
Incident detailsPriority, Area, Asset, Executor, Stakeholders, Reported by and Reported.
Time & schedulingDue date, SLA deadline and Scheduled date.
WorkloadEstimated and Spent time.
DescriptionWhat was reported. Click to edit.
PhotosThe reporter's photos, and yours.
Task planThe incident's tasks, once it is split into tasks.
ChecklistThe steps of the job, each with an estimate.
HistoryA timeline of the incident: when it was created and scheduled, its SLA deadline and due date, and today.
CommentsThe incident's conversation.

The buttons under the title: Mark done (or Reopen), Restore for a deleted incident, Add photo, Activity log (administrators and receptionists) and, on the right, the bin, Delete incident.

The Asset row, shown when the incident's area has assets, says which asset the incident is on (No asset if none). Click it to choose another. If you move an incident to a place that does not offer its category, you are asked to choose one of that place's categories before the move is saved.

Comments and mentions

Write in Write a comment… and press the send button. Type @ and a name to mention someone: they are told straight away. Everyone involved in the incident sees the comments and hears about new ones, including a reporter who reported it with their account. The reporter's messages from My reports show up here too.

Private comments

Tick Private (visible to staff only) for a comment the reporter must not see. Staff are the location's administrators, receptionists and incident administrators, and the company's own people with the Admin, Manager, Office manager or Executor role there. Reporters, people from outside the company and a supplier's people never see private comments.

Photos, checklist and time

  • Add photo adds a picture, for example of the finished job.
  • Checklist: click to add the steps of the job, each with an estimate. Ticking a step adds its estimate to the time spent.
  • Workload: Estimated is how long the job should take, and the Scheduler plans with it. Spent is the time used. Click to change either.

Giving an incident to someone

  1. Open the incident and click Executor (No executor assigned).
  2. Pick the person. The list offers the people who can be given work here, and greys out anyone who cannot, with the reason.
  3. The incident becomes Assigned, and the executor is told: You are made responsible for an incident.

The executor is responsible for the incident. Stakeholders adds others who should follow it, such as the manager of a building: they are told when they are added and hear about its messages. To give the work a day as well, plan it on the Scheduler, where dragging an incident onto someone's lane assigns and plans it in one go.

Nothing assigns itself

New incidents start unassigned, and someone on the team gives each one to an executor. Auto-plan can suggest executors for many incidents at once, but it saves nothing until you accept.

Statuses

StatusWhen
UnassignedNo executor yet.
AssignedIt has an executor, but no planned day.
ScheduledIt has an executor and a planned day, today or later.
Reschedule!The planned day has passed and it is not done.
DoneMarked done.

The status follows from the incident's executor and scheduled date, so you rarely set it yourself. To set it by hand, click the status under the incident's title in the details.

Marking it done

Press Mark done. If no time spent has been entered, you are asked for it first: an incident cannot be done without it. A reporter who reported it with their account is told it is resolved. Reopen opens a done incident again, and its status is worked out again from its executor and date.

Only the incident's executor or a planner can change its status. Planners are the location's administrators, receptionists and incident administrators, and people with the Admin or Manager role there. Anyone else can still tick off the tasks assigned to them.

Deleting and restoring

Delete incident (the bin under the title) removes an incident registered by mistake. It moves to Deleted on the list, where Restore in its details brings it back. Administrators of the company, receptionists at the location and incident administrators can delete and restore incidents. The person who reported it can withdraw it themselves in the first five minutes, while nobody on the team has picked it up (see My reports).

Tasks

A bigger job can be split into tasks, each with its own executor and day: the electrician first, then the painter. In the details, Task plan holds the tasks, and Split into tasks starts them. On the list, an incident's tasks are rows under its block.

  • Every task has a category. A new task on the incident's own place starts with the incident's category. Otherwise you pick one the place offers.
  • A task can be placed in another area, or on an asset in its area: click its area or its asset on its row in Task plan, or choose them under Area and Asset in Add task. No asset keeps it on just the area. A new task starts where the incident is, and while it stays there it follows the incident.
  • A task goes only to an executor whose filter group covers its category, area and asset. On the Scheduler, the lanes that cannot take it say why.

Opening a task slides it over the incident's details, with the incident dimmed beside it. The back arrow, Esc or a click on the dimmed part takes you back one step, and X closes both. A task opened anywhere, on My work or on the Scheduler, opens with its incident underneath.

When you mark an incident done while it still has open tasks, you are asked Close this incident? and choose Leave them open or Close them too.

A task opened over its incident's details.
A task opened over its incident's details.

Category needed

A few tasks made before every task needed a category, and placed somewhere other than their incident, may still have none. They are marked Category needed: open the task and press Give it a category before you plan it.

My work

My work is the executor's list: the incidents and tasks given to you, and the incidents you are a stakeholder on. External people land here when they sign in, and the e-mails' Open my work button leads here. The counters Assigned, Scheduled, Reschedule! and Done, the search and the quick filters Open, Done and SLA risk work as on the incident list. With the Scheduler on, My week at the top switches to your plan.

Open an item for its details, as on the incident list but without the administrator's buttons: you cannot delete it, and its area, asset and executor are fixed. You can add photos, tick off the checklist, write comments, log your time and mark it done. What you reported yourself is on My reports.

Tom's work today: the network cabinet, with its checklist half done.
Tom's work today: the network cabinet, with its checklist half done.

Planning the week

With the Scheduler switched on in Module settings, planners get Scheduler in the incident menu. It shows who does what on which day: one lane per executor, one column per day, and on the left the backlog of work still to plan.

Next week at Northgate Copenhagen, with Details on: Tom, Priya and Sam's lanes, and the backlog on the left.
Next week at Northgate Copenhagen, with Details on: Tom, Priya and Sam's lanes, and the backlog on the left.

The board

  • The arrows move a week at a time, and This week brings you back. With more than one location, the location menu at the top switches between them.
  • Details shows every chip on the cards. With it off, a card shows its title, place and time, and only what needs attention.
  • A card's time is when the work can be done that day: in the order the day is driven, after the drive to it, and never during one of the person's meetings. A day whose work cannot be done between its meetings is marked like an overbooked day, with Does not fit around the meetings on the day's total.
  • View chooses whether the board shows Weekends, Group by incident (the tasks of one incident on the same lane and day in one stack), Stakeholder items (work you are a stakeholder on, greyed out in your own row) and Appointment details (what people's calendar meetings are about, where the location allows it).
  • Filters narrows the board and the backlog.

The backlog

The Backlog column has two piles: Unscheduled (no day or no executor yet) and Reschedule! (planned for a day that has passed). Move all to Unscheduled empties the Reschedule! pile, either keeping the executor (Unschedule, keep executor) or removing it (Unschedule, remove executor). Hide the backlog folds the column away.

Planning by hand

Drag a card from the backlog onto an executor's lane and day. The incident gets that executor and that day, and becomes Scheduled. Drag it again to move it.

While you drag, the lanes that cannot take the card fold away, and a line says how many are hidden and why: their filter group does not cover its category, area or asset. Show them brings them back, and over such a lane the card says Cannot assign. A padlock on a card keeps it on its day. The lock is released by itself in the night after the day has passed.

Auto-plan

Auto-plan suggests an executor and a day for the work you include, balancing workload, skills and driving time. Deadlines come first, and an SLA counts as one; of the rest, the most urgent priorities are planned soonest. With Show when people are busy on, it plans around people's Outlook meetings: each job goes, in one piece, into free time between them, and nothing is planned on a day the person is away.

  1. Under Incidents to include, choose Unscheduled, Reschedule (past) and Scheduled (future). Include incidents without a time estimate plans those with Minutes to give un-estimated incidents.
  2. Under Planning rules, choose Reset executors already assigned (on, everything is shared out afresh; off, an incident keeps its executor and only gets a day), Start planning from, Plan into following weeks, and the Longest working day, work and driving included. The day starts at 08:00, so 7 h 30 m is 08:00 to 15:30, as the line under the slider shows.
  3. Under Candidate executors, tick who may be given work.
  4. Press Generate suggestions. You get a few plans to choose between, drawn on the board with each card at the time the plan gives it. The summary says how many meetings the plan was fitted around, and warns when someone's calendar could not be read.
  5. Accept plan saves the one you choose. Revert puts the board back as it was.
Auto-plan's suggestions for next week, drawn on the board before anything is saved.
Auto-plan's suggestions for next week, drawn on the board before anything is saved.

What Auto-plan never does

It never gives work to an executor whose filter group does not cover it, never touches a locked incident, and never saves anything before you press Accept plan. With Show when people are busy on, it never plans work during someone's meeting or on a day they are away.

My week

With the Scheduler on, executors get My week: their own plan, on a month calendar. Auto-plan there suggests which day to do each of your jobs, in an efficient driving order. Nothing changes until you accept.

Notifications

The module tells people in three ways: the bell in the top bar of the incident pages, e-mail, and a Microsoft Teams or Slack message where your company uses the BmyGuest bot. There are no push notifications to phones and no SMS.

New incidents and the other oversight notifications go to the people with the Admin, Office manager or Manager role at the location (a Manager only for the work their filter groups cover) and to its incident administrators. An administrator of the company or a receptionist with no role there is not told. Notifications about work go to the people who hold it. Someone who reported a problem with their account hears about their report, and anonymous reporters get nothing. Nobody is told about their own change.

GroupNotificationWhen
My workYou are made responsible for an incidentYou become its executor or a stakeholder.
My workA task is assigned to youSomebody gives you a task.
My workYour work is due soonThe morning of the day before it is due.
My workYour work is overdueThe morning after the due day, while still open.
My workYour plan changedWith the Scheduler on: work is planned for you, moved or taken off your plan. Collected for 30 minutes into one message.
OversightNew incident reportedA problem is reported in your area of responsibility.
OversightUrgent incidentAn incident is reported as urgent, or raised to urgent.
OversightTask completedA task on your incident, or one you handed out, is done.
OversightIncident reopenedA done incident you work on or oversee is opened again.
OversightOverdue in your area of responsibilityThe morning after an incident's due day.
MessagesNew message on your incidentsA message on an incident you work on, reported or wrote in.
MessagesNew message on any incident you overseeA message on an incident in your area you are not working on.
MessagesWhen someone mentions youSomebody writes @your name. Sent straight away.
When I report a problemYour report was receivedYou report a problem with your account, and are not one of the location's staff.
When I report a problemYour report is resolvedWhat you reported is marked done.
SuppliersNew message on your company's workFor a supplier's people: a message on work your company handles, when the client has comments switched on for you.

Each e-mail has a button that leads to the incident or to your work, such as Open the incident, Open my work, See your report or Reply in the incident, and a link to change which notifications you get. Messages follow the cooldown: the first message on an incident is sent, further ones are held back and sent together, and if you open the incident first, they are not sent.

My incident notifications

My incident notifications, in the profile menu on the incident pages, lists the notifications for the roles you hold, each with an E-mail and a Teams or Slack switch. Every change is saved the moment you make it. A notification your organisation has switched off for everybody is marked Turned off by your organisation. Under Messages, How often you are told about new messages overrides the location's cooldown, and mentions always come straight away. The bell shows your notifications either way.

Tom's notifications: his work, messages and his own reports.
Tom's notifications: his work, messages and his own reports.

Activity log

Activity log lists every change to the location's incidents and tasks, newest first and grouped by day, in the location's time: Time, Incident or task, By, Change and Details. The All users and All incidents menus narrow it, and Clear filters shows everything again. In a row, click the incident's number to show only that incident, or a name to show only that person's changes.

Administrators open it from More on Module settings, and receptionists have it in the menu. Both also find Activity log under an incident's title in its details.

Help

Limits and quirks

  • No incident reports or exports. There are counters on the list, figures per category and area, and the activity log, on screen only. Supplier costs, on Invoicing, can be downloaded as a CSV file.
  • No public API. Incidents cannot be created or read through the BmyGuest public REST API.
  • No push notifications or SMS. The bell, e-mail, and Teams or Slack.
  • Anonymous reporters get no receipt and cannot follow their report, unless their e-mail address belongs to someone in the company.
  • The report form a QR code opens is in English, whatever language the person uses. So are its thank-you page and the page for a code that is not set up.
  • Four fixed priorities. Urgent, High, Medium and Low cannot be renamed or added to.
  • A category's type is fixed. To change it, make a new category.
  • Categories are not passed down the area tree.
  • Nothing assigns itself. New incidents wait for someone to give them to an executor.
  • The e-mails' wording is set by BmyGuest and cannot be changed by a company.
  • Travel time needs the map service on the server, and every area and executor needs an address.
  • Maintenance plans, for planned, recurring work, are on the way.
  • The Incident Management workspace needs a role. Someone who reports problems without a role on the Team page finds My reports after reporting signed in, from the buttons in the incident e-mails, or from a saved link.

Troubleshooting

Incident Management is not in my menu.

At a location where the add-on is switched on, the workspace appears for administrators of the company, receptionists, incident administrators and anyone with a role on the Team page. What it opens depends on the role (see How to get there). It is worked out when you sign in, so sign out and in again after the add-on has been switched on or your role has changed. Someone without a role uses the buttons in the incident e-mails.

Scanning a QR code says "This code isn't set up yet".

The sticker has not been linked to an area or an asset. An administrator or receptionist of the company the sticker belongs to, who scans it while signed in, gets Assign this code. It opens Assign QR codes with the code already read, ready for you to choose the area or asset. A sticker BmyGuest has not given to your company yet cannot be linked: the page says so, and BmyGuest support can add it to your company's codes (see Asset Management). Codes downloaded from an area's page are always set up.

The report form only offers Other.

No categories are ticked on that area. Categories are not passed down from the areas above, so tick them on the area itself with Choose categories, or use Areas on a category's card on the Categories page.

An incident has no due date and never shows under SLA risk.

Its category has no SLA. Give the category a Default SLA on the Categories page. Incidents reported after that get a due date. The ones already reported do not.

Mark done asks for time spent.

An incident cannot be marked done without the time spent on it. Enter it when asked, or under Workload in the details. Ticked checklist steps count towards it.

I cannot mark an incident done.

Only the incident's executor or a planner (an administrator, receptionist or incident administrator, or someone with the Admin or Manager role at the location) can change its status. Ask one of them, or ask to be made its executor.

The Scheduler or My week is not in the menu.

Switch on Scheduler under Features in Module settings. Planners then get Scheduler, and executors get My week.

Someone is missing from the executor list or the Scheduler.

They need the Executor role, or Executor ticked on top of their other role on the Team page. An external person invited with No executor access is left out: they can only be given work under Assigned to when an incident is created, and are never planned. While you drag a card on the Scheduler, the lanes whose filter group does not cover that work fold away. Show them brings them back.

Someone gets no incident e-mails.

New incidents are told only to the location's Admins, Office managers, Managers and incident administrators (see Notifications), so check their role on the Team page. On their My incident notifications, check the notification itself, and whether it is Turned off by your organisation: then its E-mail switch is off in Module settings. Message e-mails wait for the cooldown, and are not sent if the person opens the incident first.

A feature will not switch off.

It is in use. The line under it says what is using it, and it stays on until those are gone.

A reporter cannot change their report.

A report can be changed only until somebody on the team picks it up. After that, the reporter writes a message to the team on My reports instead.

I cannot give people roles.

Only an administrator of the company can open the Team page, give roles and invite people. Incident administrators and receptionists cannot.

Button and screen names are given in English, as they appear in the screenshots. If you use BmyGuest in another language, the wording differs, but every screen and button is in the same place. The screenshots show a fictional company, Northgate Group.

Fields marked with * are required.

and preferably

Thank you for your message.

We will get back to you as soon as possible.

Get in touch When you contact us, we will start with a brief, no-obligation conversation about your current setup and needs. If there is a good match, we will schedule a meeting—otherwise, you will have received some helpful advice along the way.
Book a demo Book a no-obligation demo. We will review your needs and show you the solution. To help us assist you in the best possible way, please write a little about what you are looking for below.
Become a partner Are you interested in a partnership? Let's talk.
Talk to us Tell us briefly what you need, for example more locations, door access, meeting rooms, Teams, the API or badge printers. Our sales team will get back to you.