OpenAI API Key: Create It and Connect It to Davix AI Engine

1. Before You Start: Security & Requirements #

• You need an OpenAI account (with billing set up if required by your usage tier). OpenAI Platform
• An API key is secret:
  • Never publish it on your website.
  • Never put it in screenshots or GitHub.
  • Only paste it into secure fields in WordPress / server.

Your plugin uses this key for:

• Chatbot (bubble + full-page chat).
• Forms module (shared key or Forms-specific key).
• Auto-Reply (comments & reviews).
• AI Writer (Gutenberg sidebar).
• LLM Index (if you use OpenAI there too).

2. Step 1 – Log In to OpenAI Developer Platform #

1. Open your browser and go to the OpenAI platform dashboard. OpenAI Platform
2. Log in with your OpenAI account email/password (or SSO if you use it).
3. Once logged in, you should see the main developer dashboard with:
   • Top navigation bar.
   • Sidebar (Playground, Docs, Usage, etc.) depending on current layout.

image IMAGE PLACEHOLDER: Screenshot of the OpenAI platform dashboard after login, showing the top navigation bar and the left sidebar. IMAGE image

3. Step 2 – Open the “API Keys” Page #

OpenAI keeps API keys under “Settings → API keys” (exact wording can slightly change, but the path is the same). OpenAI Platform+1

1. In the top-right corner, click the Settings / gear icon.
2. In the settings sidebar, click “API Keys”.
3. You should see:
   • A list of existing keys (if you have any).
   • A button like “Create new secret key”.

image IMAGE PLACEHOLDER: Screenshot of OpenAI “API Keys” page showing the “Create new secret key” button and a list of existing keys (partially blurred). IMAGE image

4. Step 3 – Create a New API Key #

1. Click “Create new secret key”.
2. Give your key a name, e.g.:
   • Davix AI Engine – historact.com
3. (If available in your UI) choose:
   • Project / workspace this key belongs to.
   • Any restrictions or scopes (OpenAI supports project-based and admin keys; you normally just create a regular project key). OpenAI Platform+1
4. Click Create.

OpenAI will show you the new key once. This is the secret string you must copy now.

image IMAGE PLACEHOLDER: Screenshot of the popup showing a newly created OpenAI API key with a copy icon and a warning that the key will only be shown once. IMAGE image

Important:

• Copy this key immediately and store it in a safe place (password manager, secrets vault).
• If you lose it, you will have to create a new key and update Davix.

5. Step 4 – (Optional) Delete or Rotate Old Keys #

If you had older keys you no longer use:

1. On the API Keys page, click the trash icon next to an old key to delete it. OpenAI Help Center+1
2. Remember: once deleted, that key stops working for all apps and plugins using it.

Best practice for Davix:

• Create one dedicated key for Davix AI Engine, instead of reusing a generic key shared with other apps.
• If you suspect compromise, delete the key and create a new one.

6. Step 5 – Insert the API Key into Davix AI Engine (Global) #

Now connect the key to your plugin.

1. Log in to WordPress admin.
2. Go to Davix AI Engine → Chatbot (or General / OpenAI Settings tab – use the actual tab name your plugin uses).
3. Find the field labeled something like:
   • “OpenAI API key” or
   • “Global OpenAI API key”
     (In your docs this is the main key used by Chatbot and shared by other modules unless overridden.)
4. Paste your API key into that field.
5. Click Save changes.

image IMAGE PLACEHOLDER: Screenshot of Davix AI Engine → Chatbot (or Settings) page showing the “OpenAI API key” input field filled with a blurred key, and the Save button highlighted. IMAGE image

This global key will typically be used by:

• Chatbot.
• AI Writer (if you didn’t set a separate key).
• Auto-Reply.
• Any feature that doesn’t have its own dedicated key field.

7. Step 6 – (Optional) Insert a Separate Key for Forms #

Your Forms module can use:

• Either the global key above.
• Or its own Forms-specific OpenAI key if you want to separate billing for form traffic.

1. Go to Davix AI Engine → Forms.
2. Open the Forms AI / OpenAI tab.
3. If your docs mention a field like “Forms OpenAI API key”:
   • Paste another API key there if you want separation.
   • Leave it empty if you just want to inherit the global key.
4. Save changes.

image IMAGE PLACEHOLDER: Screenshot of the Davix → Forms settings tab showing a dedicated “Forms OpenAI API key” field (optional) and a note that leaving it empty uses the global key. IMAGE image

8. Step 7 – Test the Connection #

Test via Chatbot:

1. Open your website front-end.
2. Click the chat bubble.
3. Ask a simple question like “Hello, can you read me?”.
4. If the API key is valid:
   • You should get a friendly reply.
   • No errors should appear in the console/logs.

If anything fails:

• Enable Chatbot debug logs in Davix → Debug Logs.
• Try again and inspect the log for:
  • “Invalid API key” errors.
  • HTTP 401/403 errors from OpenAI.