Hedy AI Platform Help

Step 1 — Gather context

If references/learnings.md exists, read it first for accumulated platform knowledge.

1. What's your goal?

   • A) Set up Hedy for my team (onboarding, coaching prompts, session contexts)
   • B) Integrate Hedy with CRM or other tools (Zapier, n8n, API, webhooks)
   • C) Troubleshoot an issue (mic cutouts, sync problems, recording failures)
   • D) Evaluate Hedy vs alternatives (Fathom, Granola, Cluely, Krisp)

2. Which plan are you on?

   • A) Free — 5 hrs/mo, coaching limited to 30 min/session
   • B) Pro ($12.99/mo or $99.99/yr) — unlimited, API/webhooks/MCP
   • C) Lifetime ($299) — all Pro features, one-time payment
   • D) Not sure / evaluating

3. What devices do you use?

   • A) Mac + iPhone
   • B) Windows + Android
   • C) Cross-platform (multiple)
   • D) Apple Watch for in-person meetings

Skip-ahead rule: if the user's prompt already has enough context, skip to Step 2.

Step 2 — Route or answer directly

Problem domain	Route to
Reviewing a specific call for coaching or scoring	/sales-call-review {user's question}
Building a coaching program or training cadence	/sales-coaching {user's question}
General CRM-to-tool integration patterns (Zapier, webhooks, iPaaS)	/sales-integration {user's question}
Comparing note-taker platforms broadly	/sales-note-taker {user's question}

Otherwise, answer directly below.

Step 3 — Hedy platform reference

Read references/platform-guide.md for the full platform reference — modules, pricing, integrations, data model, workflows.

Answer the user's question using only the relevant section. Don't dump the full reference.

Step 4 — Actionable guidance

You no longer need the platform guide — focus on the user's specific situation.

Setup priorities:

1. Install on your primary device first — Mac or iPhone. Enable cloud sync immediately so sessions appear across devices.
2. Create session contexts for recurring meeting types (discovery calls, demos, 1:1s) — these shape the real-time coaching suggestions.
3. If integrating with CRM: Pro plan required → set up Zapier or n8n with session.ended webhook → map transcript/summary/todos to CRM fields.
4. For in-person meetings: pair Apple Watch for glanceable coaching. Phone records audio, Watch shows suggestions.

If you discover a gotcha, workaround, or tip not covered in references/learnings.md, append it there.

Gotchas

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.

• API/webhooks/MCP are all Pro-only. Free plan has zero programmatic access. No Zapier triggers work on Free either — webhooks power the Zapier integration.
• No native CRM connectors. Unlike Fathom/Fireflies/Gong, Hedy doesn't have a "connect to HubSpot" button. CRM sync requires Zapier, n8n, or custom API work.
• Real-time coaching is limited to 30 min/session on Free. After 30 minutes, transcription continues but coaching suggestions stop.
• Webhook limit is 10 per account. If you need multiple downstream destinations, fan out from a single webhook receiver rather than creating separate webhooks per destination.
• Intel Macs may crash. Hedy 3.x has known issues on older Intel-based Macs. Update to the latest version (3.0.7+) if experiencing freezing.
• Phone call recording can't capture both sides through headphones. Phone manufacturers block apps from listening to call audio via headphones — use speaker mode for phone call recording.
• Web app is view-only. Recording only works on native apps (Mac, Windows, iOS, Android). The web app is for reviewing transcripts and asking questions.
• Cloud sync must be enabled for webhooks. Without cloud sync, webhook events won't fire even on Pro.

Related skills

• /sales-note-taker — Comparing note-taker platforms, backend API integration patterns, webhook vs polling architecture
• /sales-fathom — Fathom platform help (budget alternative with native CRM sync)
• /sales-granola — Granola platform help (bot-free AI notepad, similar privacy focus)
• /sales-cluely — Cluely platform help (real-time AI coaching overlay, similar coaching concept)
• /sales-krisp — Krisp platform help (noise cancellation + AI notes, similar device-level approach)
• /sales-call-review — Review a specific call for coaching
• /sales-coaching — Build coaching programs that consume call data
• /sales-integration — General CRM/tool integration patterns (Zapier, webhooks, iPaaS)
• /sales-do — Not sure which skill to use? The router matches any sales objective to the right skill. Install: npx skills add sales-skills/sales --skill sales-do

Examples

Example 1: Setting up Hedy for a sales team

User says: "I want to use Hedy for my 4-person SDR team to get real-time coaching on discovery calls. We use HubSpot." Skill does: Recommends Pro plan ($12.99/seat/mo), walks through creating a "Discovery Call" session context with qualification framework prompts, sets up Zapier webhook (session.ended → HubSpot create note on contact), notes the 30-min coaching limit on Free makes it unsuitable for SDR teams.

Example 2: Building an n8n automation

User says: "I want meeting summaries and action items to automatically go to Slack and Notion after every call." Skill does: Uses the Hedy n8n node (n8n-nodes-hedy) with session.ended webhook trigger, maps summary and todos to Slack channel post, maps full transcript + action items to Notion database row, notes that cloud sync must be enabled and Pro plan is required.

Example 3: Choosing between Hedy and Granola

User says: "Should I use Hedy or Granola? I'm a VC taking partner meeting notes." Skill does: Compares: both are bot-free and privacy-focused. Granola is a notepad that enhances YOUR notes with transcript context — better for VCs who want to type alongside. Hedy is a coach that proactively suggests what to say — better for structured conversations. Granola has native HubSpot/Attio sync; Hedy needs Zapier. Recommends Granola for the notepad workflow, Hedy if the user wants real-time prompts during pitch evaluations.

Troubleshooting

iOS mic cuts out mid-meeting

Symptom: Recording stops partway through a meeting on iPhone, resulting in partial or lost transcript Cause: iOS background audio restrictions — other apps or system notifications can interrupt Hedy's mic access Solution: Enable "Always Allow" microphone permission in iOS Settings → Hedy. Disable Focus/DND if it restricts background audio. Keep Hedy in the foreground or enable background audio in Hedy settings. If the issue persists, update to the latest app version.

Mac app freezes on launch (Intel)

Symptom: System becomes unresponsive when launching Hedy on Intel-based Mac Cause: Known compatibility issue with Hedy 3.x on older Intel processors Solution: Update to Hedy 3.0.7 or later — the team released a targeted fix. If still frozen, force-quit (Cmd+Option+Esc), delete the app, reinstall the latest version from hedy.ai.

Cloud sync not working between devices

Symptom: Sessions recorded on iPhone don't appear on Mac (or vice versa) Cause: Cloud sync disabled or using different accounts on different devices Solution: Verify cloud sync is enabled in Settings on both devices. Confirm you're logged into the same Hedy account. Check internet connectivity. If sessions are stuck, force a sync by opening the app on both devices simultaneously.