Skip to content

integrations.mdx

Latest commit

 

History

History
434 lines (331 loc) · 12.8 KB

integrations.mdx

File metadata and controls

434 lines (331 loc) · 12.8 KB
title Integrations
description Connect Hyperaide with your favorite apps and services

Integrations are what make Hyperaide truly powerful. Connect your assistant to the tools you already use—task managers, calendars, communication platforms, and more—to create a unified productivity hub.

What are Integrations?

Integrations allow Hyperaide to interact with external services on your behalf. Your assistant can:

  • Read data from connected services (tasks, events, issues, etc.)
  • Create and update items across platforms
  • Sync information between your services and Hyperaide databases
  • Automate workflows that span multiple tools
Once connected, your assistant can manage these services using natural language, just like it manages your Hyperaide databases.

Integration Types

**How you interact with your assistant** 
<CardGroup cols={2}>
  <Card title="WhatsApp" icon="whatsapp" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Fwhatsapp">
    Message your assistant on WhatsApp for instant mobile access
  </Card>
  
  <Card title="Telegram" icon="telegram" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Ftelegram">
    Connect via Telegram for cross-platform messaging
  </Card>
  
  <Card title="Email" icon="envelope" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Femail">
    Email your assistant for longer-form communication
  </Card>
  
  <Card title="Slack" icon="slack" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Fslack">
    Bring your assistant into your team's workspace (coming soon)
  </Card>
</CardGroup>
**Manage tasks across platforms** 
<CardGroup cols={2}>
  <Card title="Todoist" icon="check-square" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Ftodoist">
    Sync tasks with Todoist projects and labels
  </Card>
  
  <Card title="TickTick" icon="list-check" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Fticktick">
    Connect with TickTick for task management
  </Card>
  
  <Card title="Linear" icon="chart-network" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Flinear">
    Manage Linear issues and projects
  </Card>
</CardGroup>
**Connect your productivity tools** 
<CardGroup cols={2}>
  <Card title="Google Calendar" icon="calendar" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Fgoogle-calendar">
    Manage events and check your schedule
  </Card>
  
  <Card title="Notion" icon="book" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Fnotion">
    Sync with Notion databases and pages
  </Card>
  
  <Card title="GitHub" icon="github" href="proxy.php?url=https%3A%2F%2Fgithub.com%2Fintegrations%2Fgithub">
    Track issues, PRs, and repository activity
  </Card>
</CardGroup>

How Integrations Work

Authorize Hyperaide to access your external service with OAuth Select which projects, calendars, or spaces to make available Your assistant can now access and manage data from that service Create Future Actions that work across multiple integrations

Why Use Integrations?

Manage all your tools from one place—talk to your assistant instead of switching between apps. 
*"Show me all my tasks from Todoist and Linear"*  
*"What's on my Google Calendar tomorrow?"*  
*"Create a GitHub issue for this bug I found"*
Create automations that span multiple services: 
*"When I complete a task in Todoist, add a note to my daily journal"*  
*"Every morning, show me today's calendar and top 3 Linear issues"*  
*"If a GitHub issue is assigned to me, create a task in my Hyperaide database"*
No need to learn each app's interface or shortcuts. Use natural language: 
*"Move all my overdue Todoist tasks to next Monday"*  
*"Block 2 hours on my calendar tomorrow for deep work"*  
*"What Notion pages did I update this week?"*
Your assistant understands context across all services: 
*"What's the status of the website redesign project?"* (pulls from Linear, Notion, and your databases)  
*"Show me everything related to client XYZ"* (finds tasks, calendar events, and notes)

Setting Up Integrations

### Connect via Web Interface 
<Steps>
  <Step title="Navigate to Integrations">
    Go to **Settings → Integrations** in the web app
  </Step>
  
  <Step title="Choose Integration">
    Select the service you want to connect
  </Step>
  
  <Step title="Authorize Access">
    Log in and authorize Hyperaide to access your account
  </Step>
  
  <Step title="Configure Settings">
    Choose what data to sync and set preferences
  </Step>
  
  <Step title="Start Using">
    Your assistant can now interact with that service!
  </Step>
</Steps>
### Connect via Natural Language 
Some integrations can be set up by asking your assistant:

```text
"Connect my Todoist account"
"I want to integrate Google Calendar"
"Help me set up WhatsApp"
```

Your assistant will guide you through the connection process.

Popular Integration Workflows

**Unified Task Management** 
```text
Setup:
- Connect Todoist and Linear
- Create a "Work Tasks" database in Hyperaide

Daily workflow:
"Show me all my tasks from Todoist and Linear"
"Create a task in Todoist: Review Q1 budget"
"What Linear issues are assigned to me?"
"Mark all completed tasks as done across all platforms"
```

Your assistant manages tasks across all platforms seamlessly.
**Time-Aware Task Management** 
```text
Setup:
- Connect Google Calendar and Todoist
- Set up daily Future Actions

Automated workflow:
Every morning: "Show me today's calendar and top 5 tasks"
When scheduling: "Find a 2-hour block this week for the design task"
Before meetings: "Prepare me for my 3pm meeting"
End of day: "What did I accomplish and what's left?"
```

Your assistant coordinates your time and tasks intelligently.
**Centralized Project Management** 
```text
Setup:
- Connect Linear, GitHub, Notion, and Slack
- Create a Projects database in Hyperaide

Project workflow:
"What's the status of the mobile app project?"
  → Checks Linear issues, GitHub PRs, Notion docs

"Update the team on yesterday's progress"
  → Summarizes activity and posts to Slack

"Show me all open GitHub issues for the API"
  → Filters and displays relevant issues
```

Your assistant becomes your project command center.
**Universal Information Capture** 
```text
Setup:
- Connect Notion, Email, and WhatsApp
- Create Notes and Ideas databases

Capture workflow:
Via WhatsApp: "Note: great design inspiration at acme.co"
Via Email: Forward newsletter → "Save key insights to Notion"
Via Web: "Create a Notion page with my project ideas"

Query: "Find all my notes about design from the last month"
  → Searches across all sources
```

Capture anywhere, access everywhere.

Integration Permissions

Integrations require access to your external accounts. Hyperaide only requests the minimum permissions needed to function and never accesses data you don't explicitly authorize.

What Hyperaide Can Access

- View tasks, events, issues, or pages you select - Read metadata (names, dates, status, etc.) - Access data only from projects/spaces you authorize - Create new items (tasks, events, notes) - Update existing items (status, descriptions, dates) - Only when you explicitly ask the assistant to do so - Access data from unauthorized projects/spaces - Make changes without your instruction - Share your data with third parties - Delete items (unless you explicitly request it)

Managing Integrations

See all active integrations in **Settings → Integrations**: 
- Connection status (active, expired, error)
- Last sync time
- Permissions granted
- Data being accessed
If an integration stops working: 
1. Go to the integration settings
2. Click **Reconnect**
3. Re-authorize access
4. Your assistant resumes access
To remove an integration: 
1. Go to integration settings
2. Click **Disconnect**
3. Confirm removal
4. Hyperaide immediately loses access

<Info>
  Your Hyperaide databases are unaffected—only the connection to the external service is removed.
</Info>
Adjust integration settings: 
- Change which projects/calendars to sync
- Update sync frequency
- Modify notification preferences
- Set up custom mapping rules

Troubleshooting

**Possible solutions:** - Check connection status in Settings - Try reconnecting the integration - Verify you still have access to the external service - Check if the service is experiencing downtime **Possible solutions:** - Wait a few moments (sync can take 30-60 seconds) - Manually trigger a sync in integration settings - Check that you authorized the correct account - Verify the data exists in the external service **Solution:** Many services require periodic re-authorization for security: 
1. You'll see an "Expired" status in Settings
2. Click **Reconnect** and re-authorize
3. Your integration resumes working immediately
**Solution:** If your assistant can't perform an action: 
1. Check what permissions were granted
2. Disconnect and reconnect with fuller permissions
3. Ensure you have access in the external service

Best Practices

Connect one integration at a time and learn how it works before adding more. Only sync the projects/calendars you actively use with Hyperaide to reduce noise. Review what access each integration has and adjust as needed. Experiment with commands before creating automations to ensure they work as expected. Occasionally check that integrations are syncing properly. If an integration updates its API, you may need to reconnect.

Coming Soon

Team workspace integration for collaborative assistant features Email management and smart inbox features Project and task management for teams Visual project management with boards and cards Software development project tracking API access for building your own integrations **Want an integration we don't have yet?** Let us know at [[email protected]](mailto:[email protected]). We prioritize integrations based on user demand.