OpenAI

Connect your own OpenAI API key for Empuls AI features — AI writing assistance, content moderation, skill mapping — using a model you control.

The OpenAI integration lets you bring your own OpenAI API key for the AI features inside Empuls. By default, AI features run on Empuls-managed models. If your organization has its own OpenAI contract — for example, to meet data-residency requirements, control model selection, or apply your own usage budgets — connect your key here and the AI features in Empuls will use it instead. Open the integrations hub in your tenant at https://<your-empuls-url>/home/integrations and click OpenAI.

Before you start

• You must be a Super Admin in Empuls.
• You need an OpenAI account with an API key that has access to the model tier you want to use (typically GPT-4 class for the best results).
• Confirm with your OpenAI account’s billing owner that the projected token usage is within your plan limits — AI writing suggestions and content moderation can be high-volume.

Connect OpenAI

1. Generate an OpenAI API key

   In the OpenAI dashboard, navigate to API Keys and create a new secret key. Scope it tightly if your plan supports project-level scopes.

2. Open the OpenAI card in Empuls

   From the Integrations hub, click OpenAI → Configure.

3. Paste your API key

   Empuls validates the key against OpenAI’s API. A successful response shows the available models.

4. Pick a default model

   Choose which model Empuls should use for AI features. The picker only shows models your key has access to.

5. Pick which Empuls AI features use your key

   By default, every AI feature uses your key once you connect. Optionally narrow the scope to specific features — for example, only AI writing suggestions but not AI content moderation.

6. Save

   AI features switch to your key on the next request.

What’s covered

Empuls AI feature	Default model usage
AI writing suggestions (recognition citations, wish messages)	Uses your key
AI content moderation	Uses your key
AI skill mapping	Uses your key
Em Copilot	Uses your key

You can toggle each feature on or off per the previous step.

Monitor usage

Empuls surfaces a usage snapshot per feature (calls/day, tokens/day) on the OpenAI integration page so you can track consumption against your OpenAI plan. For detailed billing, check your OpenAI dashboard.

Reconnect or disconnect

• Reconnect — Replace the key when you rotate credentials in OpenAI. Empuls validates the new key before swapping.
• Disconnect — Revert to Empuls-managed AI. The key is removed from Empuls; you may want to revoke it in OpenAI as well.

Limits and gotchas

• OpenAI rate limits apply per your account tier. Heavy AI usage may hit rate limits — Empuls will fall back to managed AI gracefully if configured.
• Costs are billed to your OpenAI account, not Empuls.
• The key is stored encrypted in Empuls. Rotate it on a schedule that matches your security policy.

Related

• AI settings — Toggle individual AI features on or off.
• AI skill mapping — One of the features that can use your OpenAI key.
• Em Copilot — Conversational AI assistant.