Skip to content

The open alternative to Salesforce, designed for AI.

Make the Fathom app publishable and rewrite its listing copy (#25325)

nitinb1be0714023f
diff --git a/packages/twenty-apps/public/fathom/CHANGELOG.md b/packages/twenty-apps/public/fathom/CHANGELOG.md
index c039d5ddc96..6c7064fd2a7 100644
--- a/packages/twenty-apps/public/fathom/CHANGELOG.md
+++ b/packages/twenty-apps/public/fathom/CHANGELOG.md
@@ -2,7 +2,7 @@
All notable changes to this application are documented in this file.
-## Unreleased
+## 1.0.0
- Import available Fathom video, or audio for audio-only recordings, into the
Call Recording's media fields when it is within the 500 MB limit.
diff --git a/packages/twenty-apps/public/fathom/README.md b/packages/twenty-apps/public/fathom/README.md
index e986f342d1c..4ee51d8b328 100644
--- a/packages/twenty-apps/public/fathom/README.md
+++ b/packages/twenty-apps/public/fathom/README.md
@@ -1,52 +1,29 @@
# Fathom
-**Bring Fathom meeting recordings, transcripts, and insights into Twenty.**
+**Every Fathom recording, transcript, and summary, right inside your CRM.**
-## What you get
+## ✨ What you get
-- Fathom recordings saved as Call Recordings
-- Transcripts, summaries, and action items
-- Recording video, or audio for audio-only calls
-- Links to matching calendar events when the match is unambiguous
-- Automatic sync for new recordings
-- A 31-day import when a Fathom account is connected, and manual imports of
- older history
-- Workflow and AI actions to sync one recording or list recordings by
- participant
+- **Fathom transcripts, summaries, and action items saved when available**
+- **Recording video, or audio for audio-only calls, on the same record**
+- **Saved to a Call Recording, with calendar links for clear matches**
+- **New meetings synced as they happen**
+- **Your last 31 days imported the moment you connect**
+- **Built for AI & automation**
-## Requirements
+## πŸ’³ Billing
-Each person connects their Fathom account to Twenty. The connected Fathom
-account decides which recordings Twenty can import; the Fathom and Twenty login
-emails do not need to match.
+**Free to run**: no per-seat, per-recording or per-import charge. AI actions use
+AI credits on the model's token usage.
-## Heads up
+## πŸ“Œ Heads up
-- Twenty only links a recording to a calendar event when its meeting URL and
- scheduled time identify one clear match.
-- Fathom generates the downloadable video in the background, so a recording
- stays in Processing for a few minutes after its transcript arrives, until its
- media lands or is settled as unavailable.
-- A daily reconciliation pass scans local Call Recordings started in the last
- seven days and resumes media imports inactive for at least 30 minutes.
-- Media imports respect Fathom's Retry-After delay for up to three retries.
- Continued throttling leaves the import unfinished for the daily recovery
- pass; recordings outside its seven-day window need Sync Fathom Call.
-- Media is skipped for recordings above 500 MB, for recordings Fathom has no
- downloadable media for, and for limited-access shares that the connected
- account may view but not download. Fathom records the reason internally so
- automatic syncs do not retry a settled failure.
-- Once a reason is recorded, automatic syncs stop asking Fathom to generate the
- same file again. Running Sync Fathom Call on that recording clears the reason
- and tries once more, which is how a re-shared recording gets its media.
-- Disconnect and reconnect Fathom after changing the webhook URL or webhook
- scopes so Fathom receives the new registration.
-
-Development setup lives in [SETUP.md](SETUP.md).
-
-## Reliability limits
-
-Import pacing is best-effort: concurrent jobs can reserve overlapping slots.
-After Fathom creates a download, Twenty retries saving its ID up to three total
-attempts. A crash or failed save can still cause a later retry to request another
-download generation; provider creation and local persistence are not atomic.
+- **Everything you import is shared with your workspace.** Transcripts,
+ summaries, and media land on Call Recording records that every member with
+ access can read. Private syncing is coming later.
+- **Media arrives after the transcript, and not always.** A recording stays in
+ Processing while Fathom prepares the download. Anything over 500 MB, and
+ view-only shares, never get media.
+- **Calendar links need one clear match.** A Call Recording is linked to a
+ calendar event only when its meeting link and scheduled time point to exactly
+ one event.
diff --git a/packages/twenty-apps/public/fathom/SETUP.md b/packages/twenty-apps/public/fathom/SETUP.md
index 726f9858512..1f1304b365a 100644
--- a/packages/twenty-apps/public/fathom/SETUP.md
+++ b/packages/twenty-apps/public/fathom/SETUP.md
@@ -64,6 +64,30 @@ to the workspace that made the connection, so no per-workspace domain is needed.
The import runs through the requesting user's Fathom connection.
+## Media import behaviour
+
+Fathom prepares the downloadable file after the transcript is ready, so a Call
+Recording stays in Processing until its media lands or is settled as
+unavailable.
+
+- A daily reconciliation pass scans local Call Recordings started in the last
+ seven days and resumes media imports inactive for at least 30 minutes.
+- Media imports respect Fathom's `Retry-After` delay for up to three retries.
+ Continued throttling leaves the import unfinished for the daily recovery
+ pass; recordings outside its seven-day window need Sync Fathom Call.
+- Media is skipped for recordings above 500 MB, for recordings Fathom has no
+ downloadable media for, and for limited-access shares the connected account
+ may view but not download. The reason is recorded on the Fathom recording
+ import so automatic syncs do not retry a settled failure.
+- Running Sync Fathom Call clears a recorded reason and tries once more, which
+ is how a re-shared recording gets its media.
+
+Import pacing is best-effort: concurrent jobs can reserve overlapping slots.
+After Fathom creates a download, Twenty retries saving its ID up to three total
+attempts. A crash or failed save can still cause a later retry to request
+another download generation; provider creation and local persistence are not
+atomic.
+
## Verifying your setup
- `yarn lint` - Lint the project with oxlint
@@ -73,4 +97,7 @@ to the workspace that made the connection, so no per-workspace domain is needed.
## Troubleshooting
+Disconnect and reconnect Fathom after changing the webhook URL or the webhook
+scopes, so Fathom receives the new registration.
+
See the [troubleshooting guide](https://docs.twenty.com/developers/extend/apps/getting-started/troubleshooting) or ask on [Discord](https://discord.gg/cx5n4Jzs57).
diff --git a/packages/twenty-apps/public/fathom/package.json b/packages/twenty-apps/public/fathom/package.json
index 6a29fcee533..2e814cb3d59 100644
--- a/packages/twenty-apps/public/fathom/package.json
+++ b/packages/twenty-apps/public/fathom/package.json
@@ -1,6 +1,7 @@
{
"name": "@twentyhq/fathom",
- "version": "0.1.0",
+ "description": "Fathom connector for Twenty: syncs meeting recordings, transcripts, summaries and action items into Call Recordings.",
+ "version": "1.0.0",
"license": "MIT",
"engines": {
"node": "^24.5.0",
@@ -8,7 +9,9 @@
"twenty": ">=2.38.0",
"yarn": ">=4.0.2"
},
- "keywords": [],
+ "keywords": [
+ "twenty-app"
+ ],
"packageManager": "[email protected]",
"scripts": {
"twenty": "twenty",
diff --git a/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx b/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx
index 8bcfeb74995..21339b167fe 100644
--- a/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx
+++ b/packages/twenty-docs/user-guide/billing/capabilities/credits.mdx
@@ -27,7 +27,7 @@ For most teams, standard automations are effectively free β€” you'll only make a
</Note>
<Note>
-Not every app charges for its runs. Call Recorder and Last Contact react to every email and calendar event imported into your workspace, and Slack runs on every Slack event its bot subscribes to, so their logic function runs are free. You are still charged for the metered work they do, such as recorded call minutes or the AI credits behind Slack assistant answers.
+Not every app charges for its runs. Call Recorder, Last Contact and Fathom react to every email, calendar event and recording imported into your workspace, and Slack runs on every Slack event its bot subscribes to, so their logic function runs are free. You are still charged for the metered work they do, such as recorded call minutes or the AI credits behind Slack assistant answers.
</Note>
## How logic function runs are metered
diff --git a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-billing-exempt-applications.constant.ts b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-billing-exempt-applications.constant.ts
index 1f163e18935..232a3f0fa1a 100644
--- a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-billing-exempt-applications.constant.ts
+++ b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-billing-exempt-applications.constant.ts
@@ -1,11 +1,10 @@
-// First-party apps whose logic-function executions do not consume the
-// workspace's credits. Call Recorder and Last contact react to per-record
-// events during mailbox/calendar import, and Slack runs on every subscribed
-// Slack event including messages it never answers; either would otherwise
-// drain the free-tier allowance. Explicit chargeCredits calls and AI token
-// usage from within a function are billed separately.
+import { TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS } from 'src/engine/core-modules/application/application-marketplace/constants/twenty-public-app-universal-identifiers.constant';
+
+// These apps run on every imported record or subscribed event, so metering
+// each invocation would drain the free-tier allowance.
export const MARKETPLACE_BILLING_EXEMPT_UNIVERSAL_IDENTIFIERS: string[] = [
- '8da4b8b5-5edf-4880-b51f-ab6e679ec617',
- '66a504cc-0a75-410e-a43f-cdeae1db1522',
- 'a8c47f21-3b9e-4d2a-8f61-9c0e7d4a2b51',
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.CALL_RECORDER,
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.LAST_CONTACT,
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.SLACK,
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.FATHOM,
];
diff --git a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-vetted-applications.constant.ts b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-vetted-applications.constant.ts
index 0c3d9cfc1dd..915c0adf3e2 100644
--- a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-vetted-applications.constant.ts
+++ b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/marketplace-vetted-applications.constant.ts
@@ -1,25 +1,28 @@
+import { TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS } from 'src/engine/core-modules/application/application-marketplace/constants/twenty-public-app-universal-identifiers.constant';
+
export const MARKETPLACE_VETTED_APPLICATIONS: {
universalIdentifier: string;
position?: number;
}[] = [
{
- universalIdentifier: '8da4b8b5-5edf-4880-b51f-ab6e679ec617',
+ universalIdentifier: TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.CALL_RECORDER,
position: 1,
},
{
- universalIdentifier: '4a1178c1-3535-4a47-b592-231d3216b36f',
+ universalIdentifier:
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.PEOPLE_DATA_LABS,
position: 2,
},
{
- universalIdentifier: '66a504cc-0a75-410e-a43f-cdeae1db1522',
+ universalIdentifier: TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.LAST_CONTACT,
position: 3,
},
{
- universalIdentifier: '2b7f4a2e-9c4b-4a11-b63c-2e5e7d3f5a9a',
+ universalIdentifier: TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.EXA,
position: 4,
},
{
- universalIdentifier: 'a8c47f21-3b9e-4d2a-8f61-9c0e7d4a2b51',
+ universalIdentifier: TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.SLACK,
position: 5,
},
];
diff --git a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/twenty-public-app-universal-identifiers.constant.ts b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/twenty-public-app-universal-identifiers.constant.ts
new file mode 100644
index 00000000000..34a438c68e9
--- /dev/null
+++ b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/constants/twenty-public-app-universal-identifiers.constant.ts
@@ -0,0 +1,9 @@
+// Universal identifiers of the first-party apps in packages/twenty-apps/public.
+export const TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS = {
+ CALL_RECORDER: '8da4b8b5-5edf-4880-b51f-ab6e679ec617',
+ EXA: '2b7f4a2e-9c4b-4a11-b63c-2e5e7d3f5a9a',
+ FATHOM: 'c5fb24b3-15b0-48fb-a9b5-f182ba231e6c',
+ LAST_CONTACT: '66a504cc-0a75-410e-a43f-cdeae1db1522',
+ PEOPLE_DATA_LABS: '4a1178c1-3535-4a47-b592-231d3216b36f',
+ SLACK: 'a8c47f21-3b9e-4d2a-8f61-9c0e7d4a2b51',
+} as const;
diff --git a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/__tests__/is-billing-exempt-application.util.spec.ts b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/__tests__/is-billing-exempt-application.util.spec.ts
index 11b4505de48..140c8f72221 100644
--- a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/__tests__/is-billing-exempt-application.util.spec.ts
+++ b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/__tests__/is-billing-exempt-application.util.spec.ts
@@ -5,6 +5,7 @@ describe('isBillingExemptApplication', () => {
'8da4b8b5-5edf-4880-b51f-ab6e679ec617',
'66a504cc-0a75-410e-a43f-cdeae1db1522',
'a8c47f21-3b9e-4d2a-8f61-9c0e7d4a2b51',
+ 'c5fb24b3-15b0-48fb-a9b5-f182ba231e6c',
])('should return true for billing-exempt app %s', (universalIdentifier) => {
expect(isBillingExemptApplication(universalIdentifier)).toBe(true);
});
diff --git a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/is-billing-exempt-application.util.ts b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/is-billing-exempt-application.util.ts
index 4d91b901b07..aa414354551 100644
--- a/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/is-billing-exempt-application.util.ts
+++ b/packages/twenty-server/src/engine/core-modules/application/application-marketplace/utils/is-billing-exempt-application.util.ts
@@ -1,9 +1,6 @@
import { MARKETPLACE_BILLING_EXEMPT_UNIVERSAL_IDENTIFIERS } from 'src/engine/core-modules/application/application-marketplace/constants/marketplace-billing-exempt-applications.constant';
-// Logic-function executions for these first-party apps (Call Recorder,
-// Last contact, Slack) do not consume the workspace's credits. Explicit
-// chargeCredits calls and AI token usage from within the function are billed
-// separately.
+// Explicit chargeCredits calls and AI token usage are billed separately.
export const isBillingExemptApplication = (
universalIdentifier: string,
): boolean =>
diff --git a/packages/twenty-server/src/engine/core-modules/onboarding/constants/onboarding-installable-app-universal-identifiers.ts b/packages/twenty-server/src/engine/core-modules/onboarding/constants/onboarding-installable-app-universal-identifiers.ts
index ecaa42613c0..8f1466e4434 100644
--- a/packages/twenty-server/src/engine/core-modules/onboarding/constants/onboarding-installable-app-universal-identifiers.ts
+++ b/packages/twenty-server/src/engine/core-modules/onboarding/constants/onboarding-installable-app-universal-identifiers.ts
@@ -1,5 +1,7 @@
-export const ONBOARDING_INSTALLABLE_APP_UNIVERSAL_IDENTIFIERS = [
- '8da4b8b5-5edf-4880-b51f-ab6e679ec617',
- '4a1178c1-3535-4a47-b592-231d3216b36f',
- '66a504cc-0a75-410e-a43f-cdeae1db1522',
+import { TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS } from 'src/engine/core-modules/application/application-marketplace/constants/twenty-public-app-universal-identifiers.constant';
+
+export const ONBOARDING_INSTALLABLE_APP_UNIVERSAL_IDENTIFIERS: string[] = [
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.CALL_RECORDER,
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.PEOPLE_DATA_LABS,
+ TWENTY_PUBLIC_APP_UNIVERSAL_IDENTIFIERS.LAST_CONTACT,
];