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  capabilities: {
16    provides: [
17      { key: 'meeting-recorder.meetings.read', version: '1.0.0' },
18      { key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
19      { key: 'meeting-recorder.webhooks', version: '1.0.0' },
20    ],
21  },
22  configSchema: {
23    schema: {
24      type: 'object',
25      properties: {
26        baseUrl: {
27          type: 'string',
28          description:
29            'Optional override for the Fathom API base URL. Defaults to https://api.fathom.ai/external/v1.',
30        },
31        webhookUrl: {
32          type: 'string',
33          description:
34            'Webhook destination URL used when registering Fathom webhooks.',
35        },
36        includeTranscript: {
37          type: 'boolean',
38          description: 'Include transcript data in Fathom webhook payloads.',
39        },
40        includeSummary: {
41          type: 'boolean',
42          description: 'Include summary data in Fathom webhook payloads.',
43        },
44        includeActionItems: {
45          type: 'boolean',
46          description: 'Include action items in Fathom webhook payloads.',
47        },
48        includeCrmMatches: {
49          type: 'boolean',
50          description: 'Include CRM matches in Fathom webhook payloads.',
51        },
52        triggeredFor: {
53          type: 'array',
54          items: { type: 'string' },
55          description:
56            'Recording scopes to trigger webhooks for (e.g., my_recordings).',
57        },
58      },
59    },
60    example: {
61      baseUrl: 'https://api.fathom.ai/external/v1',
62      webhookUrl: 'https://example.com/webhooks/fathom',
63      includeTranscript: true,
64      includeSummary: true,
65      includeActionItems: false,
66      includeCrmMatches: false,
67      triggeredFor: ['my_recordings'],
68    },
69  },
70  secretSchema: {
71    schema: {
72      type: 'object',
73      required: ['apiKey'],
74      properties: {
75        apiKey: {
76          type: 'string',
77          description: 'Fathom API key used in the X-Api-Key header.',
78        },
79        webhookSecret: {
80          type: 'string',
81          description:
82            'Optional webhook secret used to verify Fathom webhook signatures.',
83        },
84      },
85    },
86    example: {
87      apiKey: 'fathom-***',
88      webhookSecret: 'whsec_***',
89    },
90  },
91  healthCheck: {
92    method: 'list',
93    timeoutMs: 8000,
94  },
95  docsUrl: 'https://developers.fathom.ai/',
96  constraints: {
97    rateLimit: {
98      rpm: 60,
99    },
100  },
101  byokSetup: {
102    setupInstructions:
103      'Generate an API key in Fathom settings and optionally configure webhooks for meeting content readiness.',
104  },
105});