Apps
Your team wants a CRM that already knows your customers and conversations. Instead of wiring one up yourself, you enable it from the App Marketplace: it's charged from your credits, gets its own address, and your team signs in with their Studio account.
This page is for admins enabling apps, and for anyone opening one. By the end you'll know how to enable an app, how it's billed (including the files it stores), who can open it, and how to cancel it.
What an app is
An app is a separate product built on Perfox. You enable it for your workspace, it gets its own web address, and it works with your workspace's data through the Perfox API. The first app is a CRM.
The App Marketplace page
Click App Marketplace in the Build section of the sidebar (/apps). Every member can see it.
- All / Enabled (N) switches between every app and the ones you've enabled.
- Search apps… matches an app's name, tagline and categories.
Each card shows the app's name, its status, a tagline, its starting price ("from … / month" or "/ year"), its address once enabled, and a button for where it stands:
| Status | Badge | Extra button |
|---|---|---|
| Not enabled | — | View & enable |
| Being set up | Setting up | "Setting up…" |
| Set-up failed | Set-up failed | See what went wrong |
| Running | Active | Open ↗ |
| Renewal unpaid | Lapsed | Open ↗, Buy credits |
| Cancelled, running to period end | Cancelling | Open ↗, Keep app |
| Your workspace is suspended | Suspended | — |
Admins also see Manage on every app they've enabled. Members who aren't admins only ever see Open ↗, and only for apps their role lets them open.
The top bar also has an apps launcher: Your apps lists the apps you've enabled, with Browse apps →.
Enable an app
Only admins can enable, pay for, or cancel an app.
- Click View & enable on a card. The app page shows what it does, What it uses from your workspace, and its Plans, priced in credits per month or per year. AI usage inside the app is billed from your credits as normal, on top of the plan.
- Click Enable app name.
- Pick a plan. The dialog works out the charge:
- Charged now: the plan price and the period it covers.
- Balance after: your credits after the charge, or how much you're short.
- Renews: the date, automatically from credits.
- Stored files: the storage rate, in credits per GB a month, charged daily (see Files an app stores).
- Click Enable and charge. If you're short, the button is Buy credits instead.
Set-up usually takes under a minute. The page shows the steps (Credits charged, Access key created, Creating your app, Ready), and you can leave; you'll get a notification when it's done.
A period is charged once, and a charge never takes your balance below zero.
If set-up fails
The page shows Set-up failed with the app's error. Perfox retries automatically. Click Retry now to try straight away, or Cancel and refund. If set-up still fails after 7 days, the app is cancelled and the charge refunded.
Billing and renewal
At the end of each period the app renews automatically from your credits.
If you don't have enough credits, the app lapses. The app page shows "Renewal failed — not enough credits. App is read-only; it is removed after 90 days unpaid." with Buy credits. You're reminded at 30 and 60 days. Top up and the app resumes; leave it unpaid for 90 days and it's removed.
Once an app is enabled, its page has four tabs:
| Tab | Shows |
|---|---|
| Overview | Status, plan, price, and when it renews (or ends, or ended), plus the app's access key, which the app manages for you. |
| Access | Who can open it, and who has opened it and when. |
| Billing | Every charge, each linked to its transaction. |
| Activity | What happened to the subscription, and who did it. |
If your workspace is suspended, its apps are suspended too.
Files an app stores
An app can keep files in your workspace: documents, attachments, exports. Your workspace pays for what it stores, separately from the plan. The app's page states the price, both in the Plans box and once the app is enabled: "Files the app stores are billed at rate credits per GB a month, charged daily."
On the Overview tab, the Storage card shows:
- how much the app stores, and in how many files, for example "1.2 GB · 340 files";
- what that costs: "About x credits a month at this size." (or "Under 0.01 credits a month at this size.");
- "App has not stored any files in this workspace yet." if there is nothing yet.
Only files the app has finished uploading are billed, once a day, with each day charged as 1/30 of a month. Admins also see View storage charges, which opens your transactions filtered to that app's storage charges.
When a customer's data is erased, any files an app stored for that customer are erased too. If you build on the API, see App Files.
Open an app
Click Open ↗. You're signed in to the app with your Studio account, with no separate password. The sign-in link is single-use and expires after 60 seconds. Admins open the app as app admins; everyone else opens it as an operator.
You can open an app while it's Active, Lapsed (read-only), or Cancelling. If you use two-step verification and haven't entered your code in this session yet, you're sent back to sign in first. Opening is limited to 30 times a minute per person.
If you can't open it, you're brought back to the app page with a reason:
- "You don't have access to this app. Ask a workspace admin to add “Use” for it to your role."
- "This app is not active for your workspace right now."
Who gets access
Admins can always open an app. To let others in, add the app's permission to their role on Roles, under the Apps group: Use the CRM app, or Administer the CRM app. The app's Access tab has Edit in Roles → as a shortcut.
When you remove someone's access on Roles, they're also signed out of any app they had opened.
Cancel an app
On the app's Overview tab, click Cancel app name. It stays active until the end of the paid period, and the tab reads "Cancelled — stays active until date."
Changed your mind? Click Keep app name before that date. Once the period ends the app is cancelled; enabling it again later starts a new paid period.
What happens to its files
The cancel box tells you up front: "Files it stored are kept for 30 days after it ends, then deleted." Once the app has ended, its page shows how much is being kept and until when: "size in N files that app stored are kept until date, then deleted for good." Admins also see "Enable app again before then to keep them." After that date the page reads "The files app stored were deleted on date."
Where to go next
- Accounts & Billing: buying credits and your transactions.
- Roles: who can open each app.
- Agent Marketplace: ready-made agents for your workspace.