Skip to content

Setting up the app

After installing, the app needs to know which business and which person it belongs to. This is called setting up. There are two ways: access by QR code or link (the easier one, without a password) and signing in with email and password. Both ways lead to the same result: afterwards you see the “Today” view.

Who can do this? Every person for whom the business has created access: technician, office, dispatcher, administrator and owner.

This way needs no password. The office creates the access on the computer, and you tap or scan it on the phone.

In the office, someone opens the “Team” page, chooses your row and taps “Send app access” in the “App” section. There are two options, the details are on the page App access:

  • “Send a link”: The link reaches you by message or printout. It is valid for 3 days.
  • “Show QR code here”: The QR code appears on the screen, you stand next to it and scan it. It is valid for 15 minutes.

In both cases the access is valid only once and is shown only when it is created. A new link makes the old one invalid.

A. Scan the QR code in the app

  1. Open the app. On the sign-in screen, tap “Scan QR code from the office”.
  2. The first time, the phone asks whether the app may use the camera. Tap “Allow”.
  3. Hold the camera on the QR code. At the top of the image it says: “Point the camera at the QR code.”
  4. As soon as the code is recognised, the scanner closes and the setup begins.

If a scanned code does not count as a setup code (for example an asset’s sticker), it says “This is not a setup code.” at the top. The scanner stays open, so you can try again.

B. Scan the QR code with the iPhone’s Camera app

You do not need to open the app for this. Point the iPhone’s normal camera at the QR code and tap the hint “Open eelikField”. The app opens and sets itself up.

C. Tap the link

If you received the link as a message (for example by WhatsApp, Viber or SMS), tap it. The link looks like this: eelikfield.com/e, followed by a long code.

  • If the app is installed, it opens and sets itself up.
  • If it is not installed yet, a page “Set up eelikField” opens with the step “1 · Get the app”. Get the app and then tap the link in the message again, or tap in the step “2 · Set up” on the page.
  • On Android, the link may not open the app directly, but first show the page in the browser. In that case use the step “2 · Set up” there, or option D.

D. Paste the link

If the app does not open by itself, copy the whole link from the message, open the app, tap “Scan QR code from the office” and paste the link in the field “Or paste the link” at the bottom. Then tap “Set up”. It must be the whole link. A bare code without the link is not accepted. Spaces at the edges do not matter.

  1. The app briefly shows “Setting up …”.
  2. A full screen appears with “Welcome, ” and below it “The app is set up for .” Next to it is a dot in your business’s colour. That way you see straight away who you are signed in as.
  3. After about two seconds it continues by itself to “Today”.
  4. After that, the app asks once about notifications (see below).

The app then shows a window “Setup not possible” with the reason. Below it are the buttons “Scan QR code from the office” and “Or sign in with email”, so you can always carry on.

Message Cause What you do
“This link is no longer valid”. It was already used or has expired. The link was already used once, has expired (3 days, 15 minutes for QR codes) or was withdrawn. Get a new link from the office.
“Your access is blocked. Please contact the office.” Your access or your device has been blocked. The link remains unused. The office must unblock the access again (see App access).
“No connection. Tap the link again later.” No network, the request did not arrive. Connect to the internet and tap the link again.
“Too many attempts. Please wait 15 minutes, then tap the link again.” Too many failed attempts came from this connection. Wait 15 minutes.
“The connection was lost. It is unclear whether the setup went through. …” The connection broke while the link was being redeemed. Tap the link again. If the app then says it is no longer valid, get a new one from the office.
“The server rejected the setup. Please ask the office for a new link or sign in with email.” The server did not accept the link. New link from the office, or way 2.
“Setup by link is not available on the server yet. Please sign in with email and password.” Setup by link is not yet switched on on the server. Sign in with email and password (way 2).

The app never repeats an attempt by itself. A link is valid only once. That is why there is no automatic second attempt next time, when the network is back.

This way suits you if you have an account with an email address and password, that is, the same login details as on the web.

  1. Open the app. If the scan button is at the top, you will find the divider “Or sign in with email” below it.
  2. Enter your address under “E-mail”. If someone has already signed in on this phone, the last address is already there. The password is never pre-filled.
  3. Enter your password under “Password”. With the eye icon on the right of the field you show it (“Show password”) or hide it again (“Hide password”).
  4. Tap “Sign in”. The button only becomes active once both fields are filled.

If your email address belongs to more than one business, after “Sign in” the selection “Choose workspace:” appears instead of the button. Below it is a button with the name for each business. Tap your business and the app signs you in there. The app is only ever signed in to one business. If you want to switch to another later, sign out under “Settings” and choose the other business next time.

Message Meaning
“Wrong e-mail or password.” One of the two is wrong. The app deliberately does not say which, so that accounts cannot be probed.
“No active workspace for this account.” The account does not belong to any active business, for example because it is blocked. Ask in the office.
“Too many attempts, please wait a moment.” Too many failed attempts in a short time. Wait a few minutes.
“Sign-in failed, please try again.” An unexpected error. Try again.
“No connection to the server.” No network.
“Multiple workspaces, please try again.” The server reported several businesses but named none. Try again.

If your session has ended, for example because the office has blocked the device or because the phone has not been used for a long time, the top of the sign-in screen says “Session expired, please sign in again.”

Someone is already signed in: the question

Section titled “Someone is already signed in: the question”

If you scan or tap an access while someone is already signed in on the phone, the app does not simply replace the account. This protects the person who is signed in.

Without running time. The window “Switch access?” appears with the text “ () is signed in on this iPhone. Switch to the new access?” (on Android it says “on this device”). You have two buttons:

  • “Switch”: The app signs out the previous person and sets up the new access.
  • “Cancel”: Nothing happens, the link is not redeemed and stays valid on the server.

With running time. If a journey, work or break is currently running for the signed-in person, the app does not switch. The window says: “Please stop the running time first.” With “Go to time” you jump to the running job and stop the time, with “Cancel” you leave everything as it is. In this case the link is not redeemed, so you have to tap it again afterwards.

When switching, times that have not been sent yet and message drafts stay on the phone, separately for each person. The earlier person finds them again when they sign in again. Nobody else ever sees them.

That works, there is no block for owners. The app does not ask about your role when signing in, and the sentence “Technician sign-in” is only the heading. There are two ways:

  1. With email and password (way 2): You sign in with the same details as on the web. That works immediately and without access.
  2. By link or QR code (way 1): On the web, open “Team”, choose your own row and tap “Send app access”. An owner may do this for themselves. An administrator could not do this for an owner.

You should know two things afterwards, because otherwise they cause confusion:

  • The app only shows what belongs to you. Under “Today” are your own appointments. Under “Jobs” are jobs where you are entered under “Responsible” or for which you have an appointment. To get this, switch on the switch “Also works in the field” for yourself in the office under “Team” and schedule yourself on the planning board. Without the switch, the empty planning board says “Nobody to schedule yet”.
  • As an owner you complete as the office. For jobs with several technicians and a team rule, a special case applies to you. It is on the page Completion with a team.

More on the page For owners who work alone.

The app only asks when it needs something. Everything can be changed later in the phone’s settings. Without a permission you carry on working as normal, only the relevant function is missing.

Permission What for When asked Without permission
Camera Photos for the job and for messages, the QR code of an asset, the setup code from the office at the first photo or scan. On the iPhone the app explains beforehand: “The app needs the camera for photos. iOS will ask you once for permission.” You choose photos from the library (Android: gallery). You look up an asset via the asset number. Setup works via the link.
Photo library Add existing pictures to a job or a message when choosing a picture, if the phone asks You can only take new photos with the camera.
Notifications Find out straight away when there is a new appointment, an appointment change or a message iPhone: once right after sign-in, with its own explanation. Android: from Android 13 You only see new things when you open the app.
Location Optionally store the place when signing, if your business has switched that on. On the iPhone also the hint “You are not at the job location” iPhone: when the app needs the location. Android: once when the app starts after sign-in, only if the business captures the location at signing Everything else works as usual.

Notifications on the iPhone. After sign-in, “Allow notifications?” appears with the text “You’ll hear about new appointments and messages right away. The app also works without.” With “Continue” the iPhone’s own prompt comes up, with “Not now” you postpone it. The explanation appears only once. Later you find the choice under “Settings” (see App settings).

Location. What the app does with it is decided by your business on the web under “Settings”, section “Location and place data”: whether the place is stored at signing and how precisely (approximate about 1 km, precise about 100 m). The app does not store a continuous location, but at most a single point at signing. More on the page Completion and signature.

On Android, at the first visit after sign-in there is also a one-off notice that times and status are recorded per job and shown to the office: “Your times and your status are recorded per job and shown to the office.”

  • In the app: “Settings”, then “Sign out”, then confirm. After that a new sign-in is needed.
  • In the office: In the person’s row, under “Devices”, are all devices that have been set up. With “Block” the app signs out on its next contact. A session expires after 90 days without use. If the app is used regularly, it does not expire.

I scanned the QR code, but nothing happens. Check whether the code is still valid: a QR code from the screen is valid for 15 minutes, a sent link for 3 days, both only once. If the app showed “This link is no longer valid” after the scan, ask the office for a new one.

Do I have to set a password after setting up? No. Access by link needs no password. If you also have a web account, sign in there with your web login details.

I have changed phones. What now? Have the office send you a new access and set up the app on the new phone. The office can block the old device.

The app asks for the location. Do I have to agree? No. The app also works without it. Only if your business captures the location at signing, it is then missing in the work report.