Odoo
De koppeling met uw Odoo: de naam van de contactpersoon die bij het overgaan wordt getoond, een gespreksfiche in Odoo en de bestemming van de acties van uw oproepgebeurtenissen.
In het kort
| Waar | Integraties, Odoo |
| Wat het doet | identificeert de beller in uw Odoo, registreert de oproepen en ontvangt wat uw regels voor oproepgebeurtenissen er schrijven (een notitie op het contact, een opportuniteit, een ticket) |
| Wat uw oproepen er schrijven | wordt ingesteld in Acties in Odoo en Oproepgebeurtenissen, niet op de fiche van de instantie |
| Edities | Enterprise en Community. Getest op Odoo 17, 18 en 19 |
| Voor te bereiden | de URL van de instantie, de technische naam van de database, een Odoo-login, een API-sleutel |
| Meerdere instanties | ja, zoveel als u wilt. Slechts één is de standaardinstantie |
| Richting van de koppeling | wij zijn het die uw Odoo aanroepen, via zijn webadres en API-sleutel |
Hoe het werkt
U maakt een Odoo-account en de bijbehorende API-sleutel aan. Vanaf dan doet de koppeling twee dingen, die u afzonderlijk inschakelt op de fiche van de instantie: ze zoekt het contact dat bij het nummer past, en ze schrijft een gespreksfiche in Odoo. Al de rest, zoals een notitie op het contact met de transcriptie en de opname, een opportuniteit of een ticket, wordt elders bepaald: u definieert wat er geschreven wordt in Acties in Odoo en wanneer dat gebeurt in Oproepgebeurtenissen.
Het gesprekslogboek wordt geschreven naar het model voip.call, dat van de Phone-app van Odoo. Deze app bestaat alleen in de Enterprise-editie. In Community is het de Axivox-module die het logboek levert, onder haar eigen model maar met dezelfde veldnamen, zodat er niets verandert aan uw gewoontes op de dag dat u naar Enterprise overstapt. De hieronder beschreven test vertelt u welke van de twee uw instantie gebruikt.
De test van de instantie
De knop Verbinding testen controleert niet alleen uw inloggegevens. Hij bevraagt uw instantie en toont wat ze werkelijk kan, in plaats van dit af te leiden uit haar versienummer. Een versie is een aanwijzing, nooit een bewijs: twee instanties uit dezelfde reeks aanvaarden niet noodzakelijk dezelfde velden, en een Enterprise-instantie heeft de app misschien wel niet geïnstalleerd.
De test toont:
- de Editie, Enterprise of Community, en de reeks;
- het Gesprekslogboek, dat wil zeggen het model dat het zal dragen;
- één label per veld, groen of oranje.
Een groen label betekent "Doorgestuurd naar het gesprekslogboek van Odoo". Een oranje label betekent "Hier niet beschikbaar: doorgestuurd naar de berichtenstroom van het contact". Het scherm legt dit onder de labels uit: "De oranje velden bestaan niet in deze versie van Odoo. Ze blijven geschreven worden in de berichtenstroom van het contact." Er gaat dus niets verloren: de informatie verandert alleen van plaats.
De tien bevraagde velden zijn phone_number, direction, state, start_date, end_date, partner_id, user_id, summary, transcript en transcription_status. Vijf andere, die wij toevoegen en die Odoo niet heeft, verschijnen alleen waar ze bestaan: did, talk_duration_s, sentiment, escalation en themes.
Wanneer een gesprekslogboek niet mogelijk is
Twee gevallen, twee verschillende antwoorden.
Als de Phone-app bestaat maar niet geïnstalleerd is, toont het scherm: "De Phone-app van Odoo is niet geïnstalleerd op deze instantie. Zonder haar is geen enkel gesprekslogboek mogelijk." Ze wordt geïnstalleerd vanuit het menu Apps van uw Odoo, met deze waarschuwing, letterlijk getoond: "Op Odoo Online kan het installeren van een app uw abonnement wijzigen. Deze installatie is aan u, wij voeren ze niet in uw plaats uit."
Als de instantie in Community is, bestaat de app niet en zal geen enkele handeling in Odoo haar installeren. Het scherm toont dan: "Deze instantie draait op Community: de Phone-app van Odoo bestaat hier niet. De Axivox-module zal het gesprekslogboek leveren." En het biedt de te volgen stappen aan, in drie fasen, met de downloadknop voor uw reeks:
- "Download de module voor uw Odoo-versie."
- "Plaats de map in de modulesmap van uw Odoo-server, en herstart Odoo daarna. Een module die code aanlevert, wordt pas bij het opstarten opgemerkt."
- "Werk in Odoo, via het menu Apps, de lijst met apps bij, zoek Axivox en installeer. Kom daarna hier terug en test de verbinding."
Wat u moet invullen

Het blok Verbinding:
| Veld | Wat wordt verwacht | Waar het te vinden is |
|---|---|---|
| Naam | een naam voor deze instantie, nuttig als u er meerdere registreert | aan u. Het scherm stelt voor: "Bv.: Odoo Productie" |
| URL van de instantie | "Volledig adres, bv. https://mijnbedrijf.odoo.com" | de adresbalk van uw Odoo |
| Login | de Odoo-account namens wie wij zullen schrijven | uw Odoo |
| API-sleutel | "Gegenereerd in Odoo: Voorkeuren → Accountbeveiliging → API-sleutels." | te genereren in Odoo, nooit het wachtwoord van het account |
| Database | "Technische naam van de database (vaak verschillend van het subdomein). Zichtbaar via /web/database/list." | de knop Databases weergeven, of het adres ernaast |
De knop Databases weergeven bevraagt de server op basis van het ingevoerde adres, vóór elke authenticatie. Drie mogelijke antwoorden: een lijst om uit te kiezen, "Geen enkele database door de server teruggegeven (weergave mogelijk uitgeschakeld)", of "Onmogelijk om de databases weer te geven (server onbereikbaar of weergave uitgeschakeld). Voer de naam handmatig in." In de laatste twee gevallen typt u de naam met de hand: de weergave staat vaak uit op een productie-instantie, dat is geen storing.
Bij het wijzigen toont het veld API-sleutel "•••••••• (laat leeg om de huidige te behouden)". Leeg gelaten, raakt dit de reeds opgeslagen sleutel niet aan.
Het blok Functies bevat vijf schakelaars, in deze volgorde. De tekst in de rechterkolom is degene die het scherm onder elke schakelaar toont.
| Schakelaar | Wat ze doet |
|---|---|
| Actieve instantie | "Uitschakelen om elke synchronisatie met deze instantie op te schorten." |
| De bellers identificeren | "Het contact opzoeken voor alle inkomende oproepen, ook die welke niet via een belplan verlopen. De gevonden naam wordt bewaard, zodat volgende oproepen van hetzelfde nummer onmiddellijk zijn. De opzoeking krijgt een halve seconde voor de oproep verdergaat: bij een eerste oproep van een onbekend nummer kan de naam dus ontbreken en pas vanaf de volgende oproep verschijnen." |
| De naam van het contact tonen | "De getoonde naam vervangen door die van het geïdentificeerde contact, zowel op het opgeroepen toestelnummer als in de historiek." Deze schakelaar hangt af van de vorige en blijft grijs zolang die uit staat |
| De oproepen registreren | "Voor elke oproep een oproepfiche (voip.call) in Odoo aanmaken." |
| De transcriptie op de oproepfiche publiceren | "De transcriptie, de samenvatting en de analyse worden in de velden van de in Odoo aangemaakte oproepfiche geschreven. Wat op de contactfiche komt, hangt af van de acties, niet van deze instelling." Deze schakelaar hangt af van de vorige en blijft grijs zolang die uit staat |
De lijst met instanties toont op haar beurt de Naam, de URL, de Status (Actief of Inactief) en een kolom Standaardinstantie, die een keuzerondje is: slechts één instantie tegelijk. De link Standaardinstantie verwijderen, onder de tabel, annuleert deze keuze.
Een klik op een rij opent de instantie. De kolom met acties biedt het pictogram "Status van de integratie bekijken", het pictogram "Acties in Odoo" en de prullenbak. Als de koppeling problemen ondervindt, verschijnt naast de status een oranje badge met hun aantal, die het scherm Status van de integratie opent.
Te volgen stappen
- Genereer in Odoo een API-sleutel: Voorkeuren, Accountbeveiliging, API-sleutels.
- Open Integraties, Odoo, dan Een instantie toevoegen.
- Geef de instantie een naam, voer haar volledige URL en de login van het account in, en plak dan de API-sleutel.
- Klik op Databases weergeven en kies de uwe. Als de weergave is uitgeschakeld, typ dan de technische naam van de database.
- Klik op Verbinding testen. Lees de test die verschijnt: de editie, de reeks, het gesprekslogboek en de kleur van de labels.
- Als de test meldt dat geen enkel gesprekslogboek mogelijk is, los dit dan eerst op in uw Odoo, en test opnieuw.
- Activeer de schakelaars die u nodig hebt, te beginnen met Actieve instantie.
- Sla op.
- Vink terug op de lijst Standaardinstantie aan bij degene die uw belplannen standaard moeten bevragen.
- Om iets anders dan de gespreksfiche naar Odoo te schrijven, maakt u de gewenste acties aan (zie Acties in Odoo) en daarna de regel die ze activeert (zie Oproepgebeurtenissen).
- Bel een van uw nummers vanaf een toestel waarvan het nummer in Odoo bestaat, en controleer de getoonde naam.
Als het niet werkt
"Verbinding mislukt" na de test. Vier waarden kunnen de oorzaak zijn, in deze volgorde van frequentie: de naam van de database, die niet het subdomein is; de API-sleutel, die een sleutel moet zijn en geen wachtwoord; de login; de URL, die volledig moet zijn, protocol inbegrepen. Corrigeer één waarde tegelijk en test opnieuw: de test is gratis en onmiddellijk.
Er zijn oranje labels na de test. Er gaat niets verloren. "De oranje velden bestaan niet in deze versie van Odoo. Ze blijven geschreven worden in de berichtenstroom van het contact." U vindt ze terug op de fiche van de correspondent, in zijn berichtenstroom, in plaats van op de gespreksfiche.
De naam van het contact verschijnt niet bij de eerste oproep van een onbekend nummer. Dat is het aangekondigde gedrag onder de schakelaar De bellers identificeren: de opzoeking heeft een halve seconde de tijd voordat de oproep verdergaat. Na die termijn gaat de oproep zonder te wachten door, om nooit een overgaan te vertragen. De gevonden naam wordt vervolgens bewaard: vanaf de tweede oproep van hetzelfde nummer verschijnt ze onmiddellijk.
Er wordt niets op het contact gepubliceerd. De notitie op het contact is geen instelling van de instantie meer: ze hangt af van een regel op de pagina Oproepgebeurtenissen. Controleer of een regel van de gebeurtenis Oproep beëindigd de actie Naar Odoo schrijven heeft, of de gekozen Odoo-actie is geactiveerd, of de instantie actief is en of de beller in uw Odoo is geïdentificeerd. De audio wordt alleen verstuurd als Voeg de gespreksopname toe aan staat voor de Odoo-actie en de oproep is opgenomen. Zie de pagina Acties in Odoo.
Er verschijnt geen enkele gespreksfiche in Odoo. Test de verbinding en lees de regel Gesprekslogboek van de test. Als deze leeg is, heeft de instantie nog geen model om het logboek te ontvangen: volg de stappen die het scherm toont, die van de Phone-app op Enterprise, die van de Axivox-module op Community.
Wat de Odoo-integratie dagelijks oplevert
Bekijk de pagina Odoo