Connected Accounts
Manage your integration connections for Gmail, Google Calendar, Google Drive, Slack, and more.
The Integrations page lets you connect and manage your personal accounts for services that VectorChat agents can use.
What Are Connected Accounts?
When an agent is configured with a tool set to "Personal Connection" mode, each user needs their own account connected for that tool. Your connected accounts are only used when you interact with agents that require personal connections.
Agents using "Shared" mode use the admin's credentials instead, so you don't need to connect your own account for those.
Managing Connections
Connecting an Account
- Go to Settings > Integrations.
- Find the service you want to connect.
- Click Connect.
For OAuth-based integrations (Gmail, Google Calendar, Google Drive, Slack), you'll be redirected to the provider's authorization page to grant access. For credential-based integrations (IMAP/SMTP, CalDAV), a dialog will appear where you can enter your server details.
Reconnecting
If your connection expires or stops working, click Reconnect next to the integration. This takes you through the authorization flow again to refresh your credentials.
Disconnecting
- Click Disconnect next to the connected service.
- Confirm the action in the dialog.
Disconnecting removes your stored credentials. Agents with personal connections to that service will no longer be able to access your account.
OAuth Integrations
These integrations use secure OAuth 2.0 authorization:
| Service | What It Enables |
|---|---|
| Gmail | Agents can read, send, and organize your email |
| Google Calendar | Agents can view and create calendar events |
| Google Drive | Agents can search and read your files |
| Slack | Agents can send messages and read conversations |
Credential-Based Integrations
These integrations use server credentials you provide directly:
Email (IMAP/SMTP)
Works with any email provider that supports IMAP and SMTP. You'll need:
- IMAP host and port (typically port 993 for SSL)
- SMTP host and port (typically port 465 or 587)
- Your email username and password (or app password)
You can test the connection before saving to make sure everything is configured correctly.
Calendar (CalDAV)
Works with any CalDAV-compatible calendar service. You'll need:
- CalDAV server URL
- Your username and password
For services that use two-factor authentication, you may need to generate an app-specific password instead of using your regular password.
Connection Status
Each integration shows its current status:
- Connected -- The integration is active. You'll see the connected email or team name, and the date you connected.
- Not connected -- The integration is available but not yet linked to your account.