> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Odoo Ihre Rezeption kann prüfen, ob ein Anrufer bereits zu Ihren Odoo-Kontakten gehört, und neue Anrufer mit ihren Anliegen als Leads zu Odoo CRM hinzufügen, damit Ihr Vertriebsteam nachfassen kann. Es gibt zwei Verbindungsoptionen: * **[Webhook-Tools](#option-1-webhook-tools-recommended)** rufen die JSON-2-API von Odoo direkt auf – ohne Zapier-Konto und ohne Zapier-Tasks. Sie benötigen Odoo 19 oder höher, Community oder Enterprise, gehostet auf odoo.com, auf Odoo.sh oder auf Ihrem eigenen Server. * **[Zapier](#option-2-zapier)** funktioniert auch mit älteren Odoo-Versionen. Jede Aktion verbraucht jedoch Tasks aus Ihrem Zapier-Plan, und selbst gehostete Datenbanken können nicht durchsucht werden. Verwenden Sie Webhook-Tools, wenn Ihre Datenbank Odoo 19 oder höher nutzt. Die ältere API von Odoo, JSON-RPC, erwartet die Argumente jeder Methode als eine gemischte Werteliste. Webhook-Tools können diese nicht erstellen. Nutzen Sie bei älteren Versionen daher Zapier. > **Note** > > Odoo erlaubt externen Apps nur im Tarif **Custom** den Zugriff auf Ihre Daten. Wenn Ihre Datenbank > bei Odoo im Tarif One App Free oder Standard gehostet wird, prüfen Sie Ihren Tarif, bevor Sie beginnen. ## Option 1: Webhook-Tools (empfohlen) ### Odoo-Version prüfen Ihre Odoo-Version wird unten auf der Seite **Einstellungen** angezeigt. Webhook-Tools benötigen Version 19 oder höher. Bei einer selbst gehosteten Datenbank muss der Server über HTTPS aus dem Internet erreichbar sein. ### Benutzer für Reception.ai erstellen Erstellen Sie unter **Einstellungen** → **Benutzer & Unternehmen** → **Benutzer** einen internen Benutzer für Reception.ai. Gewähren Sie ihm unter **Vertrieb** den Zugriff **Benutzer: Alle Dokumente**, aber keinen Zugriff auf andere Apps, damit der API-Schlüssel nur das ausführen kann, was die Tools benötigen. Mit **Benutzer: Alle Dokumente** kann der Benutzer neue Leads dem von Ihnen ausgewählten Vertriebsmitarbeiter zuweisen. ### API-Schlüssel erstellen API-Schlüssel für Benutzer ohne Administratorrechte gelten höchstens drei Monate. So erhalten Sie einen Schlüssel, der ein Jahr gültig ist: 1. Aktivieren Sie als Administrator den Entwicklermodus und öffnen Sie dann **Einstellungen** → **Benutzer & Unternehmen** → **Gruppen**. 2. Erstellen Sie eine Gruppe mit einem Namen wie `Reception.ai API key`, setzen Sie **Maximale Dauer für API-Schlüssel in Tagen** auf `365` und fügen Sie den Reception.ai-Benutzer hinzu. Melden Sie sich dann als Reception.ai-Benutzer an, öffnen Sie **Einstellungen** → **Kontosicherheit** und wählen Sie **Neuer API-Schlüssel**. Geben Sie ihm einen Namen wie `Reception.ai`, wählen Sie die längste verfügbare Laufzeit und kopieren Sie den Schlüssel sofort: Odoo zeigt ihn nur einmal an. Notieren Sie das Ablaufdatum und ersetzen Sie den Schlüssel vorher. > **Warning** > > Der API-Schlüssel kann alles tun, was der Reception.ai-Benutzer tun kann. Speichern Sie ihn nicht in > geteilten Dokumenten und löschen Sie ihn in Odoo, falls er offengelegt wird. ### IDs des Vertriebsmitarbeiters und Vertriebsteams ermitteln Öffnen Sie den Benutzer des Vertriebsmitarbeiters unter **Einstellungen** → **Benutzer & Unternehmen** → **Benutzer**. Die Zahl am Ende der Seitenadresse ist die Benutzer-ID. Verfahren Sie ebenso für das Vertriebsteam unter **CRM** → **Konfiguration** → **Vertriebsteams**. ### Webhook-Tools erstellen Öffnen Sie für jedes [unten aufgeführte Tool](#find-the-caller) **Integrationen**, wählen Sie **Integration hinzufügen** und dann **Webhook-Tool**. Ersetzen Sie `YOUR_ODOO_ADDRESS` durch die Adresse Ihrer Datenbank, zum Beispiel `mycompany.odoo.com`. Jedes Tool sendet dieselben Request-Header: * `Authorization` (Secret): `Bearer ` gefolgt von Ihrem API-Schlüssel * `X-Odoo-Database` (Wert): Ihr Datenbankname. Nur erforderlich, wenn Ihr eigener Server mehr als eine Datenbank hostet. ### Anrufer finden | Feld | Wert | | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `find_odoo_contact` | | **Beschreibung** | "Den Anrufer anhand seiner E-Mail-Adresse in unseren Kontakten finden oder anhand seines vollständigen Namens, wenn er keine E-Mail-Adresse hat. Vor dem Hinzufügen eines Leads verwenden." | | **Methode** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search` | | **Request-Header** | `Authorization` (Secret): `Bearer ` gefolgt von Ihrem API-Schlüssel `X-Odoo-Database` (Wert): Ihr Datenbankname, nur falls erforderlich | | **Body-Parameter** | `name` (String, erforderlich): "Die E-Mail-Adresse des Anrufers oder sein vollständiger Name, wie er ihn buchstabiert." `operator` (String, fester Wert): `=ilike` `limit` (Ganzzahl, fester Wert): `5` | | **Agenten zuweisen** | **Rezeption** | Der Operator `=ilike` gleicht den vollständigen Namen oder die E-Mail-Adresse ab, ohne Groß- und Kleinschreibung zu berücksichtigen. Eine Suche nach „Jane“ listet daher nicht jede Jane auf. Odoo gibt nur die ID und den Namen jedes Treffers zurück. Die Kontaktsuche von Odoo umfasst keine Telefonnummern. Ihre Rezeption muss daher nach einer E-Mail-Adresse oder einem Namen fragen. ### Anrufer als Lead hinzufügen | Feld | Wert | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `create_odoo_lead` | | **Beschreibung** | "Den Anrufer als Lead zu unserem CRM hinzufügen, wenn er ein Angebot oder einen Rückruf wünscht." | | **Methode** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/crm.lead/create` | | **Request-Header** | `Authorization` (Secret): `Bearer ` gefolgt von Ihrem API-Schlüssel `X-Odoo-Database` (Wert): Ihr Datenbankname, nur falls erforderlich | | **Body-Parameter** | `vals_list` (Objekt, erforderlich), mit den folgenden Feldern | | **Agenten zuweisen** | **Rezeption** | Odoo erwartet die Felder des neuen Leads in einem `vals_list`-Objekt. Wählen Sie für jedes dieser Felder bei `vals_list` **Feld hinzufügen**: * `name` (String, erforderlich, aus dem Gespräch): "Der Titel des Leads, zum Beispiel: Küchenangebot - Jane Doe." * `contact_name` (String, erforderlich, aus dem Gespräch): "Der vollständige Name des Anrufers." * `email_from` (String, aus dem Gespräch): "Die E-Mail-Adresse des Anrufers, falls er sie angegeben hat." * `phone` (String, erforderlich, aus dem Gespräch): "Die Telefonnummer des Anrufers im internationalen Format, zum Beispiel +14155550123." * `description` (String, erforderlich, aus dem Gespräch): "Was der Anrufer benötigt, in wenigen Sätzen." * `user_id` (Ganzzahl, fester Wert): die Benutzer-ID des Vertriebsmitarbeiters * `team_id` (Ganzzahl, fester Wert): die ID des Vertriebsteams Der Vertriebsmitarbeiter und das Team sind feste Werte. Jeder Lead wird ihnen zugewiesen, auch wenn die KI andere IDs sendet. Lassen Sie Felder wie den erwarteten Umsatz aus, damit Ihre Rezeption keine Beträge schätzt. Wählen Sie für jedes Tool **Aktivieren** und [testen Sie Ihre Rezeption](/docs/de/reception-ai/receptionist/testing) zuerst als bestehenden Kontakt, der seine E-Mail-Adresse angibt, und dann als neuer Anrufer, der ein Angebot anfragt. Der neue Lead erscheint in Ihrer Odoo-CRM-Pipeline. ## Option 2: Zapier ### Zapier verbinden Falls noch nicht geschehen, verbinden Sie [Zapier](/docs/de/reception-ai/integrations/zapier) in Reception.ai. ### Odoo-Aktionen hinzufügen Fügen Sie auf Ihrem Zapier-MCP-Server unter [mcp.zapier.com](https://mcp.zapier.com) die [unten aufgeführten Aktionen](#zapier-actions) der App **Odoo CRM** hinzu und melden Sie sich bei Odoo an, wenn Zapier dazu auffordert. Legen Sie für jedes Feld entweder einen festen Wert fest oder lassen Sie es, wie angegeben, von der KI ausfüllen. Die App **Odoo CRM** funktioniert mit Datenbanken, die auf odoo.com gehostet werden. Informationen zu selbst gehosteten Datenbanken finden Sie unter [Einschränkungen](#limitations). Die Aktionen können alles tun, was der Odoo-Benutzer darf, mit dem Sie sich anmelden. Erwägen Sie einen dedizierten Benutzer mit Zugriff nur auf CRM und Kontakte. ### Tools zuweisen Öffnen Sie in Reception.ai den Tab **Tools** der Zapier-Integration, wählen Sie **Tools aktualisieren** und weisen Sie jede Aktion dem **Client** (der Rezeption) zu. ### Testen [Testen Sie Ihre Rezeption](/docs/de/reception-ai/receptionist/testing) zuerst als bestehenden Kontakt, der seine E-Mail-Adresse angibt, und dann als neuer Anrufer, der ein Angebot anfragt. Der neue Lead erscheint in Ihrer Odoo-CRM-Pipeline. ### Zapier-Aktionen #### Anrufer finden | Feld | Wert | | ------------------------------- | ----------------------------------------------------------------------------------------------- | | **Zapier-Aktion** | **Find Contact** | | **In Zapier festlegen** | Nichts. | | **Von der KI ausfüllen lassen** | Die E-Mail-Adresse des Anrufers oder sein vollständiger Name, wenn er keine E-Mail-Adresse hat. | | **Zuweisen an** | **Client** | Die Zapier-App von Odoo findet Kontakte anhand des Namens oder der E-Mail-Adresse, nicht anhand der Telefonnummer. Ihre Rezeption muss daher nach einem dieser Angaben fragen. #### Anrufer als Lead hinzufügen | Feld | Wert | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Zapier-Aktion** | **Create Lead** | | **In Zapier festlegen** | Der Vertriebsmitarbeiter und das Vertriebsteam, denen neue Leads zugewiesen werden, falls Ihr Konto diese Felder anzeigt. | | **Von der KI ausfüllen lassen** | Der Titel des Leads (zum Beispiel „Küchenangebot - Jane Doe“), Name, E-Mail-Adresse und Telefonnummer des Kontakts sowie eine Beschreibung dessen, was der Anrufer benötigt. | | **Zuweisen an** | **Client** | Lassen Sie Felder wie den erwarteten Umsatz leer, damit Ihre Rezeption keine Beträge schätzt. > **Tip** > > Unabhängig von der verwendeten Option sollten Sie eine [Prozedur](/docs/de/reception-ai/receptionist/rules-and-procedures) > hinzufügen, damit Ihre Rezeption nach der E-Mail-Adresse des Anrufers fragt und nach ihm sucht, bevor sie einen > Lead erstellt. > **Warning** > > Die Suche kann Kontakte zurückgeben, die nicht der Anrufer sind, und **Find Contact** in Zapier gibt > alle für den Kontakt gespeicherten Daten zurück. Fügen Sie eine > [Regel](/docs/de/reception-ai/receptionist/rules-and-procedures) hinzu, die Ihrer Rezeption vorgibt, niemals > Kontaktdetails an den Anrufer zurückzugeben und sie nur zur Erkennung des Anrufers zu verwenden. ## Einschränkungen * Ihre Rezeption kann Anrufer nicht anhand der Telefonnummer suchen. Sie benötigt deren E-Mail-Adresse oder exakten Namen. * Die Beschreibung des Leads enthält das Anliegen des Anrufers. Die Zapier-App **Odoo CRM** bietet keine Aktion zum Hinzufügen einer Notiz oder zum Protokollieren eines Anrufs. * Bei Webhook-Tools läuft der API-Schlüssel ab. Ersetzen Sie ihn vor dem Ablaufdatum, sonst funktionieren die Tools nicht mehr. * Bei Zapier benötigt eine selbst gehostete Odoo-Datenbank stattdessen die App **Odoo ERP Self Hosted** von Zapier. Mit deren Aktion **Create Lead/Opportunity** lassen sich Leads hinzufügen, aber es gibt keine Suchaktionen. Ein wiederkehrender Anrufer kann daher zweimal hinzugefügt werden. Webhook-Tools können eine selbst gehostete Datenbank mit Odoo 19 oder höher durchsuchen. * Ihre Rezeption kann Verfügbarkeiten nicht prüfen oder Meetings in Odoo buchen. Verwenden Sie stattdessen die eigene Buchungsfunktion von Reception mit [Google Calendar](/docs/de/reception-ai/integrations/google-calendar). * Bei Zapier verbraucht jede Aktion, die Ihre Rezeption ausführt, Tasks aus Ihrem Zapier-Plan. Zapier zählt derzeit zwei Tasks pro erfolgreichem Aufruf; fehlgeschlagene Aufrufe werden nicht gezählt. Wenn der Plan aufgebraucht ist, werden die Aktionen bis zur Zurücksetzung angehalten. ## Fehlerbehebung | Problem | Prüfen Sie | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 von Odoo | Der Header muss `Authorization` mit `Bearer `, einem Leerzeichen und dem Schlüssel sein. Prüfen Sie, ob der Schlüssel abgelaufen ist oder gelöscht wurde. | | 404 von Odoo | Prüfen Sie die Adresse und ob die URL mit `/json/2/res.partner/name_search` oder `/json/2/crm.lead/create` endet. Ihre Datenbank muss Odoo 19 oder höher verwenden und CRM muss installiert sein. | | Odoo gibt einen Zugriffsfehler zurück | Der Reception.ai-Benutzer benötigt unter **Vertrieb** den Zugriff **Benutzer: Alle Dokumente**. | | Odoo kann die Datenbank nicht finden | Fügen Sie den Header `X-Odoo-Database` mit Ihrem Datenbanknamen hinzu. | | Eine Odoo-Aktion erscheint nicht in Reception.ai | Wählen Sie in der Zapier-Integration **Tools aktualisieren**, nachdem Sie Aktionen in Zapier hinzugefügt haben. | | Eine Aktion zeigt **Geändert** und wird nicht verwendet | Sie haben sie in Zapier bearbeitet. Wählen Sie im Tab **Tools** **Aktualisieren**. | | Zapier kann keine Verbindung zu Odoo herstellen | Prüfen Sie, ob Ihr Odoo-Tarif externe Apps erlaubt und ob Sie die richtige App für den Hosting-Standort Ihrer Datenbank verwenden. | | Bekannte Anrufer werden nicht gefunden | Prüfen Sie die Schreibweise der E-Mail-Adresse mit dem Anrufer. Namenssuchen benötigen den in Odoo gespeicherten Namen. Ein Kontakt, der zu einem Unternehmen gehört, wird als Unternehmensname, Komma und Name der Person gespeichert. | | Leads werden dem falschen Vertriebsmitarbeiter oder Team zugewiesen | Legen Sie den Vertriebsmitarbeiter und das Vertriebsteam im Webhook-Tool oder in Zapier als feste Werte fest. |