> 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-google-translation.md).

# Setup Google Translation

### What is Google Translate?

Google Translate integration allows you to connect customers with Google Cloud Translation services. It enables automatic translation of customer conversations in real time in the inbox, helping support agents communicate with users across multiple languages directly from the inbox.

The integration works using the Google Cloud Translation API and requires an API key generated from Google Cloud Console.

***

### Benefits of Google Translate Integration

* 🌍 Enables real-time multilingual customer communication
* ⚡ Reduces manual translation effort for support teams
* 🎯 Improves response efficiency for global audiences
* 🔄 Automatically translates chats directly inside the inbox
* 📈 Enhances customer support experience across regions

***

### Expected Outcome

After setting this up:

* Your Google Translate integration will be successfully connected
* Your customers will communicate with Google Cloud Translation services
* You will be able to auto-translate inbox conversations in real time

> 💡 Tip: Send a sample multilingual message inside the inbox after setup to validate the translation flow.

***

### 🔐 Prerequisites

Before setting up this integration, ensure you have:

* An active Google Cloud account
* Admin or Owner access to the Google Cloud project
* Billing enabled inside Google Cloud Console
* Cloud Translation API enabled inside the project
* Access to create API credentials

> ⚠️ Missing prerequisites may result in failed connections or API authorization issues.

***

### How to Use Google Translate Integration

#### Part 1: Configure Google Translate Inside BotPenguin

1. Login to your Partner Panel and go to the **“Integrations”** section from the left sidebar.

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

2. Search for **“Google Translations”** or scroll down to locate it.

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

3. Click on **“Configure”** or **“Connect”** to start the setup process.
4. Click on **“Add Configuration”** to create a new connection.

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

5. Enter the following details:
   1. **Configuration Name** → Internal identification name for this connection
   2. **API Key** → Google Cloud Translation API key generated from Google Cloud Console

***

#### Part 2: Setup Google Cloud Translation API

6. Open [Google Cloud Console](https://console.cloud.google.com?utm_source=chatgpt.com) and either:
   1. Create a new project
   2. Or select an existing project

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

7. In the top search bar, search for **“Cloud Translation API”**.

<figure><img src="/files/3s05RVLZXbrsycs8NRWw" alt=""><figcaption></figcaption></figure>

8. Open the Cloud Translation API page and click **“Enable”**.

<figure><img src="/files/9XrgAROUJC42gMAmGnXM" alt=""><figcaption></figcaption></figure>

9. If billing is not enabled for the project, Google will ask you to configure billing.
   1. Click **“Enable Billing”**
   2. Create a billing account
   3. Add your payment method
   4. Complete the billing setup process

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

10. Once the billing details are done, and the "Cloud Translation API" has been enabled, it show appear as "**Manage**".

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

#### Part 3: Create the API Key

11. Inside Google Cloud Console, click the top-left navigation menu.

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

12. Go to: **APIs & Services → Credentials**

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

13. Click on **“Create Credentials”** and select **“API Key”**.

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

14. Configure the API key:
    1. Add a name for the API key
    2. Under **API Restrictions**, select **Cloud Translation API**

> ⚠️ If Cloud Translation API is not enabled, this option will not appear.

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

15. Click the copy icon and copy the generated API key.

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

16. Return to the BotPenguin Google Translate integration page and paste the API key.
17. Click on **“Add Configuration”** to complete the setup.

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

***

### 🚫 Limitations

* Google Cloud billing is mandatory for API usage
* Translation quality depends on supported language accuracy from Google
* API usage may incur charges based on translation volume
* Real-time translation requires stable internet connectivity
* API quotas and rate limits are controlled by Google Cloud

***

### Best Practices

> 💡 Always test the integration with sample multilingual chats before going live

> ⚠️ Restrict the API key specifically to Cloud Translation API for better security

> 🚀 Monitor Google Cloud billing and API usage regularly

> 🎯 Avoid sharing API keys publicly or inside screenshots

***

### Troubleshooting

<details>

<summary><strong>Issue:</strong> Google Translate option not appearing inside integrations</summary>

#### Solution

* Refresh the integrations page
* Verify that your account has the required permissions
* Ensure the integration module is enabled on the panel

</details>

<details>

<summary><strong>Issue:</strong> API key validation failed</summary>

#### Solution

* Ensure the Cloud Translation API is enabled
* Verify billing is active on the Google Cloud project
* Confirm the correct API key has been copied and pasted

</details>

<details>

<summary><strong>Issue:</strong> Translation not working in inbox</summary>

#### Solution

* Verify the correct API key has been added
* Ensure the integration is connected successfully
* Check whether the API key has Cloud Translation API access enabled

</details>

<details>

<summary><strong>Issue:</strong> Cloud Translation API option not visible under API Restrictions</summary>

#### Solution

* Enable the Cloud Translation API first inside Google Cloud Console
* Refresh the credentials page after enabling the API

</details>

***

### FAQs

<details>

<summary>Does this integration require coding?</summary>

No, the integration can be configured directly from the BotPenguin Partner Panel without coding.

</details>

<details>

<summary>Does Google Translate require billing information?</summary>

Yes, Google Cloud requires billing to be enabled before using the Cloud Translation API.

</details>

<details>

<summary>Can I create multiple translation configurations?</summary>

Yes, multiple configurations can be added from the integrations section.

</details>

<details>

<summary>Is translation performed in real time?</summary>

Yes, messages are translated in real time inside the inbox experience.

</details>

<details>

<summary>Can I restrict the API key for security?</summary>

Yes, it is recommended to restrict the API key specifically to the Cloud Translation API.

</details>

***

### Support

Please feel free to reach out to us at <mark style="color:$primary;"><support@botpenguin.com></mark>, in case of any questions or concerns.

***

🎉 Congratulations, you have successfully set up the Google Translate integration! You can now enable real-time multilingual communication inside BotPenguin inbox conversations.


---

# 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-google-translation.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.