> For the complete documentation index, see [llms.txt](https://partners.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partners.botpenguin.com/partner-platform-guidelines/integration/setup-gemini-integration.md).

# Setup Gemini Integration

#### What is Gemini?

Gemini is Google's AI model platform that enables advanced AI-powered capabilities. Integrating Gemini with the Agency Panel allows you to use Google's Gemini AI models directly within your platform — enabling smarter, more powerful bot responses and AI-driven automation for your customers.

***

#### Benefits of Gemini Integration

* 🤖 Enables Google's Gemini AI models to power your bots with advanced intelligence.
* ⚙️ Allows agency-level control over which AI model is used across your customer accounts.
* 🔑 Connects using a secure API key generated directly from Google AI Studio.
* 📊 Centralizes AI configuration within your Agency Panel's integrations module.
* 🌐 Scales across all customer bots once the integration is configured at the agency level.

***

#### How to Use Gemini Integration

#### A. Connecting Gemini from the Agency Panel

1. Log in to your Agency Panel.
2. Click on "Integrations" from the left sidebar.
3. Search for "Gemini" in the search bar or scroll down to locate it.

<figure><img src="/files/BeB7cHP8CEyeKASaDuqm" alt=""><figcaption></figcaption></figure>

4. Click "Connect/Configure" on the Gemini card.
5. Here, the API Key — Obtained from Google AI Studio needs to be added.

<figure><img src="/files/enaweiq6pjqOmGfCXmyC" alt=""><figcaption></figcaption></figure>

***

#### B. Generating Your Gemini API Key

6. Open a new tab and go to [**Google AI Studio**](https://aistudio.google.com/).
7. Sign in with your Google account if not already logged in.
8. Click on **"Get API Key"** or navigate to the **API Keys** section.

<figure><img src="/files/mo8DyN9kZkNPi3kiesHo" alt=""><figcaption></figcaption></figure>

9. Click **"Generate Key"** (or **"Create API Key"**).
10. Enter a **name** for your API key (e.g., "Agency Panel Key") and confirm.

<figure><img src="/files/KWVtqDT9VMfY3tgGnDJW" alt=""><figcaption></figcaption></figure>

11. The API key will be displayed on screen.

{% hint style="warning" %}
**Important:** The API key is visible **only once**. Copy it immediately and store it in a safe place before closing this screen.
{% endhint %}

<figure><img src="/files/PbjmpIa8iWuu6rpBD9UR" alt=""><figcaption></figcaption></figure>

12. Paste the copied API key into the **API Key** field back in your Agency Panel.
13. Click **"Save/Update"** to complete the configuration.

<figure><img src="/files/d5dlt4xrV892MHnfrxhu" alt=""><figcaption></figcaption></figure>

***

#### C. Setting Up Billing in Google AI Studio

{% hint style="warning" %}
**Critical:** Billing must be configured in Google AI Studio for the API key to function. Without valid billing credentials, API calls will fail.
{% endhint %}

14. Go to [**Google AI Studio Billing**](https://aistudio.google.com/billing) — this link is also available directly within the integration setup screen in your Agency Panel.

<figure><img src="/files/dLLdvef83N1lj5YepHwm" alt=""><figcaption></figcaption></figure>

15. If billing is not yet configured, click "Setup Billing".
16. Follow Google's billing setup process:
    * Add your payment card details
    * Confirm your billing account information
    * Submit to activate billing
17. Once billing is set up, you may see a warning message inside the Gemini console prompting you to verify your payment method. Complete the verification as instructed before proceeding.

{% hint style="info" icon="lightbulb" %}
**Tip:** Billing setup follows Google's standard process. Ensure your card is valid and has no restrictions on international or online transactions.
{% endhint %}

***

#### Troubleshooting

<details>

<summary><strong>API key is not accepted in the Agency Panel</strong></summary>

**Likely Cause:**\
The API key was copied incorrectly or only partially pasted.

**Solution:**\
Generate a new API key from Google AI Studio and paste it again. Remember that API keys are displayed only once after creation.

</details>

<details>

<summary><strong>API key is not working even after correct entry</strong></summary>

**Likely Cause:**\
Billing has not been configured for the Google AI Studio account.

**Solution:**\
Visit Google AI Studio Billing and complete the billing setup process, including adding a valid payment method.

</details>

<details>

<summary><strong>API calls are failing after integration</strong></summary>

**Likely Cause:**\
The payment method has not been fully verified.

**Solution:**\
Check the Gemini console for any billing or payment verification warnings and complete the required verification steps.

</details>

<details>

<summary><strong>"Add Configuration" option is not visible</strong></summary>

**Likely Cause:**\
You may already be on the Gemini integration screen without an existing configuration.

**Solution:**\
Navigate to the Gemini integration page and click **Add Configuration** to create a new connection.

</details>

<details>

<summary><strong>Integration shows as disconnected after saving</strong></summary>

**Likely Cause:**\
The session may have expired, or the API key entered is invalid.

**Solution:**\
Re-enter the API key and save the configuration again. Ensure there are no leading or trailing spaces in the key field.

</details>

{% hint style="info" %}
**Tip:** Always verify billing and payment method on Google AI Studio before testing your integration to avoid failed API calls.
{% endhint %}

***

### FAQs

<details>

<summary><strong>Do I need a paid Google account to use Gemini integration?</strong></summary>

You need a Google account with billing configured in Google AI Studio.

Google may provide free-tier usage, but billing credentials, including a valid payment method, must be added before API keys can be used successfully.

</details>

<details>

<summary><strong>Why is my API key not working after I entered it correctly?</strong></summary>

The most common cause is an incomplete billing setup.

Even if the API key is entered correctly, requests will fail until billing has been configured in Google AI Studio.

</details>

<details>

<summary><strong>The API key was shown only once and I forgot to copy it. What should I do?</strong></summary>

API keys cannot be retrieved after leaving the generation screen.

Generate a new API key in Google AI Studio and copy it immediately before closing or refreshing the page.

</details>

<details>

<summary><strong>What should I name the configuration in the Agency Panel?</strong></summary>

You can use any name that helps you identify the configuration later.

Examples include:

* Gemini Main
* Google AI Key
* Production Gemini

The configuration name is used only for internal reference.

</details>

<details>

<summary><strong>Can I add more than one Gemini configuration?</strong></summary>

This depends on the capabilities available in your Agency Panel.

If multiple configurations are supported, each configuration will require its own API key generated from Google AI Studio.

</details>

<details>

<summary><strong>What does the payment verification warning in the Gemini console mean?</strong></summary>

This warning indicates that Google requires confirmation of your payment method before activating billing fully.

Follow the instructions displayed in the Gemini console to complete payment verification. The integration will not function until the verification process is completed.

</details>

<details>

<summary><strong>Can I disconnect Gemini later?</strong></summary>

Yes. You can disconnect or remove the Gemini configuration at any time from the **Integrations** section of your Agency Panel.

Removing the integration will not affect your other Agency Panel settings.

</details>

***

If you still have questions for our team, write to us at **<support@botpenguin.com>**. We'll get back to you within 48 hours.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/partner-platform-guidelines/integration/setup-gemini-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.