Setting Up Integrations

​

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

Setup Guide: Messaging Platform Integration Guides

​

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

​

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

​

Productivity Tools

​

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

​

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

​

Discord Setup

​

Create Discord Application

1. Go to Discord Developer Portal
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

​

Slack Setup

​

Create Slack App

1. Go to 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

​

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
• 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

​

Common Resources

• Google Workspace Admin
• Microsoft Admin Center
• Notion Workspace Settings
• Trello Power-Ups

​

Next Steps