LineHelp

Connect SimPRO to Line

Pro, BusinessOwner, Manager

Connect SimPRO to Line, and Line knows your SimPRO customers and jobs. When a customer calls, Line shows their name and open jobs. An agent can tell a caller when the engineer is due. Agents, workflows and your team can create SimPRO leads and add notes. You choose what syncs, and in which direction.

Before you start

  • Your workspace must be on Pro or Business. SimPRO counts towards the integrations limit: Pro has 3, Business has no limit.
  • You need the Owner or Manager role in Line.
  • You need a SimPRO Premium build. The SimPRO API works on Premium builds only.
  • You need a SimPRO user with administrator access, to create an API application.
  • Line connects to cloud builds at yourbuild.simprosuite.com or yourbuild.simprocloud.com.

Choose a sign-in method

Line signs in to SimPRO with your own SimPRO application. The application uses one of two sign-in methods. Line accepts both.

MethodHow it worksChoose it when
Client credentials (recommended)Line holds a client ID and a client secret. Line uses them to get a new access token about every hour.You can create a new application for Line. This is the safer choice: if an access token leaks, it stops working within an hour.
API keyLine holds one key. The key works until you delete it in SimPRO.You already have an API key application, or SimPRO offers you only this method. It is quicker to set up.

Both methods give Line the same access to your SimPRO data. With both, Line encrypts the details, and you stop Line's access by deleting the application in SimPRO.

If you use an API key, replace it when you think someone else saw it, or when a person who saw it leaves. Create a new key in SimPRO, then disconnect SimPRO in Line and connect again with the new key.

Create the application in SimPRO

Each SimPRO build has its own applications, so you create one for Line.

  1. Sign in to SimPRO as an administrator.
  2. Select System → Setup → API → Applications.
  3. Select Request Access.
  4. Give the application a name, such as Line.
  5. Select the grant type: Client Credentials (recommended) or API Key.
  6. Send the request. SimPRO can take some time to approve it.
  7. When SimPRO approves it, download the key file.
    • For Client Credentials, the file holds the token URL, the client ID and the client secret.
    • For API Key, the file holds the key.

Keep the key file safe. Anyone with it can read and change your SimPRO data.

Connect SimPRO

  1. In Line, select Integrations in the main menu.
  2. Select SimPRO.
  3. Select Connect SimPRO.
  4. In Sign-in method, select Client credentials or API key. Use the method that your SimPRO application uses.
  5. Select Upload key file, and choose the key file. For an API key, also type the Build name if the file does not hold it. Or select Enter details, and type the Build name. Then type the Client ID and the Client secret, or the API key.
  6. Select Connect.
  7. If your build has more than one company, select the company, then select Use this company.
  8. In Choose what syncs, Line shows the recommended set: caller ID, jobs and call summaries. Change an item if you need to, then select Save. Or select Skip to keep every item Off.

Line checks the details with SimPRO. If SimPRO refuses them, Line keeps nothing and shows the reason. When it works, Line opens the SimPRO Overview.

Reconnect SimPRO

If SimPRO stops accepting Line's details, for example because someone deleted the key, the Overview shows the error and Reconnect.

  1. Select Reconnect.
  2. Enter the new details for the same build, as in "Connect SimPRO".
  3. Select Reconnect.

Line keeps what syncs, the field mapping, and the links to your contacts. To connect a different build or company, select Disconnect first.

Choose what syncs

On the Sync page, set each item. Select Use recommended to turn on caller ID, jobs and call summaries in one step. Then select Save.

ItemChoicesWhat each choice does
Customers and contactsOff, Match only, Pull into Line, Push from Line, Both waysMatch only keeps each customer's name, numbers, email and Do not call flag for caller ID. It creates no Line contacts. Pull into Line creates a Line contact for each SimPRO customer. Push from Line creates a SimPRO customer for each new Line contact with a name. Both ways does both. In When both change, you then choose SimPRO wins or Line wins.
Jobs and visitsOff, Pull into LineLine reads open jobs and the next engineer visit live from SimPRO. Jobs need customers set to Match only, Pull or Both ways.
LeadsOff, Pull into Line, Push from Line, Both waysPush lets agents, workflows and your team create SimPRO leads. Pull lets a new SimPRO lead start a workflow.
NotesOff, Push from LineLine adds notes to the SimPRO customer or job. Choose Call summaries, Call transcripts or Agent and workflow notes.
QuotesOff, Pull into LineA quote status change can start a workflow.

When you turn off an item that pulls data, Line deletes the data it copied for that item. Line contacts that it created stay.

Map fields

The Field mapping page shows which SimPRO field fills each Line field for customers and contacts.

Line fieldSimPRO fieldsNotes
NameGivenName and FamilyName, or CompanyNameAlways mapped.
MobileCellPhone, Phone or AltPhoneA new SimPRO customer gets Line's main number here.
PhonePhone, CellPhone or AltPhoneRead only.
Other phoneAltPhone, Phone or CellPhoneRead only.
EmailEmail
Do not callDoNotCallAlways read. You cannot change it.

On a SimPRO contact, Phone is the contact's work phone.

To stop a number from matching callers, set its field to Not mapped. Use this for a shared office number. Then select Save. Line reads your SimPRO customers again.

When Customers and contacts is Both ways, select the arrow in the Flow column to choose the direction of each field: Two-way, From SimPRO or To SimPRO. In the other modes, the mode sets the direction.

Approval

In Approval, choose what happens when Line creates a lead or adds a note: Runs on its own, or A person approves. New connections start with A person approves.

What SimPRO can do

  • Caller ID. When a SimPRO customer calls, Line shows their SimPRO name. Line reads its own copy of the numbers, so the call never waits for SimPRO.
  • Contact card. A contact linked to SimPRO shows the customer, the Do not call flag, their open jobs and the next visit. In the SimPRO block, your team can select Link, Create lead and Add note.
  • Agent tools. Turn each tool on in an agent's Tools tab. A tool shows only when its item is on in Sync.
    • Find SimPRO customer checks if the person is a SimPRO customer.
    • Get SimPRO job status tells the customer about their open jobs and the next engineer visit.
    • Create SimPRO lead creates a lead. For a new person, it creates the customer and a site first.
    • Add note to SimPRO adds a note to the customer or one of their jobs.
  • Call notes. After a recorded call, Line adds the summary or the transcript to the caller's SimPRO customer, if you turned that note kind on.
  • Workflows. A SimPRO event trigger starts a workflow when a visit is booked or moved, a job or quote changes status, or a lead is created. Workflow steps Create SimPRO lead and Add note to SimPRO write to SimPRO. Line never texts or calls a customer with Do not call set from a SimPRO event.
  • Overview. The Overview page shows the connection status, the build and the company. What syncs shows the direction of each item: From SimPRO, To SimPRO, Two-way, Match only or Off. Select Change to open Sync. While Line reads your SimPRO customers, the page shows how many it has read.
  • Activity. The Activity page lists each sync, link, lead, note and error, with its direction and status. Select Failed to show only the errors. The Activity item in the menu shows the number of errors in the last 24 hours.

How Line protects job details

An agent tells a person about jobs only when their phone number came from the phone network (a call, an SMS or a WhatsApp message) and matches one SimPRO customer. A number typed into Web Chat or an email does not count. The agent cannot look up another person.

How Line matches contacts

Line links a Line contact to a SimPRO record when one phone number or email address matches exactly one record on each side. If two SimPRO records share a number, Line links neither. Open the contact, and select Link in the SimPRO block.

Common problems

I do not see SimPRO in Integrations. SimPRO is not available on your Line account yet. Contact Line support.

SimPRO refused the client ID and secret. Check that SimPRO approved the application, and that it uses the Client Credentials grant. Then connect again.

SimPRO refused the API key. Check that the key is for this build and that nobody deleted it in SimPRO. Check that you typed the correct Build name.

Line could not read the key file. Select Enter details, and type the details from the file.

The Overview says the connection needs attention. SimPRO no longer accepts the client secret or the API key. Someone may have deleted or changed the application in SimPRO. Select Reconnect, and enter the application's current details. Line keeps your settings and links.

A caller's name does not show. Check that Customers and contacts is not Off or Push from Line. The number must be in one SimPRO customer only, and its field must be mapped on Field mapping. Select Sync now on the Overview to read SimPRO again.

An agent does not offer a SimPRO tool. Turn on the item that the tool needs in Sync, then turn the tool on in the agent's Tools tab.

A lead or note did not appear in SimPRO. Open Agents → Work items to see if it waits for a person. Then open Activity on the SimPRO integration in Line to see the error.