Description

n8n-nodes-hedy


This is an n8n community node that lets you integrate Hedy – your AI-powered meeting intelligence assistant – into your n8n workflows.

Hedy helps you be the brightest person in the room by providing real-time transcription, meeting summaries, action items, and intelligent insights from your meetings.

n8n is a fair-code licensed workflow automation platform.

🚀 Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes
2. Search for n8n-nodes-hedy
3. Click Install

Manual Installation

Navigate to your n8n custom nodes folder
cd ~/.n8n/custom
Install the package
npm install n8n-nodes-hedy

Docker Installation

Add the following to your docker-compose.yml:

n8n:
  image: n8nio/n8n
  environment:
    - N8NCUSTOMEXTENSIONS=n8n-nodes-hedy

🔑 Authentication

1. Get your API key from Hedy Dashboard:
– Navigate to Settings → API
– Click “Generate New Key”
– Copy the key (starts with hedylive)

2. In n8n:
– Go to Credentials
– Create new “Hedy” credential
– Paste your API key
– Select your Region (US or EU) if your account uses EU data residency
– Click “Save”

📦 Nodes Included

Hedy Trigger

Receives real-time webhook notifications when events occur in Hedy:

• Session Created – When a new meeting session starts
• Session Ended – When a meeting session completes
• Session Exported – When a user manually exports a session
• Highlight Created – When a highlight is created during a meeting
• Todo Exported – When a todo item is exported

Hedy

Performs actions and retrieves data from Hedy:

• Sessions

– Get Session – Retrieve detailed session information
– Get Many Sessions – List multiple sessions with pagination

• Highlights

– Get Highlight – Retrieve specific highlight details
– Get Many Highlights – List multiple highlights
– Get by Session – Get all highlights for a specific session

• Todos

– Get Todo – Retrieve a specific todo by ID
– Get Many Todos – List all todo items
– Get Todos by Session – Get todos for a specific session

• Topics

– Create Topic – Create a new topic
– Get Topic – Retrieve a specific topic
– Get Many Topics – List all topics
– Get Topic Sessions – Get sessions for a topic
– Update Topic – Modify a topic
– Delete Topic – Remove a topic

• Contexts

– Create, Get, Get Many, Update, Delete session contexts

🎯 Example Workflows

1. Meeting Summary to Slack

Send meeting summaries to Slack when sessions end:

[Hedy Trigger: Session Ended]
    → [Hedy: Get Session Details]
    → [Slack: Send Message]

2. Highlight Collection to Notion

Save important highlights to a Notion database:

[Hedy Trigger: Highlight Created]
    → [Hedy: Get Highlight Details]
    → [Notion: Create Database Entry]

3. Todo Export to Project Management

Export todos to your project management tool:

[Hedy Trigger: Todo Exported]
    → [Jira/Trello/Asana: Create Task]

4. Daily Meeting Report

Generate daily meeting reports:

[Schedule Trigger: Daily at 5 PM]
    → [Hedy: Get Many Sessions (today)]
    → [Transform: Format Report]
    → [Email: Send Report]

📊 Data Structures

Session Object

{
  "sessionId": "sess_abc123",
  "title": "Team Standup",
  "startTime": "2024-01-10T10:00:00Z",
  "endTime": "2024-01-10T10:30:00Z",
  "duration": 1800,
  "session_type": "meeting",
  "transcript": "Full transcript...",
  "cleaned_transcript": "AI-cleaned transcript...",
  "cleaned_at": "2024-01-10T11:00:00Z",
  "conversations": [...],
  "meeting_minutes": "Meeting notes...",
  "recap": "Summary...",
  "session_notes": "[{"insert":"Key takeaway\n"}]",
  "user_todos": [...],
  "highlights": [...],
  "topic": {...}
}

> Note: cleanedtranscript and cleanedat are null when the transcript has not yet been cleaned. session_notes contains rich text in Parchment JSON (Delta) format.

Highlight Object

{
  "highlightId": "high_xyz789",
  "sessionId": "sess_abc123",
  "timestamp": "2024-01-10T10:15:00Z",
  "timeIndex": 900000,
  "title": "Key Decision",
  "rawQuote": "Original quote...",
  "cleanedQuote": "Cleaned quote...",
  "mainIdea": "Core concept...",
  "aiInsight": "Analysis..."
}

> Note: The list endpoint (Get Many) returns summary fields only (highlightId, sessionId, timestamp, title). The detail endpoint (Get) returns all fields.

Todo Object

{
  "id": "todo_123",
  "sessionId": "sess_abc123",
  "text": "Follow up with marketing team",
  "dueDate": "2024-01-15",
  "completed": false,
  "topic": {...}
}

⚙️ Configuration

Webhook Limits

• Maximum of 50 webhooks per Hedy account
• Webhooks must use HTTPS URLs
• Each webhook receives a unique signing secret for security

Pagination

• Default page size: 50 items
• Maximum page size: 100 items
• Supports cursor-based pagination for large datasets

Rate Limiting

The API follows standard rate limiting practices. If you encounter rate limit errors, implement exponential backoff in your workflows.

🔒 Security

Webhook Signature Verification

All webhooks include an X-Hedy-Signature header for verification:

1. The signature is an HMAC SHA-256 hash of the request body
2. Each webhook has a unique signing secret
3. Signature verification is disabled by default (enable in Options when signing secrets are available)

API Key Security

• Never share your API key publicly
• Rotate keys regularly (every 90 days recommended)
• Use n8n’s built-in credential encryption
• Keys can be revoked instantly from the Hedy dashboard

🐛 Troubleshooting

Common Issues

Webhook Registration Fails

• Ensure your n8n instance uses HTTPS
• Check you haven’t exceeded the 50 webhook limit
• Verify your API key has the necessary permissions

No Data Returned

• Verify the resource ID exists
• Check your API key is valid
• Ensure you have access to the requested resource

Signature Verification Fails

• Don’t modify webhook payloads
• Ensure signature verification is using the correct secret
• Check for clock skew between servers

📚 Resources

• Hedy Website
• Hedy API Documentation
• n8n Documentation
• n8n Community Forum

💬 Support

• Hedy Support: support@hedy.bot
• API Issues: api@hedy.bot
• n8n Node Issues: GitHub Issues

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

🙏 Acknowledgments

• Thanks to the n8n team for their excellent workflow automation platform
• Thanks to the Hedy team for providing comprehensive API documentation
• Thanks to all contributors and users of this node

📈 Version History

See CHANGELOG.md for a list of changes in each version.

—

Made with ❤️ by the Hedy team