Help centre

Joblogic in chat

Connect Joblogic once for the organisation, then ask Centrus about jobs, engineers, customers, sites, quotes and purchase orders, or ask it to log a job, raise a quote or attach worksheet photos.

Checked against the app on

On this page12 sections
  1. 1What it does
  2. 2Before you start
  3. 3Connect Joblogic
  4. 4Enable it for everyone else
  5. 5Ask your first questions
  6. 6What you can ask
  7. 7Making changes
  8. 8Choose who can use which tools
  9. 9Limits
  10. 10Disconnect
  11. 11Troubleshooting
  12. 12Tools and endpoints reference

What it does

Joblogic connects Centrus chat to your organisation's Joblogic account. When an administrator has connected it, you can ask about jobs, engineers, customers, sites, quotes, purchase orders and job assets in an ordinary chat, and Centrus looks the answer up in Joblogic while you wait. It can also make changes when you ask: log a job, raise a quote or a purchase order, or attach the photos from a subcontractor's worksheet to a job. Your records stay in Joblogic.

app.centrus.ai/app/integrations
Integrations

Connect and manage external services

Request Custom Integration
Custom

Request a custom integration tailored to your specific needs. Our team will work with you to create a bespoke solution.

We can build custom integrations for:

  • Third-party services and platforms
  • In-house systems and databases
  • Workflow automation tools
Submit Request
Joblogic
Not Connected

Configure your organisation's Joblogic connection. All team members will use these credentials.

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
Configure3
How to Use4
2
Simpro
Not Connected

Configure your organisation's Simpro connection. Other users can then Enable it for chat.

  • List the diary with schedules (Date)
  • Look up jobs raised (DateIssued)
  • Create and update jobs, quotes and vendor orders
Connect
How to Use
Google Calendar
Not Connected

Connect your Google Calendar to access meetings and schedule events through Centrus.

  • See meetings and free time
  • Schedule an event
  • Each person signs in with their own Google account
Connect
How to Use
Gmail
Not Connected

Connect your Gmail account to send and read emails through Centrus.

  • Read and send mail from your own inbox
  • Each person signs in with their own Google account
Connect
How to Use
Google Docs
Not Connected

Connect Google Docs to create and format professional documents through Centrus.

  • Create a document from a chat
  • Each person signs in with their own Google account
Connect
How to Use
Google Sheets
Not Connected

Connect Google Sheets to create and manage spreadsheets through Centrus.

  • Create a spreadsheet from a chat
  • Each person signs in with their own Google account
Connect
How to Use
Microsoft Excel
Not Connected

Connect Microsoft Excel to create and manage workbooks through Centrus.

  • Create a workbook from a chat
  • Each person signs in with their own Microsoft account
Connect
How to Use
Microsoft Word
Not Connected

Connect Microsoft Word to create and edit documents through Centrus.

  • Create a document from a chat
  • Each person signs in with their own Microsoft account
Connect
How to Use
  1. 1Integrations, in the menu on the left.
  2. 2The Joblogic card. It reads Not Connected until an administrator connects it.
  3. 3Configure, where an organisation administrator enters the client ID, client secret and tenant ID from Joblogic.
  4. 4How to Use, with example questions for engineers, jobs, customers, financial documents and assets.

An administrator connects Joblogic once for the whole organisation, and everyone else then clicks Enable on the same card. Agents connect to Joblogic separately, on their own steps: see Joblogic in Agent Builder. Connecting on this card does not connect an agent, and connecting an agent does not turn Joblogic on in chat.

Before you start

  • An organisation administrator to connect it. Administrators see Configure on the card. For everyone else, the first button reads Not Available and is greyed out until an administrator has connected, and then it becomes Enable.
  • Three values from Joblogic: the Client ID, the Client Secret and the Tenant ID. Joblogic issues them for API access. The tenant ID is a GUID, such as 7c4e9a12-3b6d-4f80-9a21-6d8e1f0c4b77. If you do not have them, ask whoever manages your Joblogic account.
  • A client ID and secret that Joblogic will accept. Before anything is saved, Centrus asks Joblogic's identity service for an access token, at POST https://identityservice.joblogic.com/connect/token. If Joblogic refuses, nothing is stored. The tenant ID is not part of that check. The window checks only that it is a GUID, so make sure it is your organisation's account.

Client ID

The API client Joblogic issued to your organisation.

Client Secret

The secret for that client. Centrus stores it encrypted.

Tenant ID

Your Joblogic account, as a GUID. Only its format is checked.

Checked before saving: Centrus asks Joblogic for an access token with the client ID and secret, and keeps them only if Joblogic issues one.

The credentials belong to the organisation, not to one person. Everyone who enables Joblogic works through the same API client, so a change made from chat is made with those credentials, whoever asked for it. The Integrations overview explains how organisation connections differ from a personal Microsoft or Google sign-in.

Connect Joblogic

  1. 1Open Integrations from the menu on the left. Joblogic is the first card on the page, after the custom integration tile if you are an administrator.
  2. 2Click Configure. The Connect to Joblogic window opens.
  3. 3Enter the Client ID, the Client Secret and the Tenant ID. All three are required.
  4. 4Click Connect.
Request Custom Integration
Custom

Request a custom integration tailored to your specific needs. Our team will work with you to create a bespoke solution.

We can build custom integrations for:

  • Third-party services and platforms
  • In-house systems and databases
  • Workflow automation tools
Submit Request
Joblogic
Not Connected

Configure your organisation's Joblogic connection. All team members will use these credentials.

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
Configure
How to Use
Simpro
Not Connected

Configure your organisation's Simpro connection. Other users can then Enable it for chat.

  • List the diary with schedules (Date)
  • Look up jobs raised (DateIssued)
  • Create and update jobs, quotes and vendor orders
Connect
How to Use
Connect to Joblogic

Client ID

Meridian-FM-Limited-4821
1

Client Secret

••••••••••••••••••••••
2

Tenant ID

7c4e9a12-3b6d-4f80-9a21-6d8e1f0c4b77
3

Secure Connection: Your credentials are encrypted and stored securely. You can disconnect at any time from this page.

Cancel
Connect4
  1. 1Client ID, from Joblogic.
  2. 2Client Secret, hidden as you type. Click the eye to check it.
  3. 3Tenant ID, your Joblogic account's GUID.
  4. 4Connect, which asks Joblogic for an access token before saving.

Centrus sends the client ID and secret to Joblogic and asks for an access token. Only if Joblogic issues one is the connection saved, with the client secret encrypted. You then see Successfully connected to Joblogic, the window closes, and the card changes to Connected, with a green line reading Connected: Joblogic.

Request Custom Integration
Custom

Request a custom integration tailored to your specific needs. Our team will work with you to create a bespoke solution.

We can build custom integrations for:

  • Third-party services and platforms
  • In-house systems and databases
  • Workflow automation tools
Submit Request
Joblogic
Not Connected

Configure your organisation's Joblogic connection. All team members will use these credentials.

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
Configure
How to Use
Simpro
Not Connected

Configure your organisation's Simpro connection. Other users can then Enable it for chat.

  • List the diary with schedules (Date)
  • Look up jobs raised (DateIssued)
  • Create and update jobs, quotes and vendor orders
Connect
How to Use
Failed to connect to Joblogic. Please check your credentials.And at the top of the page
Connect to Joblogic

Connection Failed

Failed to connect to Joblogic. Please check your credentials.

Shown in the window

Client ID

Meridian-FM-Limited-4821

Client Secret

••••••••••••••••••••••

Tenant ID

7c4e9a12-3b6d-4f80-9a21-6d8e1f0c4b77

Secure Connection: Your credentials are encrypted and stored securely. You can disconnect at any time from this page.

CancelConnect

If anything is wrong, the window stays open so you can correct it. The messages you may see are:

  • Connection Failed, with Failed to connect to Joblogic. Please check your credentials. under it, in the window and at the top of the page: Joblogic did not issue a token for that client ID and secret. The same message covers every refusal, so check both values for a missing character or a stray space.
  • Please enter your Joblogic Client ID, Please enter your Joblogic Client Secret or Please enter your Joblogic Tenant ID, under a box: that box is empty.
  • Please enter a valid GUID, under Tenant ID, followed by an example: the tenant ID is not a GUID. A GUID is 32 letters and numbers in groups of 8, 4, 4, 4 and 12, joined by hyphens.
  • Only organisation administrators can configure Joblogic credentials. Your account is not an administrator. Ask one to connect.
  • Failed to connect to Joblogic, at the top of the page, when Centrus cannot read a more specific reason.

A wrong tenant ID is not caught here. The connection saves, and the first question in chat fails. If that happens, see Troubleshooting.

Enable it for everyone else

Once an administrator has connected, everyone else sees Organisation connected by: with that administrator's name on the card, and the greyed-out Not Available becomes Enable. Clicking Enable copies the administrator's connection to your own account, so you never need the client secret yourself. You see Successfully connected to Joblogic, the same message the administrator saw, and the card shows Connected.

Joblogic
Not Connected

Connect to your organisation's Joblogic to query engineers, jobs, customers, and sites through Centrus.

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
Not Available
How to Use
Before an administrator connects
Joblogic
Not Connected

Connect to your organisation's Joblogic to query engineers, jobs, customers, and sites through Centrus.

Organisation connected by: John Martin

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
Enable
How to Use
Once an administrator has connected
Joblogic
Connected

Connect to your organisation's Joblogic to query engineers, jobs, customers, and sites through Centrus.

✓ Connected: Joblogic

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
How to Use
Disconnect
After you click Enable

Enable is only for people who are not administrators. Another administrator who has not connected still sees Configure, and connects with the three values in the same way.

Integrations works the same way in a phone browser, with the cards in a single column. Joblogic is the first card. Scroll to it if the page heading is in the way, and tap Enable. Each person enables once, and Joblogic is then available to them in every chat.

09:41
Centrus
Integrations

Connect and manage external services

Joblogic
Not Connected

Connect to your organisation's Joblogic to query engineers, jobs, customers, and sites through Centrus.

Organisation connected by: John Martin

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
EnableTap Enable
How to Use
Simpro
Not Connected

Connect Simpro to look up jobs, quotes, invoices, schedules and sites through Centrus.

  • List the diary with schedules (Date)
  • Look up jobs raised (DateIssued)
  • Create and update jobs, quotes and vendor orders
Connect
How to Use

Ask your first questions

Open Chat, start a chat and ask the way you would ask a colleague in the office. Joblogic is available in every chat once you have enabled it, whichever tag you choose. How to Use on the card gives example questions in five groups.

How to use Joblogic with Centrus

15 Powerful Tools

Query engineers, jobs, customers, sites, financial documents, and assets through natural conversation.

Counts 15 of the 28 tools

Engineers & Staff

List Engineers: “List all engineers” or “Find engineers by keyword”

Get Engineer Details: “Show me details for engineer Dylan Hughes”

Get Staff: “Get staff member details”

Jobs & Sites

List Jobs: “What jobs are scheduled for today?” or “Show jobs for customer X”

Get Job Details: “Show me job details” or “What's the status of this job?”

Sites: “List sites for this customer” or “Get site details”

Customers & Contacts

Search Customers: “Find customers by name” or “List all customers”

Get Customer Details: “Show me customer details and contacts”

Get Contact: “Get contact information for this site”

Financial Documents

Purchase Orders: “List purchase orders for this job” or “Get PO details”

Quotes: “Show me quote details” or “Get quotation for this job”

Assets

Job Assets: “List assets for this job” or “Get job asset details”

Organisation-Wide Connection

This integration is configured at the organisation level. All team members share the same Joblogic access.

Close

The window's heading counts 15 tools. That count is out of date: there are 28 Joblogic tools in chat, including logging jobs, raising quotes and purchase orders, and attaching worksheet photos, which the window does not mention. Every tool is listed in the reference. One of the window's examples, "What jobs are scheduled for today?", needs care: chat has no diary, so see Limits before you rely on it.

  • "Which jobs are open at Riverside House?"
  • "Show me details for engineer Dylan Hughes."
  • "How many quotes for Northgate Housing are outstanding?"
  • "List purchase orders for job 10482."

John Martin

Open at Riverside House

last message sent: less than a minute ago

Operations

Which jobs are open at Riverside House?

08:12
Worked · 4 steps
Reading your request
Analysing your request
Listing sites in Joblogic · Riverside House
Listing open jobs in Joblogic
Each look-up in Joblogic

There are 3 open jobs at Riverside House for Northgate Housing: 2 at New Job and 1 Allocated.

JobDescriptionStatusLogged
10482Boiler not firing, Flat 4Allocated09/10/2026
10488Communal lighting fault, stairwell BNew Job12/10/2026
10491Door entry handset not ringing, Flat 11New Job12/10/2026

Job 10482 has been open the longest, since 09/10/2026.

08:12
Type a message...

While Centrus works, the panel above the answer names each look-up as it happens, such as Listing open jobs in Joblogic or Getting a job from Joblogic, with the name you searched for beside it. When the answer is ready, the panel folds to Worked with the number of steps. Open it to see exactly what Centrus looked up in Joblogic before it answered.

Joblogic gives each job two numbers: the job number you see in Joblogic, such as 10482, and an ID it keeps behind the scenes, such as 1126891. Opening a job needs the ID, so when you give a job number, Centrus is told to find the job by that number first. Customers work the same way: a name is searched for before the customer is opened. Carry on in the same chat, with questions like "Which of those are allocated?" or "Log a job at that site", and Centrus keeps track of the job or site you were talking about.

What you can ask

Centrus has 28 Joblogic tools in chat, and picks the right ones from what you ask, so you never choose them yourself. Every tool is listed in the reference.

Jobs

“Which jobs are open at Riverside House?”

“Log a job at Harbour View Apartments: lift alarm sounding.”

Engineers and staff

“Show me details for engineer Dylan Hughes.”

“Which engineer teams do we have?”

Customers and sites

“Find the customer Northgate Housing.”

“List the sites for Northgate Housing.”

Quotes

“How many Northgate Housing quotes are outstanding?”

“Raise a quote for Riverside House: new door entry panel, £1,250.”

Purchase orders

“List purchase orders for job 10482.”

“Show purchase order 4471.”

Worksheet photos

“Which photos are in this worksheet?”

“Attach them to job 10482.”

Job and quote sheets

“Send me the jobsheet for job 10482.”

“Get the quotesheet for quote 2291.”

Job assets

“What assets are on job 10482?”

“Show the boiler on that job.”

  • Jobs. There are two lists. Open jobs are jobs at New Job or Allocated: New Job is freshly logged with nothing done yet, and Allocated means an engineer has been assigned. Centrus fetches every page of both, shows up to 100 jobs, and gives the total with the split between the two. All jobs covers every status, open, completed or cancelled, and gives Joblogic's total count with one page of results. Both can be narrowed to a customer, a site, a keyword, or the dates the jobs were logged. Open one job for its address, appointment and completion dates, status, type, category and priority. Centrus can also log a job: see Making changes.
  • Engineers and staff. Find engineers by name or email, with their contact details, address and whether they are a mobile engineer. Inactive engineers are left out unless you ask for them. Open one engineer for their working hours. List engineer teams, with their trades, areas and number of members. Open an office staff member by their ID.
  • Customers and sites. Find a customer by name, account number or reference, and open one for its address, type, account number, contacts and tags. Find sites by name, for one customer if you like, and open one for its full address and site reference. Both lists include inactive customers and sites. A contact can be opened by its ID for their phone, mobile, email and position.
  • Quotes. Find quotes for a customer or a site, by keyword, or by the dates they were created. Each answer carries a count of every matching quote by status: outstanding (Outstanding and Quote Sent), accepted (Approved and Upgraded, where Upgraded means the quote became a job), rejected, expired and cancelled. Centrus is told to report those counts rather than counting the rows on screen. Open one quote for its lines and total. Centrus can also raise a quote.
  • Purchase orders. List purchase orders for a job, a supplier or a keyword. With no dates, the list covers orders raised in the last 90 days. Open one for its lines, supplier, status and total. Centrus can also raise a purchase order.
  • Worksheet photos. Attach a subcontractor's PDF worksheet to the chat, and Centrus can find the site photos in it and add them to a job in Joblogic. See Making changes.
  • Jobsheets and quotesheets. Ask for the jobsheet of a job, or the quotesheet of a quote, and Joblogic generates the PDF. Centrus saves it and gives you a link in the answer, valid for 7 days. Centrus is told to do this only when you ask for the PDF.
  • Job assets. List the assets on one job, such as a boiler or a fire panel, with their type, serial number, location and status, and open one asset. The list needs the job, so Centrus finds the job first.
  • Job types, categories and priorities. List the labels your Joblogic uses. Centrus uses them to match your words when it logs a job or raises a quote, so "urgent" finds Urgent.

Counts and rows are different. The quote status counts cover every matching quote, up to 1,000, but the rows in an answer are one page of up to 50. Ask for the count when you need a number, and narrow by customer, site or dates when you need the rows themselves.

John Martin

Quotes to chase

last message sent: less than a minute ago

Operations

How many quotes for Northgate Housing are outstanding?

10:05
Worked · 4 steps

Northgate Housing has 46 quotes in Joblogic, and 9 are outstanding. That counts quotes not yet sent and quotes sent and waiting for a reply.

StatusQuotes
Outstanding9
Accepted28
Rejected5
Expired3
Cancelled1

Accepted includes quotes that were upgraded to jobs. Shall I list the 9 outstanding quotes?

10:06
Type a message...

Making changes

4 of the 28 tools change data in Joblogic: they log a job, raise a quote, raise a purchase order, or attach worksheet photos to a job. Each change shows as its own step in the panel above the answer, such as Creating a job in Joblogic or Creating a quote in Joblogic.

Centrus is told to use these tools only when you explicitly ask it to log a job, raise a quote or raise a purchase order. That instruction does not tell Centrus to wait for a second confirmation. When your request is clear, Centrus makes the change in Joblogic straight away. Worksheet photos are the exception: Centrus is told to show you what it found and ask you before it attaches them. Name the site, give the description and any type, category or priority you want, and check the result in Joblogic.

John Martin

Door closer at Riverside House

last message sent: less than a minute ago

Operations

Log a job at Riverside House: communal door closer broken on the ground floor. Urgent priority, and their PO number is NH-7731.

10:40
Worked · 4 steps
Reading your request
Analysing your request
Listing sites in Joblogic · Riverside House
Creating a job in Joblogic
The change, made in Joblogic

Done. Job 10494 is logged at Riverside House for Northgate Housing, as a Reactive job with Urgent priority. Its status is New Job, and the customer's order number NH-7731 is on the job.

Ask me for the jobsheet if you need the PDF.

10:41
Type a message...
  • Logging a job needs a site and a description. The customer comes from the site. If you name a customer who does not own that site, the job is refused with a message saying which customer the site belongs to. The type is Reactive unless you say otherwise, the status is New Job, and the date logged is now. You can add a category, a priority, the customer's order number, your own reference, a preferred appointment, and target attendance and completion dates. Each job logged from chat gets an external ID starting EXT-. Ask for the jobsheet at the same time if you want the PDF straight away.
  • Types, categories and priorities are matched to the labels in your Joblogic, first exactly and then more loosely, so "urgent" finds Urgent. If nothing matches, the job is not logged, and the message lists up to 20 valid labels.
  • Raising a quote needs a site and a description, and the customer comes from the site. It can have a title, a type, a category, a priority, your reference, a parent job, an expiry date, a contact, a phone number and an email address. Each price line is added as an Other line, with the sell price per unit excluding VAT. If a line fails, the quote is still created, and the answer says which line failed. Chat has no tool that sends a quote to the customer.
  • Raising a purchase order needs the job, the supplier and at least one line with a description, a quantity above 0 and a unit price of 0 or more. Chat has no tool that searches for suppliers, so Centrus needs the supplier's ID from Joblogic. The order can also carry an account number, delivery details, instructions and a reference.

Nothing created from chat can be changed or removed from chat. There are no tools that update, cancel or delete a job, quote or purchase order, change a job's status or remove a photo from a job. Correct a mistake in Joblogic itself. There is also no tool that applies one change to many records: each job, quote, order or photo is its own call.

Worksheet photos. When a subcontractor sends a PDF worksheet, attach it to the chat and ask Centrus to put its photos on the job. Centrus reads the most recent PDF in the chat, up to 15MB, and pulls out the images. Images that repeat across pages, such as a logo, and images under 150 pixels or 20KB are dropped. Up to 8 of the largest are checked by an AI vision step, which keeps genuine site photos and gives each a short label, such as Pre-start photo or Completion photo. Attaching needs the job, so Centrus finds it from the job number. Each photo is then added to the job in Joblogic as its own form, named Subcontractor photo followed by its label. If no genuine photos are found, Centrus can attach the whole PDF instead, as Subcontractor worksheet (source PDF).

John Martin

Photos for job 10482

last message sent: 1 minute ago

Operations

This is the subcontractor's worksheet for job 10482. Put the photos on the job.

Worksheet 10482 Flat 4.pdf
14:05
Worked · 3 steps

I found 4 site photos in Worksheet 10482 Flat 4.pdf: Pre-start photo, Boiler close-up, Flue check and Completion photo. 3 other images were logos or too small, so I have left them out.

Shall I attach the 4 photos to job 10482?

14:05
Checked before anything is attached

Yes, attach them.

14:06
Worked · 4 steps

Attached 4 photos from Worksheet 10482 Flat 4.pdf to job 10482. Each one is on the job as Subcontractor photo, followed by its label.

14:06
One form per photo

If a change you expect is missing, an administrator may have switched that tool off for you. The next section is where that switch is set.

Choose who can use which tools

An administrator can switch individual Joblogic tools off for one person on Settings, JobLogic Tools, or for a whole team under Team JobLogic Tools when editing the team. The screen is titled JobLogic Tools and reads Choose which JobLogic tools each user can use in chat. It appears once an administrator has connected Joblogic. A person's own setting wins over their team's. With no personal setting, a tool switched off by any of their teams is off. With nothing set, every tool is on. The Integrations overview explains both screens in full.

JobLogic Tools

Choose which JobLogic tools each user can use in chat.

Save Changes4
Search users...quote
2

Users: 4 | Tools: 4 | Unsaved changes: 1

UserList QuotesGet QuoteCreate QuoteGet Quotesheet

John Martin

john.martin@meridianfm.co.uk

(default)(default)(default)(default)

Sarah Price

sarah.price@meridianfm.co.uk

(default)(default)(default)(default)

Dylan Hughes

dylan.hughes@meridianfm.co.uk

(default)(default)
(user)3
(default)

Priya Shah

priya.shah@meridianfm.co.uk

(team)(team)(team)(team)
  1. 1JobLogic Tools, in Settings. It appears once an administrator has connected.
  2. 2Search users and Filter tools, to find a person or a tool.
  3. 3A tool switched off for one person. The note under each tick shows where the setting comes from: the person, their team, or the default.
  4. 4Save Changes, which applies every change you have made.

The columns use plain names, such as List Open Jobs and Create Quote. Filtering the tools box to quote narrows the grid to List Quotes, Get Quote, Create Quote and Get Quotesheet. Type one word: on this screen the box matches the tool's underlying name, in which the words are not separated by spaces, so open jobs finds nothing while open finds List Open Jobs. A tick you change is marked user until you save. Save Changes stays grey until something has changed. The line under the filters counts the people and tools on screen, and the unsaved changes.

Team JobLogic Tools

This switch does not change BigChange team tool permissions.

Team JobLogic Tools

Apply team-level JobLogic ToolsOn for this team
Save Team JobLogic Tools
quote
ScopeList QuotesGet QuoteCreate QuoteGet Quotesheet
Team

Team JobLogic Tools is on the edit-team window, for an administrator, once Joblogic is connected. The switch is labelled Apply team-level JobLogic Tools. Until it is on, the team's ticks are hidden and not used. Save Team JobLogic Tools stores the switch and any ticks you have changed, and you see Team JobLogic Tools saved. The line under the title says this switch does not change BigChange team tool permissions: it is about this Joblogic switch only. A person who belongs to more than one team is switched off for a tool when any of those teams has it off, unless that person has their own setting.

Limits

  • No diary. Chat has no visit or schedule tool, so it cannot list the jobs booked for a day or say where an engineer is going. Dates you give for jobs filter the date a job was logged. A question such as "What jobs are scheduled for today?" is answered from jobs, not from the diary. Open a job to see its appointment date.
  • Open means New Job or Allocated. A job at any other status, such as Awaiting Parts, is not in the open jobs list. Ask for all jobs at the site or customer to see it.
  • How much comes back. Open jobs show up to 100 jobs, with the full counts. All jobs shows one page: 20 jobs, or 5 when you search for something, and never more than 50, with the total Joblogic reports. Engineers, engineer teams, sites, customers, quotes, purchase orders and job assets show up to 50 rows. Narrow the list by customer, site, keyword or dates rather than treating a long list as complete.
  • Quote counts reach further than the rows. The status counts cover up to 1,000 quotes. A customer with more than that is only partly counted.
  • Purchase orders look back 90 days. With no dates, only orders raised in the last 90 days are listed.
  • One record at a time, and no edits. There is no bulk change, and nothing created from chat can be updated or deleted from chat.
  • When Joblogic is slow. Centrus sets no time limit of its own on a Joblogic look-up, and does not retry one that fails. A jobsheet or quotesheet download waits up to 60 seconds, and a worksheet PDF up to 30 seconds.
  • Files. A jobsheet or quotesheet link lasts 7 days. A worksheet PDF over 15MB is not read.

John Martin

Quotes to chase

last message sent: less than a minute ago

Operations

How many quotes for Northgate Housing are outstanding?

10:05
Working · Listing quotes in Joblogic
Reading your request
Analysing your request
Listing customers in Joblogic · Northgate Housing
Listing quotes in Joblogic
Stays here until Joblogic replies
Type a message...

A long list stays on Listing quotes in Joblogic, or the matching line for jobs, until Joblogic has returned the pages. Quotes take the longest, because Centrus counts the statuses across up to 20 pages. The line does not count pages or rows while it runs. When it finishes, it folds into Worked like any other answer. If a line has not moved for a long time, stop the answer and ask again.

Disconnect

Disconnect on the card removes your own connection only. It happens straight away, without asking you to confirm, and you see Integration disconnected. The card goes back to Enable while an administrator is still connected, so you can turn Joblogic on again at any time. An administrator who disconnects sees Configure again.

Integration disconnected
Joblogic
Connected

Connect to your organisation's Joblogic to query engineers, jobs, customers, and sites through Centrus.

✓ Connected: Joblogic

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
How to Use
Disconnect1
Your connection
Joblogic
Not Connected

Connect to your organisation's Joblogic to query engineers, jobs, customers, and sites through Centrus.

Organisation connected by: John Martin

  • Ask “What jobs are scheduled today?”
  • Search for customers and sites
  • Get engineer details and schedules
  • View quotes and purchase orders
Enable2
How to Use
After Disconnect
  1. 1Disconnect, which removes your own connection without asking you to confirm.
  2. 2Enable, to turn Joblogic back on from the organisation's connection.

When an administrator disconnects, only that person's own connection goes. Everyone who has already clicked Enable keeps working, because each person holds their own copy of the credentials. Someone who has not enabled yet can enable only while at least one administrator is connected. Until then, their card reads Not Available.

To stop all access from Centrus at once, withdraw the client secret in Joblogic. Each copy stops working when its current access token runs out and Centrus asks Joblogic for a new one. Copies do not pick up new credentials by themselves. Once Joblogic issues a new secret, the administrator clicks Disconnect, then Configure, and enters it. Everyone else then clicks Disconnect, then Enable.

Troubleshooting

  • Centrus answers as though Joblogic is not connected. Check that the card says Connected for you, and click Enable if it does not. If it already says Connected, an administrator may have switched your tools off on JobLogic Tools.
  • Request failed with status code 401, or 400, in an answer. Joblogic no longer accepts the credentials, usually because the client secret was changed or withdrawn. The administrator clicks Disconnect, then Configure with the current secret, and everyone else clicks Disconnect and Enable.
  • Every question fails straight after connecting. The tenant ID may be wrong, because the window checks only its format. The administrator disconnects and connects again with the right tenant ID, then everyone else clicks Disconnect and Enable.
  • No Joblogic connection found. Please ask your administrator to connect first. You clicked Enable, but no administrator is connected. Ask one to connect.
  • The answer to "What jobs are scheduled for today?" is not the diary. Chat cannot read the diary, so it answered from jobs. Ask for open jobs at a site or for a customer, and open a job for its appointment date.
  • A job you expected is not in the open jobs. It is at a status other than New Job or Allocated. Ask for all jobs at that site.
  • A job type, category or priority is not a valid Joblogic label. Your word matched none of the labels in your Joblogic. The message lists up to 20 that are valid. Ask again with one of them.
  • Customer/Site mismatch. The site you named belongs to a different customer. Check the site, or leave the customer out so Centrus takes it from the site.
  • A quote was created but a line failed. The answer names the quote and the line. The quote is in Joblogic without that line, so add it in Joblogic.
  • No PDF worksheet attachment was found in this conversation. Attach the PDF to the chat, then ask again. Centrus uses the most recent PDF in the chat.
  • No genuine jobsite photos were found. Every image was a logo, a banner or too small. Ask Centrus to attach the whole PDF to the job instead.
  • The list looks short. You were given one page. Ask for open jobs for the full count, or narrow by customer, site, keyword or dates.

John Martin

Harbour View jobs

last message sent: less than a minute ago

Operations

Which jobs are open at Harbour View Apartments?

16:40
Worked · 3 steps

I couldn't get the open jobs. Joblogic refused the request with Request failed with status code 401, which usually means the client secret was changed or withdrawn in Joblogic. Ask your administrator to reconnect Joblogic on the Integrations page.

16:40
Joblogic refused the credentials
Type a message...

Tools and endpoints reference

There are 28 Joblogic tools in chat: 24 read from Joblogic and 4 change data. The names below match the columns on Settings, JobLogic Tools. Every tool calls https://api.joblogic.com with the tenant ID saved when an administrator connected, except Preview Worksheet Photos, which reads the PDF in the chat. Where a tool needs a job, customer or site ID, Centrus finds the record first if you give a name or a job number such as 10482.

Engineers and staff (4 tools)
ToolWhat it doesReads or changesEndpoint
List EngineersFinds engineers by name or email. Inactive engineers are left out unless asked for. Up to 50, one page.ReadsPOST /api/v1/Engineer/GetAll
Get EngineerOpens one engineer, with contact details and working hours.ReadsGET /api/v1/Engineer/GetById
Get StaffOpens one office staff member by ID.ReadsGET /api/v1/Staff
List Engineer TeamsLists engineer teams, with trades, areas, members and leader. Up to 50.ReadsPOST /api/v1/EngineerTeam/GetAll
Jobs (5 tools)
ToolWhat it doesReads or changesEndpoint
List All JobsLists jobs at every status, by customer, site, keyword or the dates they were logged. One page of 20, or 5 with a search, up to 50, with the total count.ReadsPOST /api/v1/Job/getall
List Open JobsLists jobs at New Job and Allocated, across every page, and shows up to 100 with the counts for each.ReadsPOST /api/v1/Job/getall, once for each status
Get JobOpens one job by its ID, not its job number, with appointment and completion dates.ReadsGET /api/v1/Job/GetById
Get JobsheetGenerates the job's jobsheet PDF and gives a link on the chat, valid for 7 days. Only when you ask for it.ReadsPOST /api/v1/Job/generatejobsheet
Create JobLogs a job at a site. Reactive and New Job unless you say otherwise. Can generate the jobsheet straight away.ChangesPOST /api/v1/Job
Worksheet photos (2 tools)
ToolWhat it doesReads or changesEndpoint
Preview Worksheet PhotosFinds the genuine site photos in the most recent PDF in the chat and labels them. Nothing is sent to Joblogic.ReadsNone. Centrus reads the PDF in the chat.
Attach Worksheet PhotosAdds each photo to a job as its own form, or the whole PDF if there are no genuine photos and you ask for it.ChangesPOST /api/v1/FormsLogbook, once for each photo
Job types, categories and priorities (3 tools)
ToolWhat it doesReads or changesEndpoint
List Job TypesLists the job type labels in your Joblogic, such as Reactive.ReadsPOST /api/v1/JobType/GetAll
List Job CategoriesLists the job category labels. Up to 50.ReadsPOST /api/v1/JobCategory/GetAll
List PrioritiesLists the active priority labels. Up to 50.ReadsPOST /api/v1/Priority/GetAll
Sites (2 tools)
ToolWhat it doesReads or changesEndpoint
List SitesFinds sites by name, for one customer if given. Includes inactive sites. Up to 50.ReadsPOST /api/v1/Site/GetAll
Get SiteOpens one site, with its full address, customer and site reference.ReadsGET /api/v1/Site/GetById
Customers and contacts (3 tools)
ToolWhat it doesReads or changesEndpoint
List CustomersFinds customers by name, account number or reference. Includes inactive customers. Up to 50.ReadsPOST /api/v1/Customer/GetAll
Get CustomerOpens one customer by its ID, not its name, with contacts and tags.ReadsGET /api/v1/Customer/GetById
Get ContactOpens one contact by ID, with phone, mobile, email and position.ReadsGET /api/v1/Contact/GetById
Purchase orders (3 tools)
ToolWhat it doesReads or changesEndpoint
List Purchase OrdersLists purchase orders by job, supplier, keyword or dates. The last 90 days unless you give dates. Up to 50.ReadsPOST /api/v1/purchaseorder/getall
Get Purchase OrderOpens one purchase order, with its lines.ReadsGET /api/v1/purchaseorder
Create Purchase OrderRaises a purchase order on a job for a supplier, with at least one line. Both are given by their Joblogic IDs.ChangesPOST /api/v1/purchaseorder
Quotes (4 tools)
ToolWhat it doesReads or changesEndpoint
List QuotesLists quotes by customer, site, keyword or creation dates. Up to 50 rows, with status counts across up to 1,000 quotes.ReadsPOST /api/v1/Quote/GetAll, with extra pages for the counts
Get QuoteOpens one quote, with its lines and total.ReadsGET /api/v1/Quote/GetById
Create QuoteRaises a quote at a site, with any price lines added as Other lines. It does not send the quote.ChangesPOST /api/v1/Quote, then POST /api/v1/QuoteCost/Other for each line
Get QuotesheetGenerates the quote's quotesheet PDF and gives a link on the chat, valid for 7 days. Only when you ask for it.ReadsPOST /api/v1/Quote/generatedocument
Job assets (2 tools)
ToolWhat it doesReads or changesEndpoint
List Job AssetsLists the assets on one job. It needs the job, which Centrus finds first. Up to 50.ReadsPOST /api/v1/JobAsset/GetAll
Get Job AssetOpens one job asset, with its type, serial number, location and status.ReadsGET /api/v1/JobAsset/GetByUniqueId

More in Joblogic