> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mypraxos.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Setting Up Integrations
> Connect your favorite services through the Praxos web app
## Overview
The Praxos web application provides the easiest way to connect and manage your integrations through visual OAuth flows and intuitive configuration interfaces.
## Integration Dashboard
Access integrations from the sidebar:
* Click **Integrations** in navigation
* View all available integrations
* See connection status
* Manage existing connections
## Connection Process
### OAuth Integrations
For services that use OAuth (Google, Microsoft, Notion, etc.):
**Step 1: Select Integration**
1. Go to Integrations page
2. Find the service you want to connect
3. Click **Connect** button
**Step 2: Authorization**
1. You'll be redirected to the service's login page
2. Sign in with your account
3. Review requested permissions
4. Click **Allow** or **Authorize**
**Step 3: Confirmation**
1. You'll be redirected back to Praxos
2. Connection status shows as **Connected**
3. Integration is ready to use
### API Key Integrations
For services that use API keys (Trello, etc.):
**Step 1: Get API Credentials**
1. Visit the service's developer portal
2. Create an API key or token
3. Copy the credentials
**Step 2: Add to Praxos**
1. Click **Connect** on the integration
2. Paste API key in the field
3. Click **Save**
4. Test connection
## Available Integrations
### Messaging Platforms
Connect your Telegram bot for mobile access
Add Praxos to your Discord servers
Integrate with your Slack workspace
Connect via WhatsApp Business API
**Setup Guide:** [Messaging Platform Integration Guides](/integrations/overview)
### Google Services
**Connect Once, Access All:**
When you connect Google, you can choose which services to enable:
* ✅ Gmail - Email management
* ✅ Google Calendar - Event scheduling
* ✅ Google Drive - File storage
* ✅ Google Search - Web search
**Setup Steps:**
1. Click **Connect Google**
2. Sign in with Google account
3. Review and accept permissions:
* Read/send emails
* Manage calendar events
* Access Drive files
4. Click **Allow**
5. Choose which services to enable
6. Done!
**Detailed Guide:** [Google Integration](/integrations/google)
### Microsoft 365
**Available Services:**
* Outlook Email
* Outlook Calendar
* OneDrive
* Teams (coming soon)
**Setup Steps:**
1. Click **Connect Microsoft**
2. Sign in with Microsoft account
3. Grant permissions for selected services
4. Click **Accept**
5. Connection established
**Detailed Guide:** [Microsoft Integration](/integrations/microsoft)
### Productivity Tools
Access your Notion workspace
Manage Trello boards and cards
File storage and sharing
## Managing Connections
### View Connection Status
Check integration health:
* **Connected** (green) - Working properly
* **Needs Attention** (yellow) - Needs re-auth
* **Disconnected** (red) - Not connected
* **Syncing** (blue) - Currently syncing data
### Test Connection
Verify integration is working:
1. Click on connected integration
2. Click **Test Connection**
3. View test results
4. Fix any issues if needed
### Re-authorize
If connection expires or has issues:
1. Click on integration
2. Click **Re-authorize**
3. Complete OAuth flow again
4. Connection restored
### Disconnect
Remove an integration:
1. Click on connected integration
2. Scroll to bottom
3. Click **Disconnect**
4. Confirm disconnection
Disconnecting removes access to that service. You can reconnect anytime.
## Permission Management
### Review Permissions
See what access Praxos has:
1. Click on integration
2. Go to **Permissions** tab
3. View granted permissions
4. Understand what each permission allows
### Modify Permissions
Some integrations allow selective permissions:
1. Click **Edit Permissions**
2. Enable/disable specific access
3. Save changes
4. May require re-authorization
### Revoke Access
Remove Praxos access from service side:
1. Visit service's account settings
2. Find connected apps/integrations
3. Locate Praxos
4. Click Revoke or Remove
5. Disconnect in Praxos too
## Integration Settings
### Sync Preferences
Control how data syncs:
* **Sync Frequency** - Real-time, hourly, daily
* **Sync Direction** - Read-only, read-write
* **Data Range** - Last 30 days, 90 days, all time
### Notification Settings
Configure per-integration notifications:
* New items (emails, events, etc.)
* Errors or connection issues
* Sync completion
* Rate limit warnings
### Usage Limits
Monitor API usage:
* **Requests Used** - Current period usage
* **Requests Remaining** - Before limit
* **Rate Limit** - Requests per hour/day
* **Reset Time** - When limit resets
## Telegram Setup
Telegram is the easiest messaging platform to set up:
### Create Bot
1. Open Telegram
2. Search for @BotFather
3. Send `/newbot`
4. Follow prompts to name your bot
5. Copy the bot token provided
### Connect in Praxos
1. Go to Integrations > Telegram
2. Click **Connect**
3. Paste bot token
4. Click **Save**
5. Test: Send message to your bot
### Use Your Bot
1. Find your bot in Telegram (search for username)
2. Start chat with `/start`
3. Begin talking to Praxos through Telegram
**Full Guide:** [Telegram Integration](/integrations/telegram)
## Discord Setup
### Create Discord Application
1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
2. Click **New Application**
3. Name it "Praxos"
4. Go to **Bot** section
5. Click **Add Bot**
6. Copy bot token
### Connect in Praxos
1. Go to Integrations > Discord
2. Click **Connect**
3. Enter bot token and application ID
4. Click **Save**
### Invite to Server
1. Praxos generates invite URL
2. Click **Invite to Server**
3. Select Discord server
4. Grant permissions
5. Authorize
**Full Guide:** [Discord Integration](/integrations/discord)
## Slack Setup
### Create Slack App
1. Go to [api.slack.com/apps](https://api.slack.com/apps)
2. Click **Create New App**
3. Choose **From scratch**
4. Name: "Praxos"
5. Select workspace
### Install to Workspace
1. In Praxos: Click **Connect Slack**
2. Follow OAuth flow
3. Select workspace
4. Review permissions
5. Click **Allow**
### Use in Slack
1. Invite @Praxos to channel: `/invite @Praxos`
2. Mention bot: `@Praxos help me`
3. Or DM the bot directly
**Full Guide:** [Slack Integration](/integrations/slack)
## Troubleshooting
### Connection Failed
**Possible causes:**
* Network issues
* Invalid credentials
* Insufficient permissions
* Service is down
**Solutions:**
* Check internet connection
* Verify credentials are correct
* Grant all required permissions
* Check service status page
* Try again in a few minutes
### Sync Issues
**Symptoms:**
* Old data showing
* Missing recent items
* Sync never completes
**Solutions:**
* Click **Sync Now** button
* Check sync settings
* Verify service access hasn't been revoked
* Re-authorize if needed
* Contact support if persistent
### Permission Errors
**Error: "Insufficient permissions"**
**Fix:**
1. Click **Re-authorize**
2. Ensure all permissions are granted
3. Check service settings for restrictions
4. Verify account has necessary access
### Rate Limits
**Error: "Rate limit exceeded"**
**What happened:**
You've hit the API rate limit for that service.
**Solutions:**
* Wait for rate limit to reset (shown in integration)
* Reduce sync frequency
* Spread usage over time
* Upgrade service plan if available
## Best Practices
### Security
* Use strong passwords for all accounts
* Enable 2FA on connected services
* Regularly review connected apps
* Revoke access for unused integrations
* Don't share integration credentials
### Organization
* Connect integrations as needed
* Disconnect unused integrations
* Use descriptive names for OAuth apps
* Review permissions periodically
* Keep credentials updated
### Performance
* Set appropriate sync frequencies
* Don't connect duplicate integrations
* Monitor rate limits
* Clear old data regularly
## Integration-Specific Tips
### Gmail
* Grant both read and send permissions for full functionality
* Use labels for organization
* Set up filters in Gmail for Praxos actions
* Consider a dedicated Gmail account
### Google Calendar
* Connect all calendars you want to manage
* Set default calendar for new events
* Enable notifications for calendar changes
* Sync both work and personal calendars
### Notion
* Share specific pages/databases with Praxos integration
* Use templates for consistent structure
* Organize with databases
* Regular database cleanup
### Trello
* Connect boards you actively use
* Set up Power-Ups in Trello for enhanced features
* Use labels and due dates consistently
* Archive completed boards
## Advanced Setup
### Multiple Accounts
Connect multiple accounts of the same service:
1. First account: Standard OAuth flow
2. Additional accounts:
* Click **Add Another Account**
* Complete OAuth for second account
3. Label each account (e.g., "Work Gmail", "Personal Gmail")
4. Choose default account in settings
### Webhook Configuration
For real-time updates (advanced users):
1. Go to integration settings
2. Enable **Webhooks**
3. Copy webhook URL
4. Configure in service (if supported)
5. Test webhook
6. Receive instant notifications
### Custom Integration
Need a service not listed?
* Check **Community Integrations** tab
* Or request new integration: [feedback@mypraxos.com](mailto:feedback@mypraxos.com)
* Enterprise: Custom integration development available
## Getting Help
### Integration Support
* **Documentation** - Detailed guides for each service
* **In-App Help** - Context-sensitive help in each integration
* **Community** - Forum for user discussions
* **Support** - Email [support@mypraxos.com](mailto:support@mypraxos.com)
### Common Resources
* [Google Workspace Admin](https://admin.google.com)
* [Microsoft Admin Center](https://admin.microsoft.com)
* [Notion Workspace Settings](https://notion.so/my-integrations)
* [Trello Power-Ups](https://trello.com/power-ups)
## Next Steps
Detailed setup for each integration
See what you can do with integrations
Learn about available capabilities
Monitor your integrations