Platform Integrations

Slack Integration

Authentication

• OAuth 2.0 flow with workspace installation
• Bot token management with caching
• User email mapping to system users

Features

• Real-time message processing
• Thread conversation support
• File attachment handling
• Audio message transcription
• Shared content processing
• User validation and error messaging

OAuth Scopes

Scope	Purpose
chat:write	Send messages
users:read	Access user information
users:read.email	Access user emails
channels:read	Access channel information
im:read, im:write	Direct message support
files:read	Access file attachments

Slack Controller Endpoints

• GET /slack/install - OAuth installation flow initiation
• GET /slack/oauth/callback - OAuth callback handler
• POST /slack/message - Webhook for incoming Slack messages

Message Flow

1. Receives Slack webhook events
2. Validates user against system database
3. Processes files and audio attachments
4. Sends to Messages Service for AI processing
5. Returns responses in appropriate Slack format

---

Microsoft Teams Integration

Authentication

• Microsoft Bot Framework integration
• Azure AD application registration
• Graph API access for user information

Features

• Bot framework message handling
• Audio message transcription
• File attachment processing
• Message fragmentation prevention
• Tenant-specific user lookup

API Integration

Service	Purpose
Microsoft Graph API	User data
Bot Connector Service	Messaging
Azure AD	Authentication

Teams Controller Endpoints

• POST /teams/message - Webhook for incoming Teams messages

Message Flow

1. Receives Teams bot framework messages
2. Extracts user information via Microsoft Graph API
3. Processes audio and file attachments
4. Accumulates responses to prevent fragmentation
5. Sends complete response back to Teams

---

File Importer

Endpoints

• POST /file-importer - File upload and conversion

Features

• JWT authentication required
• Multi-format file support
• Template-based data extraction
• Download or content response options
• Import ID tracking for async processing

Supported Templates

Template	Purpose
COMPANY_OPPORTUNITY	Company/account data extraction
CONTACT	Contact/person data extraction
PRODUCT	Commercial product data extraction
CUSTOMER	Customer data extraction