> ## 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

> Integre con Odoo Helpdesk para crear y gestionar automáticamente tickets a partir de casos y detecciones de Wirespeed

## Requisitos previos

Antes de conectar Wirespeed a Odoo Helpdesk, asegúrese de lo siguiente:

* Su instancia de Odoo ejecuta **Odoo 19 o posterior** — la API JSON-2 que requiere esta integración solo está disponible en la v19+.
* La aplicación **Helpdesk** está instalada en su instancia de Odoo.
* **Solo Odoo SaaS (odoo.com)** — la integración acepta actualmente nombres de host de instancia bajo `*.odoo.com` (por ejemplo, `yourcompany.odoo.com`). **Odoo autoalojado** en un dominio o nombre de host personalizado **no es compatible** en este momento.

## Generar una clave API

1. Inicie sesión en su instancia de **Odoo**
2. Haga clic en el avatar de su perfil en la esquina superior derecha y seleccione **My Preferences**
3. Vaya a **Account Security** → **API Keys**
4. Haga clic en **New API Key**
5. Introduzca una descripción (p. ej., `Wirespeed Integration`) y establezca la duración de la clave en **1 Year** para evitar fallos de autenticación inesperados por caducidad de la clave
6. Haga clic en **Generate Key**
7. Copie la clave generada de inmediato — no se volverá a mostrar

## Conectar Wirespeed a Odoo Helpdesk

1. Inicie sesión en **Wirespeed**
2. Vaya a **Integraciones** → **Añadir integración**
3. Seleccione **Odoo Helpdesk** y haga clic en **Integrar**
4. Rellene los campos siguientes:
   * **URL de la instancia de Odoo** — el nombre de host de su instancia SaaS de Odoo (p. ej. `yourcompany.odoo.com`). Debe ser un nombre de host `*.odoo.com`; las instancias autoalojadas aún no son compatibles.
   * **Clave API** — la clave generada en el paso anterior
5. Haga clic en **Guardar**

Wirespeed verificará la clave API y confirmará que la versión de Odoo es 19+. Si alguna comprobación falla, la integración no se habilitará.

## Configurar el comportamiento de los tickets

Tras habilitar la integración, haga clic en **Configurar** para establecer las preferencias de creación de tickets. Los campos son dependientes: seleccione primero **Base de datos**, luego opcionalmente **Empresa** para filtrar la lista de equipos y, a continuación, **Equipo de Helpdesk**.

| Configuración | Descripción |
| - | - |
| **Base de datos** | La base de datos de Odoo que se usará para todas las operaciones de API (obligatorio) |
| **Empresa** | Filtra opcionalmente los equipos de Helpdesk por empresa de Odoo. El valor predeterminado es Any. |
| **Equipo de Helpdesk** | Equipo de Odoo Helpdesk al que asignar los tickets nuevos (obligatorio) |
| **Asignación de etapas** | Asigna cada estado de caso de Wirespeed a una etapa de Odoo Helpdesk. Wirespeed intentará autocompletarlo con los nombres de etapa predeterminados de Odoo (New, In Progress, Solved). Todos los estados deben estar asignados antes de guardar. |
| **Crear tickets para detecciones independientes** | Cuando está habilitado, se crean tickets para detecciones que están cerradas y no forman parte de un caso |
| **Plantilla del título del ticket de caso** | Plantilla de título para tickets de caso. Admite variables como `` `sid` `` y `` `title` `` |
| **Plantilla del título del ticket de detección** | Plantilla de título para tickets de detección. Solo se muestra cuando **Crear tickets para detecciones independientes** está habilitado. Admite variables como `` `sid` `` y `` `title` `` |

Haga clic en **Guardar** cuando haya terminado. El botón Guardar está deshabilitado hasta que se rellenen todos los campos obligatorios y todos los estados de Wirespeed tengan una etapa asignada.

## Cómo funciona

* Cuando se escala un caso de Wirespeed, se crea un ticket de Helpdesk en Odoo con la prioridad asignada a partir de la gravedad (Critical → Urgent, High → High, Medium → Normal, Low/Info → Low).
* Cuando cambia el estado de un caso, el ticket de Odoo se mueve a la etapa correspondiente según su Stage Mapping configurado.
* Cuando se añade una detección a un caso, se publica un comentario en el ticket de Odoo asociado.
* Cuando se cierra un caso de Wirespeed, la etapa del ticket se actualiza a la etapa Closed asignada y se publica un comentario indicando el cierre.
* Las plantillas de título de ticket admiten variables dinámicas con sintaxis de acento grave (p. ej. `` `sid` ``, `` `title` ``, `` `severity` ``).


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