> 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/bots/website-mobile-app-bot/3rd-party-integrations/botpenguin-integrations/integrate-botpenguin-with-odoo.md).

# Integrate BotPenguin with Odoo

### What is Odoo Integration?

Odoo integration allows you to connect BotPenguin with your Odoo account. It enables seamless data exchange between systems, allowing you to synchronize customer data, automate workflows, and leverage your CRM information directly within BotPenguin for enhanced customer interactions.

***

### When should you use this?

Use this integration when:

* You want to connect BotPenguin with your Odoo CRM system
* You need to synchronize customer data and business information across platforms
* You are trying to enable automated workflows based on Odoo customer records

***

### Benefits of Odoo Integration

* 🔗 Enables seamless data synchronization between BotPenguin and Odoo
* ⚡ Automates customer data workflows and reduces manual effort
* 🎯 Improves operational efficiency with unified customer information
* 🔄 Ensures real-time updates across your CRM and automation platform
* 📈 Enhances overall business productivity through integrated automation

***

### Expected Outcome

After setting this up:

* Your Odoo account will be successfully connected to BotPenguin
* Customer data will flow seamlessly between Odoo ↔ BotPenguin
* You will be able to automate workflows based on your Odoo customer records and business data

{% hint style="info" icon="lightbulb" %}
**Tip**: Test the integration with sample customer data after setup to ensure everything is working correctly.
{% endhint %}

***

### 🔐 Prerequisites

Before setting up this integration, ensure you have:

* An active Odoo account with **Administrator access**
* Access to your **BotPenguin account**
* Permission to enable **Developer Mode** in Odoo
* An **API Key** generated from your Odoo account

{% hint style="warning" icon="triangle-exclamation" %}
Missing prerequisites may result in failed connections or limited functionality.
{% endhint %}

***

### How to Connect Odoo with BotPenguin

#### Step 1: Open the Odoo Integration in BotPenguin

1. Log in to your BotPenguin account.
2. Open the bot you want to connect with Odoo.

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

3. Navigate to **"Third-Party Integrations"**.

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

4. Select **"Odoo"** from the available integrations.

<figure><img src="/files/8ZpWFI0R6hdkmsKtZoeh" alt=""><figcaption></figcaption></figure>

5. Click on Connect

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

6. You will now see the following fields that need to be configured:
   1. Odoo URL
   2. Database Name
   3. Email
   4. API Key

***

#### Step 2: Enter the Odoo URL

The Odoo URL is your Odoo instance URL.

**How to find it:**

1. Open your Odoo account in your web browser.
2. Copy the URL from the browser's address bar. Example:

```
https://yourcompany.odoo.com
```

3. Paste this URL into the **"Odoo URL"** field in BotPenguin.

{% hint style="warning" icon="triangle-exclamation" %}
**Note**: Only copy your Odoo domain URL. Do not include any additional pages or parameters.
{% endhint %}

***

#### Step 3: Find the Database Name

In most cases, your Database Name is the same as your Odoo domain name. To verify your database name:

1. In Odoo, click on your Profile (top-right corner).
2. Select "My Databases".
3. Locate and copy the Database Name.
4. Paste it into the "Database Name" field in BotPenguin.

{% hint style="warning" icon="triangle-exclamation" %}
**Note**: If you're unsure, always use the database name displayed under **"My Databases"**.
{% endhint %}

***

#### Step 4: Enter Your Email Address

1. Enter the email address associated with your Odoo account.

{% hint style="info" icon="lightbulb" %}
**Tip**: This should be the same email you use to log in to Odoo.
{% endhint %}

***

#### Step 5: Generate an API Key in Odoo

To connect Odoo with BotPenguin, you'll need to generate an API Key.

**Enable Developer Mode**

1. In Odoo, navigate to "Settings".
2. Open "General Settings".
3. Enable "Developer Mode".
4. Click "Save".

**Generate the API Key**

1. Click your Profile icon in the top-right corner.
2. Select "My Preferences".
3. In the pop-up window, navigate to the "Security" tab.
4. Click "Add API Key".
5. Enter a name for the API key (e.g., "BotPenguin Integration").
6. Choose the desired validity period.
7. Click "Generate".
8. Copy the generated API key immediately.

{% hint style="warning" icon="triangle-exclamation" %}
**Important**: The API key is displayed only once. Make sure to copy and store it securely before closing the window.
{% endhint %}

***

#### Step 6: Connect Odoo with BotPenguin

1. Return to the Odoo Integration page in BotPenguin.
2. Paste the copied API key into the "API Key" field.
3. Verify that all four fields are correctly filled:
   1. Odoo URL
   2. Database Name
   3. Email
   4. API Key
4. Click **"Connect"**.

If the provided credentials are correct, your Odoo account will be successfully connected to BotPenguin.

***

#### Step 7: Map the Required Parameters

After the connection is established:

1. Stay on the **Third-Party Integrations > Odoo** page.
2. Map the required parameters according to your business requirements.
3. Click **"Update"** to save the configuration.

Your Odoo integration is now ready to use!

***

### 🔄 How Data Flows

**BotPenguin sends:** Customer inquiry data, form submissions, and user interactions **Odoo processes and returns:** Customer records, business data, and automation triggers **Actions are triggered based on:** Customer data updates, CRM events, and integration rules

{% hint style="info" icon="lightbulb" %}
Keep this simple but clear. This is critical for understanding behavior.
{% endhint %}

***

### ⚙️ Configuration Options

* **Odoo URL:** Your Odoo instance domain (e.g., <https://yourcompany.odoo.com>.
* **Database Name:** The database name from your Odoo account (found in My Databases)
* **Email:** The email address associated with your Odoo administrator account
* **API Key:** The security token generated from Odoo's Security settings

***

### 🚫 Limitations

* API Key generation requires **Developer Mode** to be enabled in Odoo
* API Keys expire based on the selected validity period during generation
* Only supports **Administrator-level** Odoo accounts for integration setup
* Data synchronization speed depends on Odoo's API response times and network connectivity

***

### Best Practices

> 💡 Always test the integration with sample customer data before going live with production workflows

> ⚠️ Ensure Administrator access and correct permissions are granted during authentication

> 🚀 Store your API key securely and never share it with unauthorized users

> 🎯 Monitor integration logs for errors and regularly validate data synchronization

> 📋 Keep your Odoo URL and Database Name documentation saved for future reference

***

### Troubleshooting

<details>

<summary><strong>Unable to connect to Odoo</strong></summary>

**Solution:**

* Verify that the **Odoo URL** is correct and matches your Odoo instance domain.
* Ensure the **Database Name** matches the one listed under **My Databases** in your Odoo account.
* Confirm that you're using the correct Odoo account email address.
* Generate a new **API Key** if the current one has expired or was copied incorrectly.

</details>

<details>

<summary><strong>API Key not working</strong></summary>

**Solution:**

* Make sure **Developer Mode** is enabled before generating the API key.
* Verify that the API key has not expired based on the selected validity period.
* Generate a new API key if necessary and update it in BotPenguin.
* Ensure the complete API key was copied without any missing characters or extra spaces.

</details>

<details>

<summary><strong>Database Name not found</strong></summary>

**Solution:**

* Navigate to **Profile → My Databases** in your Odoo account.
* Verify that you're using the correct database name.
* If multiple databases exist, choose the one you want to integrate.
* Contact your Odoo administrator if you're unsure which database should be used.

</details>

<details>

<summary><strong>Integration is connected but data is not syncing</strong></summary>

**Solution:**

* Verify that your parameter mapping is configured correctly.
* Confirm that the **Odoo URL**, **Database Name**, **Email**, and **API Key** are all accurate.
* Check whether the API key has expired.
* Disconnect and reconnect the integration if the issue persists.

</details>

***

## FAQs

<details>

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

No. The Odoo integration can be configured using BotPenguin's no-code interface. However, you must generate an API key from your Odoo account, which requires Administrator access.

</details>

<details>

<summary><strong>What authentication method is used?</strong></summary>

The integration uses **API key-based authentication**. You'll need to provide:

* Odoo URL
* Database Name
* Email Address
* API Key

These credentials are used to securely authenticate with your Odoo instance.

</details>

<details>

<summary><strong>Can I reconnect the integration?</strong></summary>

Yes. You can disconnect and reconnect the integration at any time from the **Third-Party Integrations** panel by selecting **Disconnect** and completing the setup process again.

</details>

<details>

<summary><strong>Is real-time data synchronization supported?</strong></summary>

The integration supports near-real-time synchronization based on Odoo's API response times and your network connectivity. Data is exchanged as quickly as the APIs process requests.

</details>

<details>

<summary><strong>What happens if the integration fails?</strong></summary>

If the integration fails:

* Data synchronization will stop.
* Existing data remains unchanged.
* Resolve the issue using the troubleshooting steps.
* Once the connection is restored, synchronization will resume.

</details>

<details>

<summary><strong>How often is my API key validated?</strong></summary>

Your API key is validated whenever BotPenguin communicates with Odoo. If the key expires or is revoked, the integration will stop working until a new API key is provided.

</details>

<details>

<summary><strong>Can I connect multiple Odoo accounts to BotPenguin?</strong></summary>

Each bot can be connected to one Odoo account at a time. To use another account, disconnect the existing integration and reconnect using the new account's credentials.

</details>

<details>

<summary><strong>What if I forgot to copy my API key?</strong></summary>

Odoo does not allow previously generated API keys to be viewed again. If you didn't save the key, you'll need to generate a new one from:

**My Preferences → Security → API Keys**

Then update the new key in BotPenguin.

</details>

<details>

<summary><strong>Do I need to keep Developer Mode enabled?</strong></summary>

Developer Mode is only required to generate API keys. After the API key has been created and saved, the integration continues to work even if Developer Mode is disabled.

</details>

<details>

<summary><strong>What permissions do I need in Odoo to set up this integration?</strong></summary>

You need sufficient permissions to:

* Access **My Preferences**
* Generate **API Keys**
* Access the target database

In most organizations, Administrator-level access is required.

</details>

***

### Related Articles

{% content-ref url="/pages/coNSd8CVYr0DipaFDs6d" %}
[Website](/bots/website-mobile-app-bot/train-your-ai-chatbot/website.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZOWdzzbfimFouHgzbb9Q" %}
[3rd party Integrations](/bots/website-mobile-app-bot/3rd-party-integrations.md)
{% endcontent-ref %}

***

### Support

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