> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Odoo

Je receptionist kan controleren of een beller al een van je Odoo-contacten is en nieuwe bellers als leads aan Odoo CRM toevoegen, met wat ze nodig hebben, zodat je salesteam kan opvolgen. Je kunt op twee manieren verbinding maken:

* **[Webhook tools](#option-1-webhook-tools-recommended)** roepen de JSON-2 API van Odoo rechtstreeks aan, zonder Zapier-account en zonder Zapier-taken te gebruiken. Hiervoor heb je Odoo 19 of later nodig, Community of Enterprise, gehost op odoo.com, op Odoo.sh of op je eigen server.
* **[Zapier](#option-2-zapier)** werkt ook met oudere Odoo-versies, maar elke actie gebruikt taken uit je Zapier-abonnement en kan niet in een zelf-gehoste database zoeken.

Gebruik webhook tools als je database op Odoo 19 of later draait. De oudere API van Odoo, JSON-RPC, ontvangt de argumenten van elke methode als één gemengde lijst met waarden, die webhook tools niet kunnen maken. Gebruik daarom Zapier voor oudere versies.

> **Note**
>
> Odoo staat externe apps alleen toe om toegang te krijgen tot je gegevens met het abonnement **Custom**. Als je database
> door Odoo wordt gehost met het abonnement One App Free of Standard, controleer dan eerst je abonnement.

## Optie 1: Webhook tools (aanbevolen)

### Controleer je Odoo-versie

Je Odoo-versie staat onderaan de pagina **Settings**. Webhook tools vereisen versie 19 of later. Voor een zelf-gehoste database moet de server via HTTPS bereikbaar zijn vanaf internet.

### Maak een gebruiker voor Reception.ai

Maak in **Settings** → **Users & Companies** → **Users** een interne gebruiker voor Reception.ai. Geef deze toegang tot **Sales**: **User: All Documents** en geen toegang tot andere apps, zodat de API-sleutel alleen kan doen wat de tools nodig hebben. Met **User: All Documents** kan deze nieuwe leads toewijzen aan de verkoper die je kiest.

### Maak een API-sleutel

API-sleutels voor gebruikers die geen administrator zijn, zijn maximaal drie maanden geldig. Zo krijg je een sleutel die een jaar geldig blijft:

1. Schakel als administrator de ontwikkelaarsmodus in en ga vervolgens naar **Settings** → **Users & Companies** → **Groups**.
2. Maak een groep met bijvoorbeeld de naam `Reception.ai API key`, stel **API Keys maximum duration days** in op `365` en voeg de Reception.ai-gebruiker eraan toe.

Log vervolgens in als de Reception.ai-gebruiker, open **Preferences** → **Account Security** en selecteer **New API Key**. Geef de sleutel bijvoorbeeld de naam `Reception.ai`, kies de langst beschikbare duur en kopieer de sleutel meteen: Odoo toont deze slechts één keer. Noteer de vervaldatum en vervang de sleutel vóór die datum.

> **Warning**
>
> De API-sleutel kan alles doen wat de Reception.ai-gebruiker kan doen. Bewaar deze niet in gedeelde documenten en
> verwijder hem in Odoo als hij uitlekt.

### Zoek de ID's van de verkoper en het salesteam

Open de gebruiker van de verkoper in **Settings** → **Users & Companies** → **Users**. Het nummer aan het einde van het pagina-adres is de gebruikers-ID. Doe hetzelfde voor het salesteam in **CRM** → **Configuration** → **Sales Teams**.

### Maak de webhook tools

Ga voor elke [tool hieronder](#find-the-caller) naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**. Vervang `YOUR_ODOO_ADDRESS` door het adres van je database, bijvoorbeeld `mycompany.odoo.com`.

Elke tool verstuurt dezelfde requestheaders:

* `Authorization` (Secret): `Bearer ` gevolgd door je API-sleutel
* `X-Odoo-Database` (Value): de naam van je database. Alleen nodig als je eigen server meer dan één database host.

### Zoek de beller

| Veld                     | Waarde                                                                                                                                                                                        |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**                 | `find_odoo_contact`                                                                                                                                                                           |
| **Beschrijving**         | "Zoek de beller in onze contacten op e-mailadres, of op volledige naam als die geen e-mailadres heeft. Gebruik dit voordat je een lead toevoegt."                                             |
| **Methode**              | POST                                                                                                                                                                                          |
| **URL**                  | `https://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search`                                                                                                                                    |
| **Requestheaders**       | `Authorization` (Secret): `Bearer ` gevolgd door je API-sleutel  `X-Odoo-Database` (Value): de naam van je database, alleen indien nodig                                                      |
| **Bodyparameters**       | `name` (string, verplicht): "Het e-mailadres van de beller, of de volledige naam zoals die wordt gespeld."  `operator` (string, vaste waarde): `=ilike`  `limit` (integer, vaste waarde): `5` |
| **Toewijzen aan agents** | **Receptionist**                                                                                                                                                                              |

De operator `=ilike` komt overeen met de volledige naam of het volledige e-mailadres, zonder hoofdletters mee te tellen, zodat een zoekopdracht naar "Jane" niet elke Jane weergeeft. Odoo geeft alleen de ID en naam van elke overeenkomst terug. De zoekfunctie voor contacten van Odoo ondersteunt geen telefoonnummers, dus je receptionist moet om een e-mailadres of naam vragen.

### Voeg de beller als lead toe

| Veld                     | Waarde                                                                                                                                   |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**                 | `create_odoo_lead`                                                                                                                       |
| **Beschrijving**         | "Voeg de beller toe aan ons CRM als lead wanneer die een offerte of terugbelverzoek wil."                                                |
| **Methode**              | POST                                                                                                                                     |
| **URL**                  | `https://YOUR_ODOO_ADDRESS/json/2/crm.lead/create`                                                                                       |
| **Requestheaders**       | `Authorization` (Secret): `Bearer ` gevolgd door je API-sleutel  `X-Odoo-Database` (Value): de naam van je database, alleen indien nodig |
| **Bodyparameters**       | `vals_list` (object, verplicht), met de onderstaande velden                                                                              |
| **Toewijzen aan agents** | **Receptionist**                                                                                                                         |

Odoo verwacht de velden van de nieuwe lead in een `vals_list`-object. Selecteer voor elk van deze velden **Add field** bij `vals_list`:

* `name` (string, verplicht, uit het gesprek): "De titel van de lead, bijvoorbeeld: Offerte keuken - Jane Doe."
* `contact_name` (string, verplicht, uit het gesprek): "De volledige naam van de beller."
* `email_from` (string, uit het gesprek): "Het e-mailadres van de beller, als deze het heeft opgegeven."
* `phone` (string, verplicht, uit het gesprek): "Het telefoonnummer van de beller in internationale notatie, bijvoorbeeld +14155550123."
* `description` (string, verplicht, uit het gesprek): "Wat de beller nodig heeft, in een paar zinnen."
* `user_id` (integer, vaste waarde): de gebruikers-ID van de verkoper
* `team_id` (integer, vaste waarde): de ID van het salesteam

De verkoper en het team zijn vaste waarden, dus elke lead wordt aan hen toegewezen, zelfs als de AI andere ID's verstuurt. Laat velden zoals verwachte omzet weg, zodat je receptionist geen bedragen raadt.

Selecteer **Enable** voor elke tool en [test je receptionist](/docs/nl/reception-ai/receptionist/testing) als een bestaand contact dat zijn e-mailadres opgeeft, en vervolgens als een nieuwe beller die om een offerte vraagt. De nieuwe lead verschijnt in je Odoo CRM-pijplijn.

## Optie 2: Zapier

### Verbind Zapier

Als je dat nog niet hebt gedaan, verbind je [Zapier](/docs/nl/reception-ai/integrations/zapier) in Reception.ai.

### Voeg de Odoo-acties toe

Voeg in je Zapier MCP-server op [mcp.zapier.com](https://mcp.zapier.com) de [onderstaande acties](#zapier-actions) uit de app **Odoo CRM** toe en log in bij Odoo wanneer Zapier daarom vraagt. Stel voor elk veld een vaste waarde in of laat de AI het invullen, zoals aangegeven.

De app **Odoo CRM** werkt met databases die op odoo.com worden gehost. Raadpleeg [Beperkingen](#limitations) voor een zelf-gehoste database.

De acties kunnen alles doen wat de Odoo-gebruiker waarmee je inlogt kan doen. Overweeg een aparte gebruiker met toegang tot alleen CRM en contacten.

### Wijs de tools toe

Open in Reception.ai het tabblad **Tools** van de Zapier-integratie, selecteer **Refresh tools** en wijs elke actie toe aan de **Client** (receptionist).

### Test het

[Test je receptionist](/docs/nl/reception-ai/receptionist/testing) als een bestaand contact dat zijn e-mailadres opgeeft, en vervolgens als een nieuwe beller die om een offerte vraagt. De nieuwe lead verschijnt in je Odoo CRM-pijplijn.

### Zapier-acties

#### Zoek de beller

| Veld                          | Waarde                                                                              |
| ----------------------------- | ----------------------------------------------------------------------------------- |
| **Zapier-actie**              | **Find Contact**                                                                    |
| **Instellen in Zapier**       | Niets.                                                                              |
| **Door de AI laten invullen** | Het e-mailadres van de beller, of de volledige naam als die geen e-mailadres heeft. |
| **Toewijzen aan**             | **Client**                                                                          |

De Zapier-app van Odoo zoekt contacten op naam of e-mailadres, niet op telefoonnummer, dus je receptionist moet om een van beide vragen.

#### Voeg de beller als lead toe

| Veld                          | Waarde                                                                                                                                                                          |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Zapier-actie**              | **Create Lead**                                                                                                                                                                 |
| **Instellen in Zapier**       | De verkoper en het salesteam waaraan nieuwe leads worden toegewezen, als je account deze velden toont.                                                                          |
| **Door de AI laten invullen** | De titel van de lead (bijvoorbeeld "Offerte keuken - Jane Doe"), de naam, het e-mailadres en telefoonnummer van het contact, en een beschrijving van wat de beller nodig heeft. |
| **Toewijzen aan**             | **Client**                                                                                                                                                                      |

Laat velden zoals verwachte omzet leeg, zodat je receptionist geen bedragen raadt.

> **Tip**
>
> Welke optie je ook gebruikt, voeg een [procedure](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe
> zodat je receptionist om het e-mailadres van de beller vraagt en naar deze zoekt voordat er een
> lead wordt gemaakt.

> **Warning**
>
> De zoekopdracht kan contacten teruggeven die niet de beller zijn, en **Find Contact** in Zapier geeft
> alles terug wat bij het contact is opgeslagen. Voeg een
> [regel](/docs/nl/reception-ai/receptionist/rules-and-procedures) toe die je receptionist vertelt om nooit
> de gegevens van een contact aan de beller voor te lezen en deze alleen te gebruiken om de beller te herkennen.

## Beperkingen

* Je receptionist kan bellers niet op telefoonnummer opzoeken. Hiervoor is hun e-mailadres of exacte naam nodig.
* De beschrijving van de lead bevat wat de beller wilde. De app **Odoo CRM** van Zapier heeft geen actie om een notitie toe te voegen of een gesprek te loggen.
* Bij webhook tools verloopt de API-sleutel. Vervang deze vóór de vervaldatum, anders werken de tools niet meer.
* Met Zapier vereist een zelf-gehoste Odoo-database in plaats daarvan de app **Odoo ERP Self Hosted** van Zapier. De actie **Create Lead/Opportunity** voegt leads toe, maar heeft geen zoekacties, waardoor een terugkerende beller twee keer kan worden toegevoegd. Webhook tools kunnen op Odoo 19 of later in een zelf-gehoste database zoeken.
* Je receptionist kan geen beschikbaarheid controleren of afspraken in Odoo boeken. Gebruik in plaats daarvan de eigen boekingsfunctie van Reception met [Google Calendar](/docs/nl/reception-ai/integrations/google-calendar).
* Met Zapier gebruikt elke actie die je receptionist uitvoert taken uit je Zapier-abonnement. Zapier telt momenteel twee taken per geslaagde oproep; mislukte oproepen tellen niet mee. Wanneer het abonnement op is, stoppen de acties tot het wordt gereset.

## Problemen oplossen

| Probleem                                                            | Wat je moet controleren                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 401 van Odoo                                                        | De header moet `Authorization` zijn met `Bearer `, een spatie en de sleutel. Controleer of de sleutel niet is verlopen of verwijderd.                                                                                                                        |
| 404 van Odoo                                                        | Controleer het adres en of de URL eindigt op `/json/2/res.partner/name_search` of `/json/2/crm.lead/create`. Je database moet Odoo 19 of later draaien en CRM moet zijn geïnstalleerd.                                                                       |
| Odoo geeft een toegangsprobleem terug                               | De Reception.ai-gebruiker heeft toegang tot **Sales**: **User: All Documents** nodig.                                                                                                                                                                        |
| Odoo kan de database niet vinden                                    | Voeg de header `X-Odoo-Database` toe met de naam van je database.                                                                                                                                                                                            |
| Een Odoo-actie verschijnt niet in Reception.ai                      | Selecteer **Refresh tools** in de Zapier-integratie nadat je acties in Zapier hebt toegevoegd.                                                                                                                                                               |
| Een actie toont **Changed** en wordt niet gebruikt                  | Je hebt deze in Zapier bewerkt. Selecteer **Update** op het tabblad **Tools**.                                                                                                                                                                               |
| Zapier kan geen verbinding maken met Odoo                           | Controleer of je Odoo-abonnement externe apps toestaat en of je de juiste app gebruikt voor de locatie waar je database wordt gehost.                                                                                                                        |
| Bekende bellers worden niet gevonden                                | Controleer de spelling van het e-mailadres met de beller. Voor zoekopdrachten op naam is de naam nodig zoals die in Odoo is opgeslagen, en een contact dat bij een bedrijf hoort, wordt opgeslagen als de bedrijfsnaam, een komma en de naam van de persoon. |
| Leads komen bij de verkeerde verkoper of het verkeerde team terecht | Stel de verkoper en het salesteam in als vaste waarden, in de webhook tool of in Zapier.                                                                                                                                                                     |