Mobile App

The Survey Mobile App provides native performance with offline support for field work. Complete surveys using voice or form entry, capture photos, and sync when you're back online.

Platforms

Platform	Status
Android	Available
iOS	Ask your administrator
Web (PWA)	Available

Getting the App

Android

Download from the Google Play Store or contact your administrator for the installation link.

iOS

HAMI Voice isn't on the App Store yet. Ask your administrator how to get it on an iPhone.

Web App

Access directly in your browser — works on any device with a modern browser.

---

Survey List Screen

The main screen shows all your surveys with filtering and organisation tools.

Status Filter Tabs

Filter surveys by their current status using the tabs at the top of the screen:

Tab	Shows
All	Every survey regardless of status
Not Started	Surveys that haven't been opened yet
In Progress	Partially completed surveys
Completed	Finished surveys

My Surveys vs Team Surveys

Use the toggle at the top of the list to switch between:

• My Surveys — surveys assigned to you
• Team Surveys — all surveys across your team (requires appropriate permissions)

Survey Cards

Each survey appears as a card showing:

• Template name
• Survey title (if set)
• Progress percentage
• Current status
• Sync status indicator

Refreshing the List

Pull down on the survey list to refresh. This downloads:

• Any new survey assignments
• Updated templates
• Status changes from other devices

---

Creating a New Survey

You can create new surveys directly from the mobile app.

Steps

1. Tap the + button at the top of the survey list
2. Select a survey template from the list
3. Optionally link the survey to a Work Item — this can be a Service Job Line or a Maintenance Job
4. Optionally enter a survey title
5. Tap Create

A survey can be created without selecting a work item — it becomes a standalone survey.

Requirements

• Creating a new survey requires an internet connection — you cannot create surveys while offline
• The template must be downloaded to your device (happens automatically when online)

Linking to a Work Item

The Work Item dropdown shows both Service Job Lines and Maintenance Jobs assigned to you. Each option displays its type (Service Job or Maintenance) along with a reference or due date.

When you link to a Job Line:

• Metadata from the job line (title, assignee, dates, reference) can pre-populate survey fields
• The survey appears in the Job Line's surveys card on the web app
• See Job Lines for details on metadata defaults

When you link to a Maintenance Job:

• Repeatable group instances can be auto-created — one per allocated asset
• Asset metadata (tag, class, status, inspection dates) pre-populates each instance
• The survey detail page shows a Maintenance Job context card with the linked job and items

---

Online vs Offline Mode

Online Mode

When connected to the internet:

• Full voice assistant with AI
• Real-time transcript display
• AI streaming responses
• Reference image display
• Instant progress sync

Offline Mode

When disconnected:

• Form-based data entry — all field types supported
• Client-side validation — rules still enforced
• Photo and video capture — stored locally
• Auto-save — prevents data loss
• Data syncs when connection returns

The app automatically detects connection status and shows an Offline banner at the top of the screen.

You stay signed in while offline for your organisation's offline allowance (14 days by default). Use Lock rather than Sign out, and open the app again with your PIN. See Locking and PIN.

Voice surveys also work offline when your organisation has offline voice switched on, your phone meets the minimum and you have turned it on in Settings.

What Works Offline

Feature	Offline	Online
Form data entry	Yes	Yes
Voice chat	Only with offline voice	Yes
Photo capture	Yes	Yes
Auto-save	Yes	Yes
Place location pins	Yes	Yes
Attach an image sheet	Yes	Yes
Prepare a PDF's pages	No	Yes
Review the report summary	No	Yes
Create new survey	No	Yes
Sync data	No	Yes
Download templates	No	Yes

---

Voice Mode

Tap the microphone button to enter voice mode. See the Voice Assistant guide for full details on speaking naturally, commands, and navigation.

Controls

Button	Action
Red mic	Recording — speak now
Gray mic	Idle — tap to start
Stop	End recording manually

Background Audio

Voice chat continues working when:

• The screen goes dark
• You're multitasking with other apps
• The phone is in your pocket

The app uses wake lock to prevent sleep during active surveys.

---

Headset vs Speaker Mode

The voice experience behaves differently depending on whether you're using a headset or the device speaker. The app auto-detects your audio output and switches mode automatically.

Speaker Mode (Default)

When using the device speaker:

• Microphone mutes while the AI is speaking — this prevents the mic from picking up the AI's voice and creating an echo
• Microphone unmutes automatically after the AI finishes, with a short buffer delay
• You must wait for the AI to finish before speaking

Headset Mode

When using headphones, earbuds, or AirPods:

• Microphone stays open while the AI speaks — since audio goes to your ears, not the speaker, there's no echo risk
• Barge-in enabled — you can start speaking at any time, even while the AI is still talking. The AI stops immediately and processes your input
• Conversations are significantly faster

Auto-Detection

The app detects your audio output automatically:

• Bluetooth headphones/earbuds connected — switches to headset mode
• Wired headphones plugged in — switches to headset mode
• No headphones detected — stays in speaker mode

Manual Override

You can override the auto-detection:

1. Tap the headphone icon in the voice chat header
2. The icon toggles between speaker and headset mode
3. A small dot indicator on the icon shows which mode is active

Icon Reference

Icon	Meaning
Headphone icon (no dot)	Headset mode — auto-detected
Headphone icon (with dot)	Headset mode — manually enabled
Speaker icon	Speaker mode

When to Override

• Force headset mode when using a speakerphone in a quiet room and you want barge-in
• Force speaker mode when your Bluetooth headset has poor mic quality and is causing echo

---

Form Mode

Tap the Form button to enter form mode.

Features

• All field types — text, number, select, date, rating, etc.
• Conditional fields — only shows relevant questions
• Auto-save — saves every 30 seconds automatically
• Field notes — add observations to any field
• Progress sidebar — shows completion and allows jumping to sections
• Sheets and location pins — attach a drawing and mark where each observation is

Navigation

• Scroll through fields naturally
• Tap section headers to collapse/expand
• Use the progress sidebar to jump to specific fields

Batches

A batch is a set of like items tested together, such as 12 bolts. Its card has a By pass / By item switch.

By pass shows one item at a time with only the fields for the current pass:

• Tap an item chip to jump to that item. A finished item is marked done.
• Previous goes back one item. The next button names where it leads: "Next: Bolt 8", "Next pass: hardness", or "End of batch".
• Fill N blanks with … copies a value to every item that has none. Items that already have a value keep it.

By item shows the usual view: everything about one item before the next.

If two items are given the same serial or tag, the value is saved and a note beside the field says which item already has it.

See Batches for how a template sets this up.

Sheets and Location Pins

Form mode is where drawings are attached and pins are placed on site. The web form can do both too (see Drawings & Pins); the phone is the one that works with no signal.

Attach a sheet in the Sheets section, below Photos: Photo (camera), Gallery (an existing image) or PDF (each page becomes a sheet, up to 40 pages). An image is pinnable at once; a PDF is uploaded, virus-scanned and turned into page images on the server, so it needs a connection. A sheet can also be attached from the browser — useful when the drawing is a PDF on a laptop — and appears on the device at its next sync.

Place a pin by tapping the location pin field on an observation's card — it reads "Place pin". A full-screen view opens with the sheet strip along the top:

1. Tap a sheet in the strip to switch to it.
2. Pinch to zoom, drag to pan until the fixed crosshair sits over the spot.
3. Tap Place pin here. Tapping again moves the pin; Remove clears it.
4. Tap Done. Pins save as you place them.

Each observation's card shows "Pinned on N sheets", or a "Pin needed" warning while a required pin is empty. Pins are excluded from the progress percentage, so the footer counts them separately — "2 location pins needed".

A sheet can't be deleted while pins point at it; the app names the observations that still have them.

Full guide: Drawings & Pins →

---

Voice Note Extraction (AI Auto-Fill)

In form mode you can record voice notes describing field values, then have AI automatically extract and populate fields from your recordings. This combines the speed of speaking with the control of form entry.

How It Works

1. Record voice notes — tap the microphone icon next to a field group or repeatable instance to record a voice note describing the data
2. Automatic transcription — voice notes are transcribed in the background
3. Tap the sparkles button — once transcripts are ready, a sparkles icon appears next to the group or instance
4. AI extracts values — the system analyses your transcript against the survey template and auto-fills matching fields
5. Review results — a results modal shows which fields were populated, skipped, or created

Where the Extraction Button Appears

Location	Button Style	When Visible
Field group header	Small sparkles icon	When transcribed voice notes exist for the group
Repeatable group instance	"Extract from N note(s)" button	When transcribed notes exist for the instance
Nested group instance	"Extract from N note(s)" button	When transcribed notes exist for the nested instance

Confidence Indicators

After extraction, small coloured sparkle icons appear next to auto-filled field labels:

Indicator	Meaning
Green sparkle	High confidence — AI is very sure about the value
Yellow sparkle	Medium confidence — review recommended
Orange sparkle	Low confidence — verify carefully

What Gets Extracted

• Text fields — names, descriptions, serial numbers
• Number fields — measurements, counts, readings
• Select fields — matches against available options (including voice aliases)
• Date fields — resolves natural language dates
• Boolean fields — yes/no determinations
• New instances — for repeatable groups, AI can create new instances from your description

Example

You record a voice note while standing at an equipment panel:

"The operating pressure is 142 PSI, temperature is 75 degrees Fahrenheit, and the unit is in good condition. Serial number is Alpha Bravo Charlie one two three."

Tap the sparkles button, and the AI fills in:

• Operating Pressure: 142
• Temperature: 75
• Condition: Good
• Serial Number: ABC123

Tips

• Speak naturally — describe values as you see them, the AI understands context
• Cover multiple fields — one voice note can populate many fields at once
• Record per section — record separate notes for each group or instance for best results
• Check confidence — review yellow and orange sparkle fields before submitting

---

Capturing Media

Photos

Capture photos at the field level or survey level:

1. Tap the camera icon next to a field
2. Take a photo or select from gallery
3. Photo is attached and syncs with the survey

Voice-Prompted Photos

During voice mode, the AI will prompt you to take photos when the template has photo hints configured on specific fields or groups:

AI: "Before we record the serial number, take a photo of the equipment nameplate." [Camera opens — take the photo] AI: "OK, what's the serial number?"

You can also ask for a photo at any time by saying:

• "Take a photo"
• "Take a picture of the damage"
• "Photograph this"

The AI opens the camera and attaches the photo to the current field. After capture, the conversation continues where it left off.

GoPro Camera

On Android, you can connect a GoPro camera for hands-free photo capture via USB-C cable or Bluetooth. When a GoPro is connected, all photo capture buttons use the GoPro instead of the phone camera.

See the full GoPro Integration guide →

Multiple Photos

• Each field can have multiple photos
• Survey-level photos apply to the whole survey
• Photos appear in the media gallery and print preview

Marking Up a Photo

Draw on a photo to point at the defect, right where you're standing.

1. Tap the photo to open it full size.
2. Tap the pen icon at the top (Add markup, or Edit markup if the photo already has some). The Mark up photo screen opens.
3. Pick a tool and a pen colour, then draw on the photo.
4. Tap Save.

Tools: Arrow, Line, Rectangle, Ellipse and Freehand. Two more tools help you work. Pan and zoom moves the photo, and Select picks a shape you've drawn. With a shape selected, tap Delete selected shape to remove it. You can also pinch with two fingers, or use Zoom in, Zoom out and Fit to screen.

Pen colours: Red (the default), Blue, Green, Amber and Black. Each shape keeps the colour it was drawn in. Select a shape and tap a colour to change it.

A photo holds up to 50 shapes. To remove all markup, delete every shape and tap Save.

To leave without saving, tap the close (X) button. If you have unsaved changes, the app asks whether to Discard them.

Where you can do it: in the full-size view of any photo, whether it's attached to a field, a section, a repeated item or a nested item, or sits in Survey Photos. You can only mark up a photo once it has been checked and cleared. A marked-up photo shows a small Marked up badge.

Sheets: open a sheet from the Sheets section, then tap Mark up on the Edit sheet screen. The same tools work. Markup on a sheet is saved on its own, not when you tap Save sheet.

Offline: you can mark up a photo with no signal. The markup shows on the phone straight away and reaches the server on the next sync.

Your original is never changed. The app keeps the clean photo and stores your markup beside it. Open the photo again and tap Edit markup to adjust or remove the markup. Reports and the print preview use the marked-up version. Anyone with access to the survey can mark up photos in the web app too: open the photo and click Add markup or Edit markup.

Voice Notes

Record audio observations attached to field groups or repeatable instances:

1. Tap the microphone icon next to a group header or instance
2. Record your note — describe what you see, measurements, conditions
3. The note is transcribed automatically in the background
4. Use Voice Note Extraction to auto-fill fields from transcripts

Voice notes are also included in the print preview and PDF reports.

Sheets (Drawings and Plans)

Sheets are the drawings, plans and site photos that location pins land on. Add them in the Sheets section of form mode:

Button	Adds
Photo	A photo taken now — a plan on a site wall, say
Gallery	An existing image from the device
PDF	A PDF. Each page becomes its own sheet (40 maximum)

Each attachment shows its progress — "Waiting to upload", "Checking the file…", "Preparing pages…" — and offers Retry if an upload or page preparation fails. Once ready, the row shows the image's dimensions.

Deleting a sheet is refused while pins point at it. Deleting a PDF removes all of its pages.

See Drawings & Pins for the full workflow →

Offline Media

Photos captured offline are:

• Stored locally on the device
• Uploaded automatically when connection returns
• Shown with a sync pending indicator

Image sheets behave the same way, and pins placed offline sync when the connection returns. A PDF added offline uploads later and only becomes pinnable once its pages are prepared.

---

Syncing Data

Automatic Sync

When online, data syncs automatically:

• Field updates sync in real-time
• Photos upload in the background
• Conflicts are resolved automatically

Pull to Refresh

Pull down on the survey list to force a sync. This downloads:

• Updated templates (new versions, new templates)
• Survey updates (status changes, assignments)
• Media files (reference images)

Sync Status Indicators

Indicator	Meaning
Green check	Fully synced
Spinning arrow	Sync in progress
Warning triangle	Sync pending (offline or error)

Conflict Resolution

If the same survey is edited on multiple devices:

• Most recent changes win for survey data
• All photos are preserved (no deletion)
• Server template changes update locally

A Survey Reassigned While You Held Unsent Work

If someone reassigns your survey on the web while your phone holds work it hasn't uploaded, the survey stays in My Surveys and shows Reassigned: not uploaded. The server refuses that work, so the phone doesn't upload it. If the survey is assigned back to you, the work uploads.

If you don't want it, open the survey and tap Remove from this phone. It sits where Archive would be. A message names how many unsent items go with it (answers, photos, sheets or voice notes). It also says the survey will show under Team Surveys at the next sync. Tap Remove to confirm, or cancel to keep it. The unsent work is lost.

A reassigned survey with nothing unsent is removed from My Surveys by itself and shows under Team Surveys. The button is in the HAMI Voice Inspector app only.

---

Clearing Local Data

If you need to reset the app's local storage — for example, after a template update doesn't appear or data seems stale — you can clear local data.

Steps

1. Tap the three-dot menu (top right of the survey list)
2. Tap Clear Local Data
3. Read the confirmation message
4. Tap Confirm

What Gets Deleted

• All locally cached surveys
• Downloaded templates
• Cached reference images
• Pending sync queue (if any)

What Gets Preserved

• Your login credentials and PIN
• App settings
• Any data that has already been synced to the server

After Clearing

The app will re-download all your data from the server on the next sync:

1. Pull to refresh the survey list
2. Templates and surveys re-download
3. Reference images re-cache as you open surveys

When to Use

• Templates not updating to the latest version
• Survey list showing stale or duplicate entries
• Sync seems stuck or inconsistent
• After switching between staging and production environments

---

Completing Surveys

Review Before Completing

1. The app shows a summary of all fields
2. Required fields are highlighted if incomplete
3. Tap any field to edit before submitting

Required photos, signatures and location pins are checked separately from the field count, so the footer can list them even when every field is filled. Completing is refused until they're supplied, naming the observation and the field.

Marking Complete

1. Review all required fields are filled
2. Tap Complete Survey
3. Confirm in the dialog
4. Survey moves to Completed list

After Completion

• Generate PDF reports from the completed survey
• View the read-only survey summary
• Export or share as needed

Reviewing the Executive Summary

When the survey's template has a published report design, the designed report opens with an executive summary written from the survey's answers. You can read, correct and sign it off on the phone before you share the report. You need a connection: the summary is kept on the server.

Before the report. When you tap View designed report and the summary hasn't been written, hasn't been reviewed, or the survey changed after it was written, the app asks first:

• Review summary opens the summary. When you mark it reviewed, the report is built straight away.
• Create report anyway builds the report without a review.
• Cancel goes back.

You can also open it any time with Review summary on the survey screen. If there's no summary yet, the app writes one first; this can take up to a minute.

Editing. Each paragraph is its own text box, and each list item too. Paragraphs you don't change keep their bold and italic. A paragraph you edit is saved as plain text, and the app says so under it. Tables and quotes can't be edited on the phone; edit those on the web. Key findings are cards with a label, a value and a severity (None, Info, Good, Warning, Critical). Add, change or remove them.

Signing off.

• Mark reviewed records your sign-off when you haven't changed anything.
• Save and mark reviewed saves your edits and signs off in one step.
• Save without reviewing keeps your edits for later.
• Rewrite (top right) writes the summary again from the survey as it is now. It replaces your edits.

If the survey changed after the summary was written, a notice says so. Rewrite it, or keep it and mark it reviewed. The full account, including what each kind of summary covers, is on the AI Report Builder page.

---

App Settings

Access settings from the menu icon.

Sync Settings

• Auto-sync — Enable/disable automatic syncing
• Sync on WiFi only — Preserve mobile data

Voice Settings

• Headset mode — Toggle for barge-in capability
• Audio volume — Adjust AI voice volume

Storage

• View storage used by offline data
• Clear cached templates (re-downloads on next sync)

---

Battery and Performance

Tips for Long Field Days

• Close other apps to free memory
• Lower screen brightness when possible
• Use headphones to reduce speaker battery drain
• Enable battery saver if needed (voice still works)

Expected Battery Usage

Mode	Impact
Form mode	Low
Voice mode (active)	Medium
Voice mode (listening)	Medium-Low
Background sync	Minimal

Data Usage

• Voice transcription requires approximately 10-50 KB per utterance
• Photos are compressed before upload
• Templates and reference images are cached locally

---

Troubleshooting

App won't start surveys

• Check internet connection for template download
• Pull to refresh the survey list
• Ensure you're assigned to the survey

Surveys not appearing in the list

• Check the My Surveys / Team Surveys toggle — you may be viewing the wrong scope
• Pull to refresh to download latest assignments
• Verify you have permission to access the survey template

Cannot create a new survey

• Creating surveys requires an internet connection — connect to WiFi or mobile data
• Ensure the template is available and published
• Check that you have permission to create surveys

Voice not working

• Check microphone permission is granted in device settings
• Ensure you're not in airplane mode (voice requires internet)
• Try switching to form mode and back
• Restart the app if the microphone seems stuck

Voice chat not connecting

• Check your internet connection — voice chat requires a stable connection
• Try switching between WiFi and mobile data
• Close and reopen the voice chat
• If using a VPN, try disconnecting temporarily

Photos not uploading

• Check internet connection
• Verify storage permissions
• Force sync from the survey list
• Check available device storage

Can't place a location pin

• The field says "Add a sheet in the Sheets section first" — the survey has no sheets yet
• A greyed-out sheet in the strip isn't ready; the reason is shown under its thumbnail
• A PDF still says "Preparing pages" — it needs a connection, then tap Retry if it fails

Sheet won't delete

Pins still point at it. The message names the observations — clear or move their pins first.

Sync stuck

• Check internet connection
• Try pulling to refresh
• Try clearing local data and re-syncing
• If persistent, restart the app

Offline data concerns

• Data is stored securely on device
• Multiple backups during auto-save
• Never lost during normal operation
• Syncs automatically when connection restores
• If worried about data loss, connect to WiFi and verify the sync indicator shows green