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

# Odoo Helpdesk

> Integrate with Odoo Helpdesk to automatically create and manage tickets from Wirespeed cases and detections

## Prerequisites

Before connecting Wirespeed to Odoo Helpdesk, ensure the following:

* Your Odoo instance is running **Odoo 19 or later** — the JSON-2 API required by this integration is only available in v19+.
* The **Helpdesk** app is installed in your Odoo instance.
* **Odoo SaaS (odoo.com) only** — the integration currently accepts instance hostnames under `*.odoo.com` (for example `yourcompany.odoo.com`). **Self-hosted Odoo** on a custom domain or hostname is **not supported** at this time.

## Generate an API Key

1. Log in to your **Odoo** instance
2. Click your profile avatar in the top-right corner and select **My Preferences**
3. Go to **Account Security** → **API Keys**
4. Click **New API Key**
5. Enter a description (e.g., `Wirespeed Integration`) and set the key duration to **1 Year** to prevent unexpected authentication failures due to key expiration
6. Click **Generate Key**
7. Copy the generated key immediately — it will not be shown again

## Connect Wirespeed to Odoo Helpdesk

1. Log in to **Wirespeed**
2. Navigate to **Integrations** → **Add Integration**
3. Select **Odoo Helpdesk** and click **Integrate**
4. Fill in the following fields:
   * **Odoo Instance URL** — the hostname of your Odoo SaaS instance (e.g. `yourcompany.odoo.com`). Must be an `*.odoo.com` hostname; self-hosted instances are not supported yet.
   * **API Key** — the key generated in the previous step
5. Click **Save**

Wirespeed will verify the API key and confirm the Odoo version is 19+. If either check fails, the integration will not be enabled.

## Configure Ticket Behavior

After enabling the integration, click **Configure** to set ticket creation preferences. Fields are dependent — select **Database** first, then optionally **Company** to filter the team list, then **Helpdesk Team**.

| Setting                                      | Description                                                                                                                                                                                                     |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Database**                                 | The Odoo database to use for all API operations (required)                                                                                                                                                      |
| **Company**                                  | Optionally filter Helpdesk teams by Odoo company. Defaults to Any.                                                                                                                                              |
| **Helpdesk Team**                            | Odoo Helpdesk team to assign new tickets to (required)                                                                                                                                                          |
| **Stage Mapping**                            | Maps each Wirespeed case status to an Odoo Helpdesk stage. Wirespeed will attempt to auto-populate this using Odoo's default stage names (New, In Progress, Solved). All statuses must be mapped before saving. |
| **Create Tickets for Standalone Detections** | When enabled, tickets are created for detections that are closed and not part of a case                                                                                                                         |
| **Case Ticket Title Template**               | Title template for case tickets. Supports variables like `` `sid` `` and `` `title` ``                                                                                                                          |
| **Detection Ticket Title Template**          | Title template for detection tickets. Only shown when **Create Tickets for Standalone Detections** is enabled. Supports variables like `` `sid` `` and `` `title` ``                                            |

Click **Save** when done. The Save button is disabled until all required fields are filled and all Wirespeed statuses have a stage mapped.

## How It Works

* When a Wirespeed case is escalated, a Helpdesk ticket is created in Odoo with priority mapped from severity (Critical → Urgent, High → High, Medium → Normal, Low/Info → Low).
* When a case status changes, the Odoo ticket is moved to the corresponding stage based on your configured Stage Mapping.
* When a detection is added to a case, a comment is posted on the associated Odoo ticket.
* When a Wirespeed case is closed, the ticket stage is updated to the mapped Closed stage and a comment is posted noting the closure.
* Ticket title templates support dynamic variables using backtick syntax (e.g. `` `sid` ``, `` `title` ``, `` `severity` ``).