Skip to main content

​
Integrations Overview

Wovly connects to your existing communication platforms to read, send, and manage messages across all your channels from a single interface.

​
Available Integrations

​
Communication Platforms

Google Workspace

Gmail & CalendarRead and send emails, manage calendar events, schedule meetings automatically.

Slack

Messages & ChannelsSend DMs, post to channels, search conversations.

iMessage

Native macOS TextingSend and read iMessages directly from Wovly.

Discord

Servers & DMsSend messages to channels and users.

Telegram

Bot MessagingSend messages and use as a chat interface.

WhatsApp

Remote ControlControl Wovly from your phone via WhatsApp.

​
Social & Content

X (Twitter)

Tweets & DMsPost tweets, send DMs, search content.

Reddit

Posts & CommentsCreate posts, comment, browse subreddits.

​
Productivity

Notion

Pages & DatabasesSearch and create content in Notion.

GitHub

Repos & IssuesManage repositories, issues, and pull requests.

Asana

Tasks & ProjectsCreate and manage tasks in Asana.

Spotify

Music ControlControl playback and browse music.

​
Utilities

Browser Automation

Web ResearchNavigate websites, fill forms, extract data.

Credentials

Secure LoginsStore website credentials for automated login.

​
Integration Status

Check your integration status in the Integrations page:
StatusMeaning
ConnectedIntegration is active and working
Needs ReauthToken expired, needs re-authorization
Not ConnectedIntegration not set up

​
How Integrations Work

​
Authentication Flow

Most integrations use OAuth 2.0:
  1. Click Connect on the integration
  2. Sign in to the service
  3. Authorize Wovly to access your account
  4. Token is stored locally

​
Data Flow

All data stays local. Wovly stores integration tokens in ~/.wovly-assistant/settings.json. API calls go directly from your machine to the service provider.
Your Machine                    Service Provider
┌──────────────┐               ┌──────────────┐
│    Wovly     │ ──API Call──► │   Google     │
│              │               │   Slack      │
│ settings.json│               │   etc.       │
│ (tokens)     │ ◄──Response── │              │
└──────────────┘               └──────────────┘

​
Auto-Reconnection

Wovly automatically reconnects integrations when you restart the app:
  • OAuth tokens are refreshed if expired
  • Connections are verified on startup
  • You’ll be notified if re-authorization is needed

​
Security

​
Token Storage

  • Tokens stored in ~/.wovly-assistant/settings.json
  • Credentials encrypted using system keychain (Electron safeStorage)

​
Revoking Access

To disconnect an integration:
  1. Go to Integrations in Wovly
  2. Click Disconnect on the integration
  3. Optionally, revoke access from the provider’s security settings

​
Troubleshooting

The token may have expired. Try:
  1. Click Disconnect
  2. Wait 5 seconds
  3. Click Connect to re-authorize
Ensure your firewall allows localhost connections. Wovly uses localhost:18923 for OAuth callbacks.
Disconnect and reconnect, ensuring you approve all requested permissions.