> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Escalate AI agent conversations to Odoo Helpdesk

> Connect Odoo so your AI agent can escalate a conversation by opening a ticket in Odoo Helpdesk

The Chatbase Odoo integration lets your AI agent open an Odoo Helpdesk ticket when a customer needs a person, with an AI-written summary of the conversation and a link back to the full chat in Chatbase. It's for teams that run support in the Odoo Helpdesk app and want the AI agent to handle routine questions first. It works with any Odoo instance that has Helpdesk installed and is reachable from the internet, and tickets can be created from any channel where the [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) Action runs, such as the Chat Bubble, Help Page, WhatsApp, Messenger, Instagram, and email.

> [card] What you can do:
>
> Let the AI resolve routine questions on its own, and hand off to Odoo Helpdesk the moment a case needs a person, with the full context already attached.

## Before you start

* A Chatbase account on the **Basic** plan or higher. Odoo isn't available on HIPAA-compliant accounts.
* A Chatbase AI agent. The connection is per AI agent, and each AI agent can connect one Odoo instance.
* An Odoo instance with the **Helpdesk** app installed, at a public URL. Self-hosted instances must be reachable from the internet.
* An Odoo user with access to Helpdesk, and an API key for that user.

## How to connect Odoo

**1. Open your Chatbase AI agent**

Log in to your [Chatbase dashboard](https://www.chatbase.co/dashboard/) and select the AI agent you want to connect.

**2. Create an Odoo API key**

In Odoo, generate an API key under **Settings > Users > Preferences > Account Security > API Keys**. Create it for the user Chatbase will act as.

**3. Connect Odoo**

Choose **Integrations**, then click **Connect** under Odoo and fill in the four fields:

* **Odoo URL:** your instance's public address, such as `https://yourcompany.odoo.com`.
* **Database Name:** the name of your Odoo database.
* **Username:** the Odoo user's login, such as `user@yourcompany.com`.
* **API Key:** the key you created in the previous step.

Chatbase checks the credentials and that the user can access Odoo Helpdesk before saving the connection.

**4. Create the Escalations Action**

Go to **Build > Actions > Create Action**, select **Create ticket** under **Escalations**, and choose **Odoo** as the **Ticket Platform**. Odoo has no extra options on the Action. Follow the [Escalations Action guide](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) for the rest of the setup.

> [!TIP]
>
> Test the integration by asking your AI agent to speak to a human, and confirm a ticket appears in Odoo with the conversation summary attached.

## What the ticket contains

Each Odoo Helpdesk ticket Chatbase creates has:

* **Subject:** written by the AI agent from the customer's issue. The customer is never asked for it. If no title is available, the ticket is named "New Ticket".
* **Description:** an AI-written summary of the conversation, in the customer's language.
* **Customer email and name:** the details the AI agent collected.
* **Team:** not set by Chatbase, so Odoo's default applies.
* **Internal note:** a link to the full conversation in Chatbase, posted by the Odoo user you connected with.

Chatbase sets no tags, priority, or custom fields, and doesn't attach files the customer sent in the chat.

### Example

The following exchange is illustrative. A customer on the Chat Bubble writes "The delivery address on my order is wrong, can someone fix it?" The AI agent asks for an email and name, the customer replies "Jane Doe, [jane@example.com](mailto:jane@example.com)", and Odoo Helpdesk receives:

* **Subject:** Wrong delivery address on order
* **Description:** The customer reports that their order has the wrong delivery address and asks for it to be corrected.
* **Customer:** Jane Doe, [jane@example.com](mailto:jane@example.com)
* An internal note with the link to the conversation in Chatbase

## What the customer sees

The AI agent asks for the customer's email and name if it doesn't already have them, creates the ticket, and tells the customer the ticket number. On the Chat Bubble, Help Page, and Center Stage, a **Ticket Created** card also shows the ticket number and the customer's name and email. If creation fails, the card reads **Failed to create ticket**.

Your team works the ticket in Odoo Helpdesk, and replies reach the customer the way Odoo sends them, normally by email. Nothing syncs back to the Chatbase conversation, and the AI agent keeps answering in the chat. Creating a ticket uses no extra message credits beyond the AI agent's normal reply.

## Troubleshooting

> [accordion] "Invalid credentials. Please check your database name, username, and API key."
>
> Odoo rejected the login. Check that the database name matches your instance, that the username is the user's login, and that the API key belongs to that user and hasn't been deleted.

> [accordion] "Invalid Odoo URL. Provide your public Odoo instance URL."
>
> Chatbase only accepts public addresses. Private or internal addresses, such as a local network IP, are rejected. Use the URL your instance has on the internet.

> [accordion] "Failed to connect to Odoo. Please check the URL."
>
> Chatbase couldn't reach the instance. Check the **Odoo URL** for typos and make sure the instance is online and reachable from the internet.

> [accordion] "Could not access Odoo Helpdesk. Install the Helpdesk module and make sure this user has access to it, then try again."
>
> The Helpdesk app isn't installed, or the user you connected with can't access it. Install Helpdesk in Odoo, give the user access, and connect again.

> [accordion] Tickets stopped being created, but the card still says Connected
>
> The card shows **Connected** as long as a saved connection exists, even if Odoo no longer accepts it (for example, after the API key was deleted). Tickets then fail, the customer sees **Failed to create ticket**, and nobody is notified. Open the conversation in [Activity](https://chatbase.co/docs/user-guides/chatbot/activity.md#conversations) and check the **Create ticket** Action's **Result** for the error, then disconnect and connect again with a current API key.

## Frequently asked questions

> [accordion] Does Odoo need the Helpdesk app?
>
> Yes. Chatbase creates tickets in Odoo Helpdesk, so the app must be installed and the connected user must have access to it.

> [accordion] Can I connect a self-hosted Odoo instance?
>
> Yes, as long as it has a public URL that Chatbase can reach from the internet. Private or internal addresses are rejected.

> [accordion] Which Helpdesk team gets the ticket?
>
> Chatbase doesn't set a team, so Odoo's default applies.

> [accordion] What happens to my Actions if I disconnect Odoo?
>
> Chatbase lists the Odoo **Create ticket** Actions and deletes them when you confirm. Tickets already in Odoo aren't affected.

> [accordion] Can I use Odoo on a HIPAA-compliant account?
>
> No. The Odoo **Connect** button is disabled on HIPAA-compliant accounts. See [HIPAA compliance](https://chatbase.co/docs/user-guides/workspace/hipaa-compliance.md).

## Next steps

> [card] [Escalations Action](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md)
>
> Configure when your AI agent escalates, which details it collects first, and which channels it can escalate from.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.