Tell us how we can improve docs for you.
BotPenguin updates
Ctrlk
What's NewGo to dashboard
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrate BotPenguin with Odoo

This section contains essential information and usage guidelines for integrating Odoo with BotPenguin.

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

lightbulb

Tip: Test the integration with sample customer data after setup to ensure everything is working correctly.

🔐 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

Missing prerequisites may result in failed connections or limited functionality.

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.

  1. Navigate to "Third-Party Integrations".

  1. Select "Odoo" from the available integrations.

  1. Click on Connect

  1. 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:

  1. Paste this URL into the "Odoo URL" field in BotPenguin.

Note: Only copy your Odoo domain URL. Do not include any additional pages or parameters.

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.

Note: If you're unsure, always use the database name displayed under "My Databases".

Step 4: Enter Your Email Address

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

lightbulb

Tip: This should be the same email you use to log in to Odoo.

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.

Important: The API key is displayed only once. Make sure to copy and store it securely before closing the window.

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

lightbulb

Keep this simple but clear. This is critical for understanding behavior.

⚙️ 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

Unable to connect to Odoo

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.

API Key not working

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.

Database Name not found

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.

Integration is connected but data is not syncing

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.

FAQs

Does this integration require coding?

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.

What authentication method is used?

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.

Can I reconnect the integration?

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.

Is real-time data synchronization supported?

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.

What happens if the integration fails?

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.

How often is my API key validated?

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.

Can I connect multiple Odoo accounts to BotPenguin?

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.

What if I forgot to copy my API key?

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.

Do I need to keep Developer Mode enabled?

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.

What permissions do I need in Odoo to set up this integration?

You need sufficient permissions to:

  • Access My Preferences

  • Generate API Keys

  • Access the target database

In most organizations, Administrator-level access is required.

Related Articles

Website3rd party Integrations

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.

PreviousIntegrate BotPenguin with Facebook PixelsNextIntegrate BotPenguin with Elevio CRM

Last updated

Was this helpful?