Guides

How to run a building on Omaya: getting in, setting up a site, and using what it tells you. The first time, read the first three in order; after that, jump to the one you need.

Finding your way in

Guide	Read it when
Signing in	You have a new account, a new phone for two-factor, a forgotten password, or a colleague who cannot get in. Covers the admin console, staff app sign-in and single sign-on.
The dashboard	You want to know what the first page is telling you, or build a dashboard for your team.
How Omaya fits together	Before anything else. Five pictures that explain most "why is this empty?" questions.

Setting it up

Guide	Read it when
Organisation settings	You want to know what each card under System → Configuration changes: timezone, positioning, GPS, schedule, notifications, retention, the AI model, starter packs.
Setting up a site	You are putting a building in for the first time: location, floors, gateways, zones.
Floor plans and positioning	A floor needs its plan, its scale and its gateways placed, so tags land in the right room.
Indoor and outdoor	You have GPS trackers, or people and vehicles that leave the building: geofences, trips, stops and the handover with indoor positioning.
Beacon and Wi-Fi anchors	You have badges or phones that scan for beacons and Wi-Fi rather than broadcast, such as a cellular badge set to a Bluetooth or Wi-Fi fix, and they need fixed anchors to be placed in a room.
The calibration bench	Tags or gateways read stronger or weaker than they should.
A tag shows in the wrong room	Someone says "it says I'm in the pantry, I'm at my desk".
Teaching Omaya a new sensor	You have a device Omaya does not recognise yet.

Using it

Guide	Read it when
People and assets (entities)	You want to follow a person or a thing, not a tag.
Watching people and assets	You need to know where something is now, or where it has been.
Fall and man-down detection	You want Omaya to notice when someone wearing a tag falls or stops moving, ask them if they are OK, and tell the guards if they do not answer.
Badge settings and commands	You want to change a badge's settings or make it locate, beep or stop an alarm from Omaya, by hand or from a rule. Today this is the MOKO PS101-M.
Your first rule	You want Omaya to tell someone, or do something, when a number crosses a line or something happens: someone enters a place, a gateway goes offline, a work order opens.
Rules on any sensor reading	The rule you need is about a reading that is not in the standard list.
How many were here	Someone asks how many people came, and you need to pick between Footfall, Enter / Exit, People Count, Space Utilisation, Attendance and Loyalty, or have the figure emailed every week.
Scheduled reports in the apps	You want a Facility Management, Toilet Hygiene, Visitor Management or Energy report emailed on a schedule, set up from inside the app or under System › Schedule Report.
Building a custom report	None of the built-in reports answers your question.
Data tables: your own report	You want to keep a log of your own, filled by rules.
OAIA — the AI assistant	You would rather ask a question than build a report.
Who did what: Activity Log and Usage	Someone asks who changed a rule, whether an SMS went out, or who signed in at 2 am.
Getting around Omaya	You have just signed in and want to know how the rail, the page lists, search and the account menu work.
The menu, page by page	You have found a menu item and want to know what it is for.

Where to start, by role

You are	Start with	Then
A facilities manager setting up a building, like Aisha Rahman	How Omaya fits together	Setting up a site, Floor plans and positioning
An operations lead who reads the numbers, like Ravi Kumar	The dashboard	How many were here, Occupancy: which number is which, the Reports menu
A technician installing hardware, like Daniel Lim	Hardware	A tag shows in the wrong room, The calibration bench
Someone who uses one app at work: cleaners, reception, guards	Signing in: app users	The apps, or the mobile app on a phone

Elsewhere in these docs

• Recipes: a business question answered end to end — toilet visits by gender, switching off empty rooms, a leak that becomes a job — plus tips and tricks.
• Apps: each app (Meeting Room, Visitor, Toilet Hygiene, Security Watch and the rest) from the point of view of the people who use it.
• Mobile: the Omaya Mobile phone app.
• Reference: what every number, report and rule metric means.
• AI: every place Omaya uses a language model, what it may read and change, and what it is prevented from doing.
• Integrate: connecting Omaya to your own systems.
• Hardware: installing gateways, tags and sensors.