> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/settings/integrations/chatgpt.md).

# ChatGPT

BotPenguin lets you connect ChatGPT — directly to your Voice Bots and AI Agents. Once connected, your bots can use ChatGPT to understand questions and reply in a more natural, human-like way.

### What is ChatGPT Integration?

ChatGPT is a large language model (LLM) developed by OpenAI. It is trained on large amounts of text data, which allows it to understand questions, follow context, and generate human-like responses in a conversation. By connecting it to BotPenguin, your Voice Bots and AI Agents can use ChatGPT as their underlying AI — handling questions, generating responses, and holding smarter conversations.

To connect ChatGPT, you will need an **API key** from OpenAI. Think of an API key as a password that lets BotPenguin talk to your OpenAI account securely.

***

### When Should You Use This?

Use ChatGPT Integration when:

* You want your Voice Bot or AI Agent to give smarter, more natural responses
* You already have an OpenAI account and want to use it with BotPenguin
* You are managing multiple bots and want to use different OpenAI keys for each one

***

### Before You Begin

Before starting, make sure you have:

* A BotPenguin account
* An OpenAI account with a credit card added and billing credits available

If you do not have an OpenAI account or API key yet, start with **Part B** below first, then come back to **Part A**.

***

### Step-by-Step Instructions

#### Part A: Connect ChatGPT with BotPenguin

#### Step 1: Open the Integrations Page

The Integrations page is where you connect third-party tools like ChatGPT to your BotPenguin account.

1. Look at the left side of your screen. At the bottom of the menu, click **More** — this is the icon with three dots.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FD94JdGZ0lhwkqKua9qHZ%2Fimage%20(52).png?alt=media&amp;token=e1437d00-b53e-4db7-a5df-df90fd12f5af" alt=""><figcaption></figcaption></figure>

2. After navigating to **More**. Click **Integrations**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F2hityyg8zeQ6dOHfBwXZ%2Fimage%20(53).png?alt=media&amp;token=51d1d5f2-efbe-41f6-83ad-ba462e0635a8" alt=""><figcaption></figcaption></figure>

3. You will see a list of all available integrations. Find **ChatGPT** by scrolling or typing its name in the search bar at the top.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F0TjwmOV995ThmZdwWpt9%2Fimage%20(54).png?alt=media&amp;token=94fedf65-fa63-41e1-aa2d-36332dad1562" alt=""><figcaption></figcaption></figure>

4. Click on the ChatGPT card and then click **Connect.**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FckdsRSGR0UTOUF5RoS7Y%2Fimage%20(55).png?alt=media&amp;token=2428dd05-d217-452c-b4cf-c4cd8fc6576f" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Open the Configuration Form

1. Click the **Connect** button on the top right. This opens the configuration form.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FpdXZULa59QzyMNUe5VFe%2Fimage%20(56).png?alt=media&amp;token=b5925378-93f7-4351-a972-76cb9426481e" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Fill in the Configuration Form

The form has two fields:

**Configuration Name**\
This is just a label to help you recognise this connection later. It does not affect how the integration works.

Give it a name that tells you which key or bot it belongs to. For example:

* `Voice Bot Key`
* `Main OpenAI Account`
* `Sales Agent GPT`

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fb3MZvtTbclke28RxJcAS%2Fimage%20(65).png?alt=media&amp;token=77d7f871-c8b6-4ac2-b70f-e01d6f0ae832" alt=""><figcaption></figcaption></figure>

**API Key**\
This is the secret key you get from your OpenAI account. It is what allows BotPenguin to connect to ChatGPT on your behalf. Paste it here exactly as copied — do not add any extra spaces.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F24TiYopBuBmTIWfUdjiu%2Fimage%20(64).png?alt=media&amp;token=314edc6a-ca01-4f67-ac1e-73cbf5df8b74" alt=""><figcaption></figcaption></figure>

***

#### Step 4: Save the Configuration

Once both fields are filled in, click **Connect**.

If the key is valid, the configuration will be saved and appear in the list below the form. You will see the following columns:

| Column                 | What it means                                           |
| ---------------------- | ------------------------------------------------------- |
| **Configuration Name** | The name you gave this connection                       |
| **Details**            | Click the info icon to see which API key is linked      |
| **Status**             | A toggle switch — green means active, grey means paused |
| **Actions**            | A delete icon to remove the configuration permanently   |

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FwhHFGpFNWGlGrR4MNLZL%2Fimage%20(63).png?alt=media&amp;token=a5963e90-1694-42bb-b141-82b9cbc771f8" alt=""><figcaption></figcaption></figure>

> 💡 Use the **Status toggle** to pause a configuration without deleting it. This is useful if you want to switch keys temporarily.

***

#### Part B: Get Your OpenAI API Key

Follow these steps if you do not have an OpenAI API key yet.

***

#### Step 1: Go to the OpenAI Platform

Open your browser and go to [platform.openai.com](https://platform.openai.com/).

Log in with your OpenAI account. If you do not have one, click **Sign Up** and create a free account first.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F2mclGGY7sw0VekkUiaK5%2Fimage%20(62).png?alt=media&amp;token=a76334fb-2670-4419-81b1-263cda533cf7" alt=""><figcaption></figcaption></figure>

***

#### Step 2: Go to the API Keys Section

Once logged in, look at the left sidebar on the screen.

Click on **API Keys**. If you cannot find it, use the search bar at the top and type "API Keys".

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FeeTSLsnTJKGLCEMVLLUg%2Fimage%20(61).png?alt=media&amp;token=4644580d-d98e-4207-b07e-12bc2c14a2fd" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Create a New Key

On the API Keys page, click the **Create new secret key** button.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FQp6112arQ08veFyukHzV%2Fimage%20(60).png?alt=media&amp;token=511c640b-cc37-45d8-9590-10d70285d4ea" alt=""><figcaption></figcaption></figure>

A small form will appear asking for:

* **Name** (optional) — a label for this key, like `BotPenguin Key`
* **Project** — select the OpenAI project this key will be used with

Click **Create secret key** when done.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FoRSTpqnwuNPMe9z0LEaJ%2Fimage%20(59).png?alt=media&amp;token=65747b96-6c91-4a12-bca8-0a2b7a2542d5" alt=""><figcaption></figcaption></figure>

***

#### Step 4: Copy and Save the Key

Your new key will appear on screen. It looks like a long string of letters and numbers.

**Copy it immediately** and save it somewhere safe — a notes app, a password manager, or a secure document. OpenAI will never show this key again once you close this window.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FhRDWt3Xev9Wdp7nTLGk3%2Fimage%20(58).png?alt=media&amp;token=8b7bdc67-a7a3-44c9-95b7-2162d7378cbf" alt=""><figcaption></figcaption></figure>

***

#### Step 5: Add Billing Credits to Your OpenAI Account

Your API key will not work until you add a payment method and credits to your OpenAI account. Without this, ChatGPT will return errors even if the key is entered correctly.

1. In the left sidebar, click **Billing**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FWwa4nsGHwjptyArMt2up%2Fimage%20(57).png?alt=media&amp;token=7d0bcd57-853a-4cf0-b39c-6501633e4d85" alt=""><figcaption></figcaption></figure>

1. Click **Add Payment Details**.
2. Enter your credit card information and save.

> 💡 OpenAI accepts credit cards only. Once billing is set up, your API key becomes active and ready to use.

Now go back to **Part A, Step 3** and paste this key into BotPenguin.

***

### Best Practices

> 💡 Name each configuration clearly so you know at a glance which OpenAI key it uses and which bot it is for.

> 💡 Set up billing on OpenAI before testing — most connection errors happen because credits are missing.

> 💡 Save your API key the moment it is generated. There is no way to retrieve it from OpenAI after you close the creation window.

> 💡 If you want to stop using a configuration temporarily, use the **Status toggle** instead of deleting it.

> 💡 If you manage multiple bots with different OpenAI accounts, create a separate configuration for each key.

***

### What Might Go Wrong

| Situation                            | What Happens                                                      |
| ------------------------------------ | ----------------------------------------------------------------- |
| API key copied with an extra space   | BotPenguin cannot verify the key and the connection fails         |
| No billing credits on OpenAI         | The key appears connected but returns errors during conversations |
| Key was deleted or revoked in OpenAI | The integration stops working even though it shows as connected   |
| Status toggle is turned off          | ChatGPT will not be available in any bot using that configuration |

***

### Troubleshooting

<details>

<summary>The connection fails when I click Connect</summary>

* Check that the API key was pasted correctly — no extra spaces at the start or end.
* Log in to your OpenAI account and confirm the key has not been deleted or revoked.
* Make sure your OpenAI account has billing set up and active credits.
* If none of the above works, generate a new key in OpenAI and try again.

</details>

<details>

<summary>The key is connected but my bot is giving errors during conversations</summary>

* Log in to OpenAI and check your billing — credits may have run out.
* Confirm the key has not been restricted or revoked.
* Go to **Integrations**, find the **ChatGPT configuration**, and make sure the **Status** toggle is turned on (green).

</details>

<details>

<summary>ChatGPT is not showing as an option inside my bot settings</summary>

* Go to **More → Integrations → ChatGPT** and confirm the configuration was saved successfully.
* Check that the **Status** toggle is green (active).
* Refresh the page and check the bot settings again.

</details>

<details>

<summary>I cannot find my API key anymore</summary>

OpenAI does not allow you to view a secret key after it has been created.

You will need to:

1. Go back to your OpenAI account.
2. Generate a new key.
3. Update the configuration in BotPenguin with the new key.

</details>

### FAQs

<details>

<summary>Which bot types can use ChatGPT Integration?</summary>

ChatGPT Integration works with **Voice Bots** and **AI Agents** on BotPenguin.

</details>

<details>

<summary>Can I connect more than one API key?</summary>

Yes. You can create multiple configurations, each with a different API key.

Each configuration can be managed and toggled independently.

</details>

<details>

<summary>What happens if my OpenAI credits run out?</summary>

Your bot will start returning errors during conversations.

Log in to OpenAI, go to **Billing**, and add more credits to restore the connection.

</details>

<details>

<summary>Can I pause a configuration without deleting it?</summary>

Yes. Use the **Status** toggle next to the configuration in the list.

Turning it off pauses the configuration without removing it.

</details>

<details>

<summary>My key looks correct but is still not working — why?</summary>

A few things to check:

* The key may have been revoked inside OpenAI.
* It may belong to a project with restricted permissions.
* It may have been pasted with an invisible extra character.

Try generating a fresh key and connecting again.

</details>

<details>

<summary>Which ChatGPT models are available?</summary>

The available models depend on your OpenAI account access.

Common options include:

* GPT-3.5
* GPT-4
* GPT-4 Turbo
* GPT-4o
* Assistants API models

You can select the model inside your bot's AI settings after the integration is connected.

</details>

***

### Support

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.