Rutba CRM

Use your own AI key

Run the AI features on your company's own Claude, ChatGPT or Gemini account instead of the platform's monthly AI credits.

By default, the AI features run on the platform's AI provider and use your plan's monthly AI credits. If your company has its own account with Anthropic (Claude), OpenAI (ChatGPT) or Google (Gemini), you can enter its API key instead. The AI features then run on your account, your provider bills you directly, and no platform credits are used.

Before you start

  • This is available when your plan includes Bring your own AI key.
  • Only owners and administrators can save, change or remove the key. Other members can open the page and see which provider is in use, with the note Only a company manager can change the AI key.
  • Create an API key in your provider's console first. You pay the provider for what your company uses.

Add your key

  1. Select Your plan in the sidebar, then Your AI key.
  2. Choose the Provider: Claude (Anthropic), ChatGPT (OpenAI) or Gemini (Google).
  3. Optionally enter a Model. Leave it empty for the recommended model.
  4. Paste the key in API key.
  5. Select Test and save.

Before saving, one tiny real request is sent to the provider with your key. If the provider refuses it, nothing is saved and you see The provider did not accept this key or model. Check them and try again. When it works, you see Your key works and is saved. and the page shows Answering with …, model …, the state Working and when it was Last checked.

Models

Provider Recommended model, used when the field is empty
Claude (Anthropic) claude-opus-5-5
ChatGPT (OpenAI) gpt-4.1-mini
Gemini (Google) gemini-2.5-flash

A model you enter must belong to the chosen provider: Claude models start with claude-, ChatGPT models with gpt-, o and a digit, or chatgpt-, and Gemini models with gemini-. A model name that does not match is replaced by the recommended one.

Change the model or provider

  • To change only the model, keep the same provider, leave API key empty (Leave empty to keep the current value), enter the new model and select Test and save.
  • To change the provider, enter a key for the new provider. A key is required: Enter the API key for this provider.

What changes when your key is in use

  • Every AI feature uses your key: the AI assistant, the AI agent, voice messages, the AI note in digests and Ask your data.
  • None of it uses the plan's AI credits a month. The agent's report shows these answers as Answers paid with your own key.
  • AI assistant and Assistant that replies to customers are turned on for your company even if your plan does not include them, because you pay for the use. The platform can still turn them off for your company on purpose, and then your key does not turn them back on.
  • Other limits of your plan stay as they are. Knowledge articles, for example, still need Knowledge articles in your plan.
  • Costs are not shown here in money. Check your usage and bill in your provider's console.

Voice messages and Claude

Claude does not accept audio. With a Claude key, voice messages are not written out. Choose ChatGPT or Gemini if you need them.

Remove your key

  1. Open Your AI key.
  2. Select Remove key.

The key is deleted and you see Your key was removed. AI features now use the platform. From then on the AI features use the platform's provider and your monthly credits again. If your plan does not include them, they turn off.

How your key is kept

  • The key is stored encrypted and is never shown again, on this page or anywhere else. It is not written to logs.
  • It is sent only to the provider you chose. Gemini keys travel in a request header, never in a web address.
  • What the AI features send with each request is the same as with the platform's provider, and follows the rules in AI assistant. Your provider's own terms apply to that data.

Troubleshooting

What you see What it means
Failing The saved key can no longer be read, for example after a change on the server. It has stopped being used and your company is back on the platform's AI and credits. Enter the key again and select Test and save.
AI requests fail although the state is Working The provider stopped accepting the key, for example because it was revoked or your account ran out of funds. Check it in the provider's console, then save it again.
The provider did not accept this key or model. Check them and try again. The key is wrong, has no access to that model, or the model name is not one the provider offers.

Last updated 2026-11-08