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

> Intégrez Odoo Helpdesk pour créer et gérer automatiquement des tickets à partir des dossiers et détections Wirespeed

## Prérequis

Avant de connecter Wirespeed à Odoo Helpdesk, vérifiez les points suivants :

* Votre instance Odoo exécute **Odoo 19 ou une version ultérieure** : l’API JSON-2 requise par cette intégration n’est disponible qu’à partir de la v19.
* L’application **Helpdesk** est installée sur votre instance Odoo.
* **Odoo SaaS (odoo.com) uniquement** : l’intégration n’accepte actuellement que les noms d’hôte d’instance sous `*.odoo.com` (par exemple `yourcompany.odoo.com`). **Odoo auto-hébergé** sur un domaine ou un nom d’hôte personnalisé n’est **pas pris en charge** pour le moment.

## Générer une clé API

1. Connectez-vous à votre instance **Odoo**
2. Cliquez sur l’avatar de votre profil en haut à droite et sélectionnez **My Preferences**
3. Accédez à **Account Security** → **API Keys**
4. Cliquez sur **New API Key**
5. Saisissez une description (par exemple `Wirespeed Integration`) et définissez la durée de validité de la clé sur **1 Year** afin d’éviter des échecs d’authentification inattendus dus à l’expiration de la clé
6. Cliquez sur **Generate Key**
7. Copiez immédiatement la clé générée : elle ne sera plus affichée

## Connecter Wirespeed à Odoo Helpdesk

1. Connectez-vous à **Wirespeed**
2. Accédez à **Intégrations** → **Ajouter une intégration**
3. Sélectionnez **Odoo Helpdesk** et cliquez sur **Intégrer**
4. Renseignez les champs suivants :
   * **URL de l’instance Odoo** : le nom d’hôte de votre instance Odoo SaaS (par exemple `yourcompany.odoo.com`). Il doit s’agir d’un nom d’hôte `*.odoo.com` ; les instances auto-hébergées ne sont pas encore prises en charge.
   * **Clé API** : la clé générée à l’étape précédente
5. Cliquez sur **Enregistrer**

Wirespeed vérifie la clé API et confirme que la version d’Odoo est 19 ou ultérieure. Si l’une de ces vérifications échoue, l’intégration ne sera pas activée.

## Configurer le comportement des tickets

Après avoir activé l’intégration, cliquez sur **Configurer** pour définir vos préférences de création de tickets. Les champs sont interdépendants : sélectionnez d’abord **Base de données**, puis éventuellement **Société** pour filtrer la liste des équipes, puis **Équipe Helpdesk**.

| Paramètre | Description |
| - | - |
| **Base de données** | La base de données Odoo à utiliser pour toutes les opérations d’API (obligatoire) |
| **Société** | Filtre facultatif des équipes Helpdesk par société Odoo. Valeur par défaut : Any. |
| **Équipe Helpdesk** | L’équipe Odoo Helpdesk à laquelle attribuer les nouveaux tickets (obligatoire) |
| **Correspondance des étapes** | Associe chaque statut de dossier Wirespeed à une étape Odoo Helpdesk. Wirespeed tente de la préremplir à l’aide des noms d’étapes par défaut d’Odoo (New, In Progress, Solved). Tous les statuts doivent être associés avant l’enregistrement. |
| **Créer des tickets pour les détections autonomes** | Lorsque cette option est activée, des tickets sont créés pour les détections clôturées qui ne font partie d’aucun dossier |
| **Modèle de titre des tickets de dossier** | Modèle de titre des tickets de dossier. Prend en charge des variables comme `` `sid` `` et `` `title` `` |
| **Modèle de titre des tickets de détection** | Modèle de titre des tickets de détection. Affiché uniquement lorsque **Créer des tickets pour les détections autonomes** est activé. Prend en charge des variables comme `` `sid` `` et `` `title` `` |

Cliquez sur **Enregistrer** lorsque vous avez terminé. Le bouton Enregistrer reste désactivé tant que tous les champs obligatoires ne sont pas renseignés et que chaque statut Wirespeed n’est pas associé à une étape.

## Fonctionnement

* Lorsqu’un dossier Wirespeed est escaladé, un ticket Helpdesk est créé dans Odoo avec une priorité déterminée à partir de la gravité (Critique → Urgent, Élevée → High, Moyenne → Normal, Faible/Information → Low).
* Lorsque le statut d’un dossier change, le ticket Odoo est déplacé vers l’étape correspondante selon la correspondance des étapes que vous avez configurée.
* Lorsqu’une détection est ajoutée à un dossier, un commentaire est publié sur le ticket Odoo associé.
* Lorsqu’un dossier Wirespeed est clôturé, l’étape du ticket est mise à jour vers l’étape de clôture associée et un commentaire signalant la clôture est publié.
* Les modèles de titre des tickets prennent en charge des variables dynamiques avec la syntaxe à accents graves (par exemple `` `sid` ``, `` `title` ``, `` `severity` ``).


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