What Fathom adds to Halo
Fathom is an ingest-only integration:| Mode | What it does |
|---|---|
| Ingest | Sync meeting transcripts, summaries, action items, and attendee insights from Fathom. Transcripts are matched to known customers and become searchable knowledge. |
Setup
Connecting
Fathom uses API key auth:- In Fathom, generate an API key (Settings > Developers).
- In Halo, click Connect Fathom.
- Paste the key and submit.
GET /meetings?limit=1 endpoint, encrypts and stores it, and automatically creates a Fathom webhook pointing at your org’s webhook URL.
Webhook
Webhook URL (auto-registered):{appUrl}/api/integrations/fathom/webhook/{orgId}
The webhook is configured to send transcript, summary, and action items in the payload. Verification uses Svix-style headers (the secret may be in whsec_... format).
When a webhook arrives, Halo enqueues a fathom/meeting.received event for processing.
Disconnecting
Disconnecting removes the API key from Halo and attempts to delete the Fathom webhook.Ingest mode
When ingest is on, Halo syncs:| Data | Where it lands |
|---|---|
| Meetings | meetings table with provider: fathom, linked to customers via attendee email matching |
| Transcripts + summaries + action items | Indexed under fathom: |
| Distilled content | Optional summarization adds distilled:fathom: entries |
Customer matching
Halo matches Fathom attendees against yourend_users and companies by email. Matched meetings show up on the customer’s profile and feed the AI as customer-scoped context.
Sync behavior
- First connect: triggers an immediate
fathom/sync.requested(source: manual) for recent meetings - Cron: hourly background sync (
cronSync: true) - Webhook: real-time on meeting completion
- Manual sync: button on the integration detail page
Knowledge contributions
Like Zoom, Fathom transcripts are distillable. Use Learning Rules to focus distillation on what matters to your team:- Customer feedback
- Action items
- Product asks
- Renewal signals
Where to go next
Zoom
Alternative meeting recorder with the same behavior.
Learning Rules
Filter what gets learned from transcripts.