Skip to content

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