WorkestraDocs
Integrations

OpenAI Integration

Connect OpenAI for enhanced AI capabilities.

OpenAI Integration

Connect your OpenAI account for module-specific AI features beyond the workspace AI configuration.

OpenAI connection modal

Screenshot needed � add an annotated image showing this UI

What It Does

The OpenAI integration enables:

  • Module-specific AI — Custom AI features in individual modules
  • Separate API keys — Different key from workspace AI
  • Feature isolation — Specific use cases only

This is different from the workspace AI Configuration in Settings. This integration is for module-specific use cases.

Connecting OpenAI

Step 1: Get API Key

From OpenAI:

  1. Go to OpenAI API
  2. Sign in to your account
  3. Go to API Keys
  4. Create new secret key
  5. Copy the key (starts with sk-)

Step 2: Connect in Workestra

  1. Go to Settings > Connected Accounts
  2. Click Connect OpenAI
  3. Paste your API key
  4. Click Validate
  5. System verifies key
  6. Save connection

Use Cases

Recruiting Enhancement

  • Advanced resume parsing
  • Custom interview questions
  • Enhanced candidate summaries
  • Cultural fit analysis

Content Generation

  • Marketing copy generation
  • Email template suggestions
  • Knowledge Base article drafts
  • Documentation assistance

Data Analysis

  • Custom report insights
  • Anomaly detection
  • Trend analysis
  • Predictive modeling

API Key Management

Rate Limits

OpenAI rate limits apply:

TierRPMTPM
Free3150
Tier 13,500350K
Tier 23,5001M

Monitor usage in OpenAI dashboard. Set up billing alerts to avoid interruptions.

Cost Management

Control costs:

  • Set usage limits
  • Monitor token consumption
  • Use appropriate models
  • Cache results when possible

Model Selection

Available models:

ModelBest ForCost
GPT-4oComplex tasksHigher
GPT-4o-miniMost use casesLower
GPT-3.5-turboSimple tasksLowest

Disconnecting

To remove:

  1. Go to Settings > Connected Accounts
  2. Find OpenAI
  3. Click Disconnect
  4. Confirm

Disconnecting stops module-specific AI features. Workspace AI continues working.

Troubleshooting

"Invalid API Key"

  • Check key format (sk-)
  • Verify key hasn't been revoked
  • Ensure billing is set up
  • Check for extra spaces

Rate Limit Errors

  • You've hit OpenAI limits
  • Upgrade OpenAI plan
  • Implement request throttling
  • Wait and retry

High Costs

  • Review token usage
  • Switch to cheaper model
  • Reduce request frequency
  • Implement caching

Next Steps