Workspace settings
A Workspace is your team's own space in Ziffr. This chapter goes through its pages one by one: how a Workspace starts, how people join it, and every page in the Workspace menu of the top bar.
Everyone in the Workspace opens these pages, but what each person may change depends on their Workspace Role:
| Role | On these pages |
|---|---|
| Owner | Changes everything, including who else is an Owner and Domain Joining |
| Admin | Changes almost everything, but cannot make or remove Owners, change an Owner's role, or switch Domain Joining |
| Member | Reads most pages, sets their own Away dates and Delivery Preferences, and makes their own Access Keys |
| Guest | The same as a Member, but their Access Keys cannot create anything |
A Workspace can have several Owners, and it always keeps at least one.
The Workspace menu
Choose Workspace in the top bar to open the menu. It holds:
| Page | Who sees it in the menu | Covered |
|---|---|---|
| General | Everyone | Below |
| Members and Groups | Everyone | Below |
| Connectors | Everyone | Below |
| Workflows | Everyone | In Workflows |
| Sources | Everyone | Below |
| Access Keys | Everyone | Below |
| Feeds | Owners and Admins | Below |
| Activity | Everyone | Actions and Activity |
| Audit log | Owners and Admins | Below |
General, Access Keys and Feeds open inside the settings area. It has a side list with two parts: You (your Profile and your Deliveries, see Signing in and your own settings) and Workspace, the same pages as the menu. On a phone the side list becomes one row that you scroll sideways.
Starting a Workspace
After you sign in for the first time and belong to no Workspace yet, Ziffr opens Start a workspace.
- Type the Name of the workspace, such as your name, your team or your company, and choose Create workspace. You become its Owner, and Ziffr opens it.
- If a colleague already uses Ziffr, it is better to ask them to invite you, so you join their Workspace instead of starting a second one.
You can start another Workspace at any time from the menu under your name in the top bar, with New workspace. Everything in one Workspace stays in it; nothing is shared between Workspaces.
Asking to join
If your colleagues' Workspace has Domain Joining switched on, and you signed in with a proven address at the same company domain, the page shows Your colleagues already use Ziffr above the form. It lists each such Workspace with an Ask to join button.
After you ask, the line says "Asked; an owner or admin decides." An Owner or Admin sees your name and address on Members and Groups and lets you in or declines. If they let you in, you join as a Member.
Addresses at public mail providers, such as Gmail or Outlook, never count as a company domain.
Accepting an Invitation
An Invitation reaches you as an email or as a link someone sends you. Opening it asks you to sign in first, then shows Join followed by the Workspace's name and the role you are invited with, such as "You are invited as Member".
- Choose Join. You become part of the Workspace with that role, and Ziffr opens it.
- An Invitation sent to an email address works only for that address. If you are signed in with another one, the page says so: sign out and sign in with the invited address.
- An Invitation works once. If it has ended, was used already or was revoked, the page says "This invitation does not work any more". Ask whoever invited you for a new one.
If you were a Contact before, accepting the Invitation keeps your history: the values you sent in stay under your name.
General
Workspace → General holds the Workspace's name, its time and its Workspace Profile. Owners and Admins change them. Everyone else sees them, with the note "Only Owners and Admins change these."
Name
The Workspace name is what everyone sees in the top bar and in Invitations. Type a new one (up to 80 characters) and choose Save.
Workspace time
Ziffr counts days, working days and Due Dates in the Workspace's own time.
| Option | What it does |
|---|---|
| Time zone | Which day it is for this team. A value that is due "on the 3rd working day" is due by that day here. |
| Workflows run at | The hour of the morning, in that time zone, at which Workflows ask for values, remind and escalate. |
Choose Save after changing either. Members and Guests see a single line, such as "Europe/Berlin, Workflows run at 07:00".
Workspace Profile
The Workspace Profile says what kind of business this is, so Ziffr can suggest the Metrics such teams track. Each part is picked from a list; Not set leaves it open.
| Option | What you pick |
|---|---|
| Industry | For example Software and SaaS, E-commerce, Manufacturing, Health and care, or Something else |
| Customers | Businesses (B2B), Consumers (B2C), Businesses and their customers (B2B2C), Public sector or Non-profit |
| Country | Where the business is based. Picking a country proposes its currency. |
| Currency | The currency the Workspace counts in |
| People | How many people work there, from 1 to 10 up to More than 1,000 |
| Revenue a year | From Under 1 million to Over 1 billion, in the Workspace currency |
Choose Save when you are done. Teams within your company, such as Sales or Finance, are not part of the profile: make them Groups on Members and Groups.
In the demo
In the demo nobody changes these settings; the page says "The demo keeps its settings." The demo has no Workspace time: its date is the pretend date on the Workflows page.
Members and Groups
Workspace → Members and Groups shows everyone in the Workspace, their roles, their Groups, their Away dates and the Contacts. The page's title is Team. Everyone sees it; only Owners and Admins see the buttons that change people and Groups.
Members and their roles
The list shows each person with their role. Owners and Admins see a menu next to each person instead:
| Role | What the person may do |
|---|---|
| Owner | Everything, including billing and making or removing Owners |
| Admin | Manages settings, Themes, Groups and members, but not billing, and does not make or remove Owners |
| Member | Creates and shares Metrics, dashboards and decks |
| Guest | Sees only what is shared with them, answers questions and sends in values; creates nothing |
Pick another role and it changes at once. Only an Owner can make someone an Owner or change an Owner's role. The last Owner cannot step down: make someone else Owner first.
Removing someone and handing over
Choose Remove… next to a person. Ziffr asks Who takes over?: pick another person (not a Guest), then choose Remove, or Cancel to stop.
When you remove someone:
- Everything they own, such as their Metrics, dashboards, decks, Workflows, Themes and saved templates, goes to the person who takes over. Nothing others built on is deleted, and the handover shows in each item's Version history.
- Their Tokens, Stand-in roles, Shares, Group memberships and Access Keys end at once.
- A dashboard that took Snapshots by itself stops doing so, so the new owner can choose again.
You cannot remove yourself: ask another Owner or Admin. Only an Owner can remove an Owner. In the demo nobody can be removed.
Inviting people
Owners and Admins see the invitation form below the list.
| Option | What it does |
|---|---|
| Invite by email | The address of the person you invite |
| as | The role they get: Member, Guest or Admin, and Owner if you are an Owner yourself |
| who is the Contact | Shown when the Workspace has Contacts. Pick one if the person you invite is that Contact, so they keep their history. Leave it at nobody yet otherwise. |
| Invite | Makes the Invitation. If this Ziffr sends email, it emails the link too. |
| Link for Members | Makes a link that anyone who has it can use to join as a Member |
After either, the page shows the link so you can send it yourself, for example in a chat.
- An email Invitation works for 14 days, once, and only for that address.
- A link works for 7 days, for anyone who has it, until it ends or you revoke it.
Below the form, open Invitations are listed with their address (or "Link"), their role and the day they end. Where Ziffr sends email, each line also says whether it was emailed, or why not. Resend emails it again; an Invitation can be emailed at most three times. The bin icon revokes it.
There are no Invitations in the demo.
Requests to join
When someone asks to join through Domain Joining, their name and address appear with "asks to join". Choose Let in to make them a Member, or Decline.
Domain Joining
Owners see a checkbox such as "Let people with an address at example.com ask to join". It uses the domain of the address you signed in with, so your address must be proven. Once it is on, the line reads "People with an address at example.com may ask to join", and anyone signing in with an address at that domain sees your Workspace on their welcome page. Nobody gets in by themselves: an Owner or Admin lets each one in.
Domain Joining is off by default and does not work for public mail providers.
Groups and Away dates
The table below the members has one row per person and these columns:
- Person: their name and job.
- Away: the dates they are not available, from and to. While someone is Away, Prompts meant for them go to their Stand-in. Each person sets their own dates here or under Your Deliveries. Owners and Admins can set them for anyone. Clear removes them.
- One column per Group: a tick means the person is in that Group.
A Group is a named set of people, such as Management or Sales. You share things with a Group, or limit a question's Thread to one, and whoever joins the Group later gets the same. Owners and Admins:
- add a Group by typing its name under the table, such as "Finance", and choosing Add;
- rename a Group by clicking its name in the table's header and typing;
- put people in or take them out with the tick boxes;
- delete a Group with the bin icon next to its name. Ziffr asks first: whatever was shared with the Group stops being shared, and Threads limited to it become readable by everyone.
Every Workspace also has the Group Everyone in the workspace: all its members except Guests. Ziffr keeps it up to date, so it is not in the table.
Contacts
A Contact is someone without a login, such as a field worker or an outside bookkeeper. They send in values by Slack, by email or with their personal form link, and the values are recorded under their name. They see nothing in Ziffr.
Owners and Admins add a Contact with Name and at least one of Email, Slack handle (such as @cleo) or Phone, then Add contact. The address or handle must not belong to anyone else in the Workspace. Owners and Admins also see each Contact's details, and the bin icon removes a Contact. Their values stay; their form link stops working and they can no longer send in values.
To give a Contact a login later, invite them by email and pick them under who is the Contact.
Contacts cannot be added in the demo.
Connectors
Workspace → Connectors shows how Ziffr reaches people and how their answers come back. Everyone sees it. See Connecting Ziffr for the bigger picture.
Slack
The Slack box appears when this Ziffr is set up for Slack (never in the demo).
| Option | Who | What it does |
|---|---|---|
| Add to Slack | Owners and Admins | Takes you to Slack to connect one Slack workspace. Back in Ziffr, a line says whether it worked. |
| Disconnect Slack | Owners and Admins | After asking, stops all messages there. Who was found on Slack is forgotten. |
| Link my Slack account | Everyone | Gives you a short code. Send the Ziffr app on Slack the message "link" and the code within ten minutes. |
| Forget me on Slack | Everyone who is linked | Ziffr no longer reaches you on Slack in this Workspace |
| Get them on Slack again | Whoever stopped them | Shown if you pressed "Stop these on Slack" under a Prompt or reminder there |
Once Slack is connected, the box says how Slack knows you: by your email address, or because you linked your account. If your Slack address differs from the one you sign in with, link your account.
A Slack workspace can be connected to one Ziffr Workspace only.
Connected systems
One card per Connector, each with what it can do (receives values, sends reminders, sends questions and tasks, brings replies back, keeps task status in step) and its state:
| Connector | What it does |
|---|---|
| Plain emails; replying to one answers in Ziffr. When this Ziffr sends email, the card says "Sends real email". Otherwise nothing goes out and Ziffr keeps what it would send in the Outbox. | |
| Slack | Direct messages from the Ziffr app; answers in the thread come back. Real once Slack is connected. |
| Short messages from the Ziffr business number. Not live yet: Ziffr only records what it would send. | |
| Ticket system | Tasks become tickets; comments come back, and closing a ticket marks the task done. Not live yet: Ziffr only records what it would send. |
If you stopped Prompts and reminders by email, a note at the top offers Get them by email again.
Who gets what, where
A table of Delivery Preferences: one row per person and one column each for Questions, Tasks, Reminders (which includes Prompts) and Replies and updates.
- The first row, Team default, covers everyone who leaves a column open. Only Owners and Admins change it. Without a team default, Ziffr uses email.
- Your own row is marked "you". Change it here or under Your Deliveries. Everyone else's row is greyed out.
- Replies about a question or task stay where it started, so a ticket collects its comments. Whoever asks a question can pick another way for that one message.
Outbox
The Outbox lists every Delivery you may see, newest first, drawn the way it looks on the other side. Each one shows the Connector, who it went to, when, whether it was answered or closed, and Open thread for a question or task.
For email and Slack, a small label says whether it really went out: Waiting to send, Sending, Emailed, Sent on Slack or Not sent with the reason. A Prompt you have not answered yet may offer Open the form as you, which opens your form.
You see Deliveries about Threads you may read, and Prompts and notices you sent or received. The personal form link in someone else's Prompt is hidden.
Run now (Owners and Admins only, folded away): Ziffr does this by itself every morning. Use it when the schedule did not run, or right after adding people.
- Ask for missing values now asks everyone whose value for the current period is missing.
- Send due reminders now reminds people of tasks due in the next two days.
In the demo
The two Run now buttons sit in a dashed Demo controls box, and anyone may use them. Under each Delivery you can play the recipient: Answer as the person, then Send in the Connector, or Close ticket as the person for a ticket. Answering a Prompt this way records the value. Try sending a value on the Email and Slack cards leads to Sources.
Sources
Workspace → Sources shows where values come from. Everyone sees it.
Form links
Everyone who sends in a Metric has a personal form link for it. The link itself is the permission, so nobody needs to sign in. You see your own links here, one per Metric that takes the web form, and opening one shows the form. If you have none, the page says a Metric gets them when its owner picks the web form as a Source and names who submits.
The simulator (demo only)
In the demo, a Demo controls box shows two pretend inboxes, one for Slack and one for email, both marked "simulated". They go through the same checks as real ones.
- Pick who sends the message, including an unknown sender, type a message such as "closed 2 deals", and send it.
- Under a Prompt from Ziffr, choose Reply to answer it as its recipient.
- Each message shows what happened, such as Recorded, Overwritten, Added up, Kept both, or why it was rejected: a duplicate, a sender who may not submit this Metric, an unknown sender, no number, an unclear Metric, the wrong Source, or a Derived Metric.
Access Keys
Workspace → Access Keys is where you make an Access Key: a secret that lets a program or an AI assistant work in this Workspace on your behalf. A key sees no more than you do, and it stops working when it ends, when it is revoked, or when you leave the Workspace.
Making a key
| Option | What it does |
|---|---|
| Name | So you recognise the key later, such as "Shop export" |
| Read metrics | The program may read the Metrics you may see |
| Submit values | It may send in values where you may |
| Create metrics | It may create Metrics owned by you. Not offered to Guests. |
| Read dashboards | It may read the dashboards you may see |
| Build dashboards | It may build dashboards as you. Not offered to Guests. |
| Until | The last day the key works, through the end of that day in UTC. At most a year ahead. |
| Create key | Makes the key |
The secret is shown once: copy it now, it is not shown again. Give it only to the program that needs it.
The list of keys
Each key shows its name, what it may do, the day it ends (or "revoked") and, for someone else's key, who made it.
- Recent calls opens the key's Access Log: when the program called, what it asked for, and the result. A failed call shows in red.
- The bin icon revokes the key at once.
| Role | Sees | Revokes |
|---|---|---|
| Owner | Every key in the Workspace and its Access Log | Any key |
| Admin | Every key in the Workspace and its Access Log | Their own keys |
| Member or Guest | Their own keys | Their own keys |
The demo has no Access Keys, because a key there would act as a made-up person for anyone.
Feeds
Workspace → Feeds is for Owners and Admins only. Others see a note to ask an Owner or Admin. The demo has no Feeds.
A Feed brings in values from another system, such as a CRM or a data warehouse. It runs outside Ziffr, with a Feed Key that can only record values for the Metrics that take the Feed as a Submitter, never read them. It belongs to the Workspace and keeps working when the person who set it up leaves. See Connecting Ziffr for how Feeds work.
Making a Feed
Under New Feed, type a name, ideally the system it brings values from, such as "HubSpot", and choose Create Feed. Then choose the Feed as a Submitter on each Metric's Settings tab.
Each Feed
| What you see | What it means |
|---|---|
| The name | Click it to rename the Feed, then Save or Cancel |
| last call | When the Feed last called Ziffr with any of its keys, or "no calls yet" |
| last 24 hours | How many values it recorded and, in red, how many were refused |
| Submits to | The Metrics that take this Feed as a Submitter, or a reminder that it submits to none yet |
| The bin icon | Deletes the Feed after asking. Its keys stop at once; its values stay, with its name. |
Feed Keys
Each Feed lists its keys with name, the start of the key, and the day it ends or "revoked". Recent calls opens its Access Log; the bin icon revokes it.
To make a key, type a Key name (such as "Nightly run"; if you leave it empty, Ziffr names it after the Feed), pick Until (at most a year ahead) and choose Create Feed Key. The secret is shown once. Copy it and give it to whoever runs the Feed.
Only Owners and Admins see Feed Keys and their Access Logs.
Audit log
Workspace → Audit log is for Owners and Admins only. It is the Audit Log: who changed who may see or do what, and the decisions taken on numbers. Nothing in it can be changed or removed, and events are kept for two years. Times are shown in the Workspace's time zone.
What is recorded
Role changes and removals, Invitations, requests to join, Domain Joining, Contacts, Shares, Groups, View Links, Access Keys, Feeds and Feed Keys, new dashboards, new and deleted Metrics, a Metric's Workflow, Locks, Workflow runs, Approvals, Corrections, the Workspace's name, time and profile, Slack, Snapshots taken, shown and deleted, exports and sign-ins.
Each event names the person, what happened, what it was about (as it was named then), the time and a few details, such as the old and new role. It never holds a value or a message. A Metric, dashboard or deck you may not see appears without its name, as "a Metric you do not see".
The demo keeps no Audit Log.
Filters
| Option | What it does |
|---|---|
| Person | Only what one person did, or Everyone |
| What happened | One kind of event, or a whole group such as "All shares", or Everything |
| From and To | Only events between these days |
| Show | Applies the filter |
| Clear | Removes it |
Click a person's name in the list to see only their events. Click what an event was about to see only events about that one thing; Show all goes back. A filtered view is a link you can keep. Older events shows the next page.
Download CSV
Download CSV saves the events of the current filter as a spreadsheet file, at most 50,000 at a time; pick dates for more. Each download is itself recorded in the Audit Log, and a Workspace can download it at most ten times an hour.