ConnectorsFactorial

Connect Factorial

Connect Factorial with a company API key, choose which company and HR information Gurusup reads, see how often it refreshes, and fix a key Factorial rejects.

Admins only. Gurusup learns your company announcements, policies, processes and the people information you choose from Factorial, so you can ask "What is our remote work policy, and what have we told customers about it?" and get the policy joined with your docs and support threads. Gurusup only reads Factorial. The one request that is not a plain read asks Factorial for temporary download links to the documents you chose.

At a glance

TopicDetails
Who can connectAdmins
What you needA Factorial company API key with no expiration
What Gurusup readsOnly the types you check, in three areas: Company knowledge, People and Finance and operations
How changes arriveAnnouncements and documents every hour, who's out every 30 minutes, the rest every 6 hours
Past contentImport history, from last week to last year. The estimate counts announcements and documents.
Knowledge accessDefault access, Restricted or Private. See Who can read it.

Before you start

  • You are an admin in Gurusup.
  • In Factorial, you can create an API key under Settings > API keys.
  • Factorial takes one connection per Factorial company in each Gurusup organization.
  • Gurusup reads only what you leave checked, so choose before you connect.

People, hiring, contracts and finance information is sensitive. Those types start off. Restrict the source before you connect if only some people should read what you turn on.

Connect Factorial

Open the Factorial connector

In the sidebar, open Sources, then Catalog, find Factorial (use Search sources if you need to) and click Connect on its row. Its page opens. Next to Organization accounts, click Connect for the organization. The dialog Connect Factorial for the organization opens.

Choose who can read it

In the dialog, under Who can read it, keep Default access, or choose Restricted or Private from Access mode and pick the people.

Create the key

In the dialog, click Show steps below the fields and follow them: in Factorial, open Settings > API keys, choose New API key and give it a name, choose no expiration, select Get my API key and copy it.

Paste it and check the company

Paste the key in Company API key (the hint reads "Paste the company API key from Factorial"). Gurusup says "Checking this Factorial API key…" and then shows the company name. Connect stays off until the check passes. The check only validates the key: counting what Factorial holds never holds Connect back.

Choose what Gurusup reads

Pick the types as described in What you choose. Each type shows how many items Factorial has. If Factorial does not count them within 10 seconds, the counts are left out and a line under the company name reads "Counting is taking too long right now, usually because the company is large. You can still connect."

Connect

Click Connect. A message says "Factorial connected."

What you choose

Three areas, each with a check that shows a dash when only some of its types are on. Click an area to open its types. Checking an area checks every type in it.

AreaOn by defaultTypes
Company knowledgeYesAnnouncements, Processes, Time-off policies, Holidays, Work schedules, Organization, Job postings, Trainings and Projects are on. Documents, Hiring, Performance reviews, Attendance, Contracts and Employee documents start off.
PeopleNoEmployees and Who's out
Finance and operationsNoIT assets, Expenses, Procurement and Finance
  • Announcements has Choose groups and Documents has Choose folders, to leave some out. A new group or folder follows its area.
  • Documents says "Only documents shared with the whole company".
  • Unchecking a type, group or folder removes what it brought in, and checking it again brings it back at the next read.
  • Change your choices later on the Factorial page: open Sources, then Factorial, and change them under Content. Click Save changes; a message says "Factorial reading choices saved." Cancel asks "Discard changes?" and offers Keep editing or Discard changes.

Hiring, Performance reviews, Attendance, Contracts and Employee documents come in only while People is also checked.

If Gurusup could not list your groups and folders in time when you connected, it keeps the choices you made and reads them later, without reconnecting. Under Content, the page says "Reading your Factorial groups and folders…" and the Choose groups and Choose folders pickers stay hidden until the lists load. If they do not load in time, you read "Loading the groups and folders is taking too long right now, usually because the company is large. Your current choices still apply." with a Try again link. Your choices stay as they are either way.

What Gurusup never reads

Gurusup lists it under Gurusup never reads: "Salary and compensation details", "Payroll records", "Bank account details" and "National identifiers and social security numbers".

What Gurusup reads

TypeDocumentWhat it holds
AnnouncementsOne per announcementTitle, text, publish date and group
DocumentsOne per fileThe file's text. Only files shared with the whole company, as PDF, Word, Excel, PowerPoint, text, Markdown, CSV or HTML. The file name is the title.
ProcessesOne per processName, category and description
Time-off policiesOne for allEach policy and leave type with its description, approval and attachment rules, half days and day limits
HolidaysOne per office and yearEach holiday with its date and whether it is a half day
Work schedulesOne per scheduleName, periods, start and end dates
OrganizationOne, "Company structure"Teams, offices, legal entities, roles and levels. Team members' names only while People and Employees are on.
Job postingsOne per postingTitle, status, description, office, team, contract and workplace type, publish date. Never the salary.
TrainingsOne per trainingName, description, objectives, provider, duration and whether it is mandatory
ProjectsOne per projectName, code, description, status, start and end dates

A document that contains personal identifiers is skipped. Under Documents, Gurusup lists them: "N skipped because they contain personal identifiers", then the file names.

How changes arrive

WhatHow often Gurusup reads it
Announcements and documentsEvery hour
Who's outEvery 30 minutes
Everything elseEvery 6 hours

Factorial has no change feed, so Gurusup compares each read with the last one. When you connect, it does not import what Factorial already holds:

  • An announcement or a document comes in when it is published or edited after you connected.
  • For the other types, an item comes in when it changes after you connected, never from before.
  • Holidays, time off, attendance days and expenses count from the day you connect up to today, never ahead. A leave comes in when it starts, not when it is booked.
  • Something deleted in Factorial, or no longer in your choices, is withdrawn: what Gurusup learned only from it leaves, and anything other sources also back stays.

Follow each document on Follow ingestion.

Import past work

Open Import history

On Sources, open the Factorial page. Under History, click Import history.

Pick how far back

Pick Last week, Last month, Last 3 months, Last 6 months or Last year. Gurusup counts the announcements and documents in that window and shows what the import would use out of what you have left this month, in euros.

Import

Click Import. When it finishes, the row reads, for example, "Imported the last month".

A window you already imported shows "Already imported", and you can pick a longer one. What happens when the import costs more than you have left, or stops, is in Import history.

Who can read it

Factorial is one source.

Knowledge accessWho reads it in Brain
Default accessEveryone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them.
RestrictedOnly the people you pick. Administrators are not included unless you pick them.
PrivateOnly you. Administrators are not included.

Gurusup does not copy who can see an item in Factorial. Set the access before you connect and it applies before Gurusup reads anything. To change it later, open the Factorial page and change Access mode under Knowledge access; it saves as soon as you change it. What Gurusup already learned keeps the access it had. See Restrict a source to specific people.

Check that it worked

Check the badge

On Sources, open the Factorial page. Under Organization accounts, the badge reads Connected, and your choices show under Content.

Publish an announcement

Publish a short announcement in Factorial.

Follow it

Open Ingest and pick the Factorial source in the filter. The announcement moves to Learned within about an hour.

Reconnect

If Factorial stops accepting the key, the connection shows Needs reconnect. Click Reconnect on the account's row under Organization accounts.

Create a new key of the same company, paste it in the Reconnect dialog and click Reconnect. Your choices and Knowledge access stay, and the dialog shows only the key. A key from another Factorial company is refused.

Disconnect

On Sources, open the Factorial page. Under Danger zone, open the menu on Disconnect, choose Disconnect and confirm. Gurusup deletes the key it stored and what it learned stays. Gurusup added nothing in Factorial, so there is nothing to remove there, and the key stays valid until you delete it in Factorial. See Remove, disconnect and what stays.

If it does not work

These show under the key while Gurusup reads it, or after "Could not connect Factorial." when you click Connect:

MessageWhat to do
"Factorial rejected this API key. Create a new one in Settings > API keys and reconnect."Create a new key and paste it.
"We couldn't read Factorial right now. Your information is safe; we're on it."Try again in a few minutes. Contact support if it keeps happening.
"We couldn't finish connecting Factorial because of a problem on our side. Your existing sources are safe; contact support for help."Contact support.
"We couldn't connect Factorial because of a problem on our side. Nothing was connected. Contact support for help."Contact support.
"This API key belongs to a different Factorial company. Use a key from the company you're reconnecting."Reconnect with a key of the same company.
"We couldn't save these Factorial choices right now. Your current choices are safe; we're on it."Your choices are unchanged. Try again, then contact support.
"We couldn't read your Factorial groups and folders right now. Your current choices are safe. Contact support if this keeps happening." (under Content)Your choices are unchanged. Click Try again later, then contact support.
"Factorial connection was not found. Refresh the page and try again."Refresh the page.
"The import didn't finish. Try again, and contact support if it keeps failing."Click Try again. If it keeps failing, contact support.
Information stops arrivingWhat to do
The badge reads Needs reconnectSee Reconnect.
The type, group or folder is uncheckedCheck it and click Save changes.
The item is older than the connectionUse Import history for announcements and documents.
The type is over its size limitSee the size limits in How changes arrive.
Ingestion paused, Demo Mode, or the item Paused on IngestSee Connector troubleshooting.

Still stuck? Contact support with the type and what changed in Factorial.