# Odoo Verbinden Sie einen Odoo-Server, damit der Agent Kontakte anhand der Telefonnummer findet und Bestellungen anlegt > Full REST + WebSocket API reference: https://api.happ.tools/reference Odoo wird mit Ihren Serverdaten und einem Benutzer-Login verbunden — Happ meldet sich direkt bei Ihrer Odoo-Instanz an, daher funktioniert die Integration mit Odoo Online ebenso wie mit selbst gehosteten Instanzen. Danach findet der Agent Kontakte anhand der Telefonnummer und legt Bestellungen direkt aus dem Chat an. ## Bevor Sie beginnen [#before-you-start] * **Odoo-Instanz**, die über das Internet erreichbar ist — Odoo Online (`mycompany.odoo.com`) oder Ihr eigener Server. * **Server-URL, Datenbankname und ein Benutzer-Login** mit der Berechtigung, Kontakte zu lesen und Bestellungen anzulegen. * **Passwort oder API-Schlüssel** dieses Benutzers (siehe unten — ein API-Schlüssel ist die sicherere Variante). * **HAPP-Workspace** mit mindestens einem Agenten, der für Kundengespräche eingerichtet ist. ## API-Schlüssel erstellen [#get-an-api-key] Sie können sich mit dem normalen Passwort des Benutzers verbinden, ein API-Schlüssel ist aber sicherer: Er gilt nur für eine Integration, und Sie können ihn widerrufen, ohne das Kontopasswort zu ändern. 1. Klicken Sie im Odoo-Dashboard oben rechts auf den **Avatar** und wählen Sie **My Preferences**. 2. Wechseln Sie zum Tab **Security**, klicken Sie auf **Add API Key** und bestätigen Sie mit Ihrem aktuellen Passwort. 3. Geben Sie dem Schlüssel einen Namen (zum Beispiel `Happ`) und **ändern Sie die Gültigkeitsdauer von „1 Day“ auf „1 Year“** — sonst läuft der Schlüssel nach 24 Stunden ab. Klicken Sie auf **Create key** und kopieren Sie ihn. Odoo zeigt den API-Schlüssel nur einmal an. Kopieren Sie ihn, bevor Sie den Dialog schließen — geht er verloren, müssen Sie einen neuen erstellen. Odoo zeigt den erstellten Schlüssel nur einmal an, in einem Dialog, der sich nicht erneut öffnen lässt ## Verbinden [#connect] 1. Öffnen Sie in HAPP **Integrationen** und suchen Sie Odoo unter **CRM hinzufügen**. 2. Klicken Sie auf **Verbinden** — der Dialog enthält vier Felder. 3. Füllen Sie sie aus und klicken Sie auf **Verbinden**. | Feld | Wert | | ---------- | ------------------------------------------------------------------------- | | Server-URL | Die Adresse Ihrer Instanz, z. B. `https://mycompany.odoo.com` | | Datenbank | Der Name der Datenbank | | Login | Die E-Mail-Adresse des Benutzers | | Passwort | Das Odoo-Passwort des Benutzers **oder** der oben erstellte API-Schlüssel | Odoo erscheint danach unter **Meine Integrationen** als Karte mit den **Kontoinformationen** — Name der Instanz sowie Datum und Uhrzeit der Verbindung. ## Einstellungen [#settings] Klicken Sie auf das Zahnradsymbol der Karte, um festzulegen, was der Agent tun darf. * **Suchen** — der Agent sucht Kontakte anhand der Telefonnummer in der Odoo-Datenbank. * **Erstellen** — der Agent legt Bestellungen an, die mit dem Kontakt verknüpft sind; der Produktname steht in den Notizen. ## Fehlerbehebung [#troubleshooting] | Problem | Ursache | Lösung | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Anmeldung schlägt fehl | Falscher Login, falsches Passwort oder falsche Datenbank | Odoo verlangt, dass alle vier Werte stimmen. Prüfen Sie den Datenbanknamen — eine Instanz kann mehrere Datenbanken enthalten, und der Name stimmt nicht immer mit der Subdomain überein. | | Schlüssel funktioniert nach einem Tag nicht mehr | Der API-Schlüssel wurde mit der Standarddauer „1 Day“ erstellt | Erstellen Sie einen neuen Schlüssel und stellen Sie die Dauer auf **1 Year**. | | 401 bei einem Schlüssel, der bisher funktioniert hat | Ein Admin hat ihn widerrufen, oder das Passwort des Benutzers wurde geändert | Erstellen Sie unter **My Preferences** > **Security** einen neuen API-Schlüssel und verbinden Sie die Integration in HAPP erneut. | | Server nicht erreichbar | Die selbst gehostete Instanz ist nicht öffentlich erreichbar oder wird von einer Firewall blockiert | Die URL muss aus dem Internet per HTTPS erreichbar sein. Wenn Sie nach IP filtern, lassen Sie die ausgehenden IP-Adressen von HAPP zu. | | Bestellungen werden nicht angelegt | Synchronisierung falsch eingerichtet oder fehlende Berechtigungen | Prüfen Sie, ob **Erstellen** in den **Einstellungen** aktiviert ist und ob der Odoo-Benutzer Bestellungen anlegen darf. | Kommen Sie nicht weiter? [Kontaktieren Sie den Support](https://happ.tools/contacts) mit dem Fehlertext, und wir nennen Ihnen die passende Lösung. ## Trennen und erneut verbinden [#disconnect-and-reconnect] **Trennen:** Öffnen Sie **Integrationen** > **Odoo**, klicken Sie neben der verbundenen Instanz auf **Trennen** und bestätigen Sie. Nach dem Trennen gilt: * Neue Bestellungen aus dem Chat werden nicht mehr an Odoo übertragen. * Bestehende Datensätze in Odoo bleiben unverändert. * Der Agent arbeitet im Chat weiter — nur die Synchronisierung mit Odoo wird beendet. * Der API-Schlüssel wird in Odoo **nicht** widerrufen. Widerrufen Sie ihn bei Bedarf dort separat. **Erneut verbinden:** Öffnen Sie **Integrationen** > **Odoo**, klicken Sie auf **Verbinden** und füllen Sie die vier Felder erneut aus. Nach dem erneuten Verbinden bleiben erhalten: die Such- und Erstellungseinstellungen, die Feldzuordnung, die Zuordnung des Agenten zur Instanz und die Analysen der Integration. ## Weiter [#next] * [CRM](/docs/integrations/crm) — alle CRM-Integrationen * [Tools](/docs/agents/tools) — das CRM während des Gesprächs aufrufen * [Integrationen](/docs/integrations) — der vollständige Katalog