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

> Integration mit Odoo Helpdesk, um Tickets aus Wirespeed-Fällen und -Detektionen automatisch zu erstellen und zu verwalten

## Voraussetzungen

Stellen Sie vor dem Verbinden von Wirespeed mit Odoo Helpdesk Folgendes sicher:

* Auf Ihrer Odoo-Instanz läuft **Odoo 19 oder neuer** – die für diese Integration erforderliche JSON-2-API ist erst ab v19 verfügbar.
* Die App **Helpdesk** ist in Ihrer Odoo-Instanz installiert.
* **Nur Odoo SaaS (odoo.com)** – die Integration akzeptiert derzeit nur Instanz-Hostnamen unter `*.odoo.com` (zum Beispiel `yourcompany.odoo.com`). **Selbst gehostetes Odoo** auf einer eigenen Domain oder einem eigenen Hostnamen wird derzeit **nicht unterstützt**.

## API-Schlüssel generieren

1. Melden Sie sich bei Ihrer **Odoo**-Instanz an
2. Klicken Sie oben rechts auf Ihren Profil-Avatar und wählen Sie **My Preferences** aus
3. Gehen Sie zu **Account Security** → **API Keys**
4. Klicken Sie auf **New API Key**
5. Geben Sie eine Beschreibung ein (z. B. `Wirespeed Integration`) und setzen Sie die Gültigkeitsdauer des Schlüssels auf **1 Year**, um unerwartete Authentifizierungsfehler durch einen abgelaufenen Schlüssel zu vermeiden
6. Klicken Sie auf **Generate Key**
7. Kopieren Sie den generierten Schlüssel sofort – er wird nicht erneut angezeigt

## Wirespeed mit Odoo Helpdesk verbinden

1. Melden Sie sich bei **Wirespeed** an
2. Navigieren Sie zu **Integrationen** → **Integration hinzufügen**
3. Wählen Sie **Odoo Helpdesk** aus und klicken Sie auf **Integrieren**
4. Füllen Sie die folgenden Felder aus:
   * **Odoo-Instanz-URL** – der Hostname Ihrer Odoo-SaaS-Instanz (z. B. `yourcompany.odoo.com`). Es muss sich um einen `*.odoo.com`-Hostnamen handeln; selbst gehostete Instanzen werden noch nicht unterstützt.
   * **API-Schlüssel** – der im vorherigen Schritt generierte Schlüssel
5. Klicken Sie auf **Speichern**

Wirespeed überprüft den API-Schlüssel und bestätigt, dass die Odoo-Version 19 oder höher ist. Schlägt eine der beiden Prüfungen fehl, wird die Integration nicht aktiviert.

## Ticketverhalten konfigurieren

Klicken Sie nach dem Aktivieren der Integration auf **Konfigurieren**, um die Einstellungen für die Ticketerstellung festzulegen. Die Felder hängen voneinander ab – wählen Sie zuerst **Datenbank** aus, dann optional **Unternehmen**, um die Teamliste zu filtern, und anschließend **Helpdesk-Team**.

| Einstellung | Beschreibung |
| - | - |
| **Datenbank** | Die Odoo-Datenbank, die für alle API-Vorgänge verwendet wird (erforderlich) |
| **Unternehmen** | Filtert Helpdesk-Teams optional nach Odoo-Unternehmen. Standardwert ist „Beliebig“. |
| **Helpdesk-Team** | Odoo-Helpdesk-Team, dem neue Tickets zugewiesen werden (erforderlich) |
| **Phasenzuordnung** | Ordnet jeden Wirespeed-Fallstatus einer Odoo-Helpdesk-Phase zu. Wirespeed versucht, dies anhand der Standard-Phasennamen von Odoo (New, In Progress, Solved) automatisch auszufüllen. Vor dem Speichern müssen alle Status zugeordnet sein. |
| **Tickets für eigenständige Detektionen erstellen** | Wenn aktiviert, werden Tickets für Detektionen erstellt, die geschlossen sind und zu keinem Fall gehören |
| **Titelvorlage für Fall-Tickets** | Titelvorlage für Fall-Tickets. Unterstützt Variablen wie `` `sid` `` und `` `title` `` |
| **Titelvorlage für Detektions-Tickets** | Titelvorlage für Detektions-Tickets. Wird nur angezeigt, wenn **Tickets für eigenständige Detektionen erstellen** aktiviert ist. Unterstützt Variablen wie `` `sid` `` und `` `title` `` |

Klicken Sie abschließend auf **Speichern**. Die Schaltfläche „Speichern“ ist deaktiviert, bis alle Pflichtfelder ausgefüllt sind und allen Wirespeed-Status eine Phase zugeordnet ist.

## Funktionsweise

* Wenn ein Wirespeed-Fall eskaliert wird, wird in Odoo ein Helpdesk-Ticket erstellt, dessen Priorität aus dem Schweregrad abgeleitet wird (Kritisch → Urgent, Hoch → High, Mittel → Normal, Niedrig/Informativ → Low).
* Wenn sich der Status eines Falls ändert, wird das Odoo-Ticket gemäß Ihrer konfigurierten Phasenzuordnung in die entsprechende Phase verschoben.
* Wenn eine Detektion zu einem Fall hinzugefügt wird, wird ein Kommentar im zugehörigen Odoo-Ticket veröffentlicht.
* Wenn ein Wirespeed-Fall geschlossen wird, wird die Ticketphase auf die für den geschlossenen Status zugeordnete Phase aktualisiert und ein Kommentar zum Abschluss veröffentlicht.
* Titelvorlagen für Tickets unterstützen dynamische Variablen in Backtick-Syntax (z. B. `` `sid` ``, `` `title` ``, `` `severity` ``).


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