1export const fathomIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'meeting-recorder.fathom',
4		version: '1.0.0',
5		category: 'meeting-recorder',
6		title: 'Fathom Meeting Recorder',
7		description:
8			'Fathom External API for meetings, transcripts, and webhook events.',
9		domain: 'productivity',
10		owners: ['platform.integrations'],
11		tags: ['meeting-recorder', 'fathom', 'transcripts'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [
16		{ type: 'rest' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-fathom-signature',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24	],
25	preferredTransport: 'rest',
26	supportedAuthMethods: [
27		{ type: 'api-key' },
28		{
29			type: 'webhook-signing',
30			algorithm: 'hmac-sha256',
31			signatureHeader: 'x-fathom-signature',
32		},
33	],
34	capabilities: {
35		provides: [
36			{ key: 'meeting-recorder.meetings.read', version: '1.0.0' },
37			{ key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
38			{ key: 'meeting-recorder.webhooks', version: '1.0.0' },
39		],
40	},
41	configSchema: {
42		schema: {
43			type: 'object',
44			properties: {
45				baseUrl: {
46					type: 'string',
47					description:
48						'Optional override for the Fathom API base URL. Defaults to https://api.fathom.ai/external/v1.',
49				},
50				webhookUrl: {
51					type: 'string',
52					description:
53						'Webhook destination URL used when registering Fathom webhooks.',
54				},
55				includeTranscript: {
56					type: 'boolean',
57					description: 'Include transcript data in Fathom webhook payloads.',
58				},
59				includeSummary: {
60					type: 'boolean',
61					description: 'Include summary data in Fathom webhook payloads.',
62				},
63				includeActionItems: {
64					type: 'boolean',
65					description: 'Include action items in Fathom webhook payloads.',
66				},
67				includeCrmMatches: {
68					type: 'boolean',
69					description: 'Include CRM matches in Fathom webhook payloads.',
70				},
71				triggeredFor: {
72					type: 'array',
73					items: { type: 'string' },
74					description:
75						'Recording scopes to trigger webhooks for (e.g., my_recordings).',
76				},
77			},
78		},
79		example: {
80			baseUrl: 'https://api.fathom.ai/external/v1',
81			webhookUrl: 'https://example.com/webhooks/fathom',
82			includeTranscript: true,
83			includeSummary: true,
84			includeActionItems: false,
85			includeCrmMatches: false,
86			triggeredFor: ['my_recordings'],
87		},
88	},
89	secretSchema: {
90		schema: {
91			type: 'object',
92			required: ['apiKey'],
93			properties: {
94				apiKey: {
95					type: 'string',
96					description: 'Fathom API key used in the X-Api-Key header.',
97				},
98				webhookSecret: {
99					type: 'string',
100					description:
101						'Optional webhook secret used to verify Fathom webhook signatures.',
102				},
103			},
104		},
105		example: {
106			apiKey: 'fathom-***',
107			webhookSecret: 'whsec_***',
108		},
109	},
110	healthCheck: {
111		method: 'list',
112		timeoutMs: 8000,
113	},
114	docsUrl: 'https://developers.fathom.ai/',
115	constraints: {
116		rateLimit: {
117			rpm: 60,
118		},
119	},
120	byokSetup: {
121		setupInstructions:
122			'Generate an API key in Fathom settings and optionally configure webhooks for meeting content readiness.',
123		keyRotationSupported: false,
124		quotaTrackingSupported: false,
125	},
126});