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
| Topic | Details |
|---|---|
| Who can connect | Admins |
| What you need | A Factorial company API key with no expiration |
| What Gurusup reads | Only the types you check, in three areas: Company knowledge, People and Finance and operations |
| How changes arrive | Announcements and documents every hour, who's out every 30 minutes, the rest every 6 hours |
| Past content | Import history, from last week to last year. The estimate counts announcements and documents. |
| Knowledge access | Default 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.
| Area | On by default | Types |
|---|---|---|
| Company knowledge | Yes | Announcements, 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. |
| People | No | Employees and Who's out |
| Finance and operations | No | IT 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
| Type | Document | What it holds |
|---|---|---|
| Announcements | One per announcement | Title, text, publish date and group |
| Documents | One per file | The 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. |
| Processes | One per process | Name, category and description |
| Time-off policies | One for all | Each policy and leave type with its description, approval and attachment rules, half days and day limits |
| Holidays | One per office and year | Each holiday with its date and whether it is a half day |
| Work schedules | One per schedule | Name, periods, start and end dates |
| Organization | One, "Company structure" | Teams, offices, legal entities, roles and levels. Team members' names only while People and Employees are on. |
| Job postings | One per posting | Title, status, description, office, team, contract and workplace type, publish date. Never the salary. |
| Trainings | One per training | Name, description, objectives, provider, duration and whether it is mandatory |
| Projects | One per project | Name, 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
| What | How often Gurusup reads it |
|---|---|
| Announcements and documents | Every hour |
| Who's out | Every 30 minutes |
| Everything else | Every 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 access | Who reads it in Brain |
|---|---|
| Default access | Everyone, according to what they are already allowed to see: admins every category, members and agent accounts the categories an admin granted them. |
| Restricted | Only the people you pick. Administrators are not included unless you pick them. |
| Private | Only 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:
| Message | What 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 arriving | What to do |
|---|---|
| The badge reads Needs reconnect | See Reconnect. |
| The type, group or folder is unchecked | Check it and click Save changes. |
| The item is older than the connection | Use Import history for announcements and documents. |
| The type is over its size limit | See the size limits in How changes arrive. |
| Ingestion paused, Demo Mode, or the item Paused on Ingest | See Connector troubleshooting. |
Still stuck? Contact support with the type and what changed in Factorial.