Microsoft 365 Integration

Overview

Microsoft 365 integration provides access to Outlook, Calendar, OneDrive, Teams, and other Microsoft services through Microsoft Graph API.

Supported Services

Outlook Email - Send, read, and manage emails
Calendar - Schedule events and manage availability
OneDrive - Access and manage files
Teams - Channel and chat integration
Contacts - Access and manage contacts
To Do - Task management

Setup

1. Register Application in Azure

Go to Azure Portal
Navigate to “Azure Active Directory” > “App registrations”
Click “New registration”
Enter application details:
- Name: “Praxos”
- Supported account types: Choose based on needs
- Redirect URI: https://your-domain.com/auth/microsoft/callback

2. Configure API Permissions

Add delegated permissions: Mail

Mail.Read
Mail.ReadWrite
Mail.Send

Calendar

Calendars.Read
Calendars.ReadWrite

Files

Files.Read.All
Files.ReadWrite.All

Teams (optional)

Team.ReadBasic.All
Channel.ReadBasic.All
ChatMessage.Send

3. Create Client Secret

Go to “Certificates & secrets”
Click “New client secret”
Set expiration (recommended: 24 months)
Copy the secret value immediately

4. Configure Praxos

Add to .env:

MICROSOFT_CLIENT_ID=your-application-id
MICROSOFT_CLIENT_SECRET=your-client-secret
MICROSOFT_TENANT_ID=your-tenant-id
MICROSOFT_REDIRECT_URI=https://your-domain.com/auth/microsoft/callback

User Authorization

OAuth flow for user authorization:

User requests Microsoft integration
Praxos provides authorization URL
User signs in with Microsoft account
Grants requested permissions
Tokens stored securely
Integration complete

Features

Outlook Email

Send Emails

User: Send an email to jane@company.com
Praxos: What should the subject and message be?
User: Subject: Team Update, Message: [...]
Praxos: ✓ Email sent to jane@company.com

Read Emails

User: Show my recent emails
Praxos: Recent emails:
         1. Sarah - Project Status Update (10 min ago)
         2. Mike - Meeting Notes (1 hour ago)
         3. Team - Weekly Newsletter (2 hours ago)

Search and Filter

User: Find emails from last week about "budget"
Praxos: Found 4 emails about "budget" from last week...

Calendar

Schedule Meetings

User: Schedule a 1-hour meeting with john@company.com tomorrow at 3pm
Praxos: Meeting scheduled:
         Title: Meeting with John
         Time: Tomorrow, 3:00 PM - 4:00 PM
         Attendee: john@company.com
         [View in Outlook]

Check Schedule

User: What meetings do I have today?
Praxos: Today's meetings:
         • 10:00 AM - Team Sync (30 min)
         • 2:00 PM - Client Review (1 hour)
         • 4:00 PM - Planning Session (45 min)

Find Meeting Times

User: When are all three of us free for 30 minutes this week?
Praxos: Checking availability...
         All free:
         • Wed 2:00 PM - 3:00 PM
         • Thu 10:30 AM - 11:30 AM
         • Fri 3:00 PM - 4:00 PM

OneDrive

File Access

User: Get my presentation from OneDrive
Praxos: Found "Q3_Presentation.pptx" in OneDrive
         Last modified: 2 days ago
         [Open] [Download] [Share]

Upload Files

User: [Sends file] Upload to my OneDrive
Praxos: Uploaded "report.docx" to OneDrive
         Location: Documents/Reports/
         [View in OneDrive]

Share Files

User: Share this file with the marketing team
Praxos: Created share link for "campaign_ideas.xlsx"
         Access: Team can edit
         Link: https://1drv.ms/x/s!Abc...

Teams Integration

Send Channel Messages

User: Post in #general that the deployment is complete
Praxos: Posted to #general in Engineering team:
         "✓ Deployment complete. All systems operational."

Configuration

Environment Variables

# Required
MICROSOFT_CLIENT_ID=your-app-id
MICROSOFT_CLIENT_SECRET=your-secret
MICROSOFT_TENANT_ID=your-tenant-id

# Optional
MICROSOFT_REDIRECT_URI=https://your-domain.com/auth/microsoft/callback
MICROSOFT_AUTHORITY=https://login.microsoftonline.com
MICROSOFT_SCOPES=Mail.ReadWrite,Calendars.ReadWrite,Files.ReadWrite.All

Graph API Settings

# Default settings
GRAPH_API_ENDPOINT = "https://graph.microsoft.com/v1.0"
MAX_RESULTS_PER_PAGE = 50
REQUEST_TIMEOUT = 30  # seconds

Advanced Features

Batch Requests

For efficiency, batch multiple requests:

# Example: Get calendar + emails + files in one request
batch_response = await graph.batch([
    get_calendar_events(),
    get_recent_emails(),
    get_recent_files()
])

Delta Queries

Track changes efficiently:

# Only get changes since last sync
delta_emails = await graph.get_delta('messages', last_delta_token)

Webhooks

Real-time notifications for:

New emails
Calendar changes
File updates

Troubleshooting

Authentication Issues

Invalid Client

Verify Client ID and Secret
Check Application ID in Azure Portal
Ensure secret hasn’t expired

Insufficient Permissions

Check required API permissions granted
Admin consent may be required
Verify user has necessary licenses

API Errors

403 Forbidden

User lacks permissions
Application lacks API permissions
Tenant admin hasn’t consented

429 Too Many Requests

Rate limit exceeded
Implement backoff strategy
Review request patterns

5xx Server Errors

Microsoft service issues
Retry with exponential backoff
Check Microsoft Service Health

Rate Limits

Microsoft Graph throttling limits:

Resource	Limit
Mail	10K requests/10 min
Calendar	10K requests/10 min
Files	10K requests/10 min
Batch	4 requests/second

Praxos automatically handles throttling with retry logic and exponential backoff.

Security

Token Security

Tokens encrypted at rest
Automatic token refresh
Secure credential storage
Per-user isolation

Conditional Access

Support for:

Multi-factor authentication
Conditional Access policies
Device compliance requirements

Compliance

GDPR compliant
SOC 2 considerations
Data residency options
Audit logging

Best Practices

Use batch requests when possible
Implement delta queries for sync
Cache frequently accessed data
Monitor API usage and throttling
Use webhooks for real-time updates

Getting Started

Web Application

Integrations

Tools & Capabilities

Deployment

Microsoft 365 Integration

Overview

Supported Services

Setup

1. Register Application in Azure

2. Configure API Permissions

3. Create Client Secret

4. Configure Praxos

User Authorization

Features

Outlook Email

Calendar

OneDrive

Teams Integration

Configuration

Environment Variables

Graph API Settings

Advanced Features

Batch Requests

Delta Queries

Webhooks

Troubleshooting

Authentication Issues

API Errors

Rate Limits

Security

Token Security

Conditional Access

Compliance

Best Practices

Next Steps

Notion Integration

Email Tools

​Overview

​Supported Services

​Setup

​1. Register Application in Azure

​2. Configure API Permissions

​3. Create Client Secret

​4. Configure Praxos

​User Authorization

​Features

​Outlook Email

​Calendar

​OneDrive

​Teams Integration

​Configuration

​Environment Variables

​Graph API Settings

​Advanced Features

​Batch Requests

​Delta Queries

​Webhooks

​Troubleshooting

​Authentication Issues

​API Errors

​Rate Limits

​Security

​Token Security

​Conditional Access

​Compliance

​Best Practices

​Next Steps

Notion Integration

Email Tools

Overview

Supported Services

Setup

1. Register Application in Azure

2. Configure API Permissions

3. Create Client Secret

4. Configure Praxos

User Authorization

Features

Outlook Email

Calendar

OneDrive

Teams Integration

Configuration

Environment Variables

Graph API Settings

Advanced Features

Batch Requests

Delta Queries

Webhooks

Troubleshooting

Authentication Issues

API Errors

Rate Limits

Security

Token Security

Conditional Access

Compliance

Best Practices

Next Steps