Ga naar hoofdinhoud

Odoo Sync

Odoo Sync verbindt uw MonoChat-werkruimte met uw Odoo-database, op Odoo Online, Odoo.sh of uw eigen server. De app:

  • stuurt naam, telefoonnummer, e-mailadres en gekoppelde profielvelden van uw klanten naar hun Odoo-contact of CRM-lead en maakt er een aan als die er niet is,
  • leest elke 10 minuten de in Odoo gewijzigde contacten en leads en werkt de bijbehorende klanten in MonoChat bij,
  • plaatst elk gesloten gesprek als notitie in de chatter van het contact of de lead,
  • toont de facturen en verkooporders van de klant naast het gesprek en stuurt een betaallink voor een onbetaalde factuur,
  • boekt de betaling in Odoo op de factuur wanneer de klant de link betaalt.

Voordat u begint​

U hebt nodig:

  1. Odoo 17 of nieuwer met API-toegang. Odoo geeft API-toegang in het Custom-abonnement; een Odoo die u zelf host heeft die ook.
  2. Een API-sleutel. Open in Odoo Preferences › Account Security van de gebruiker namens wie de app werkt en klik op New API Key. Odoo toont de sleutel één keer: kopieer hem. Odoo raadt een aparte gebruiker voor integraties aan, met alleen de nodige rechten.
  3. De Odoo-apps die u gebruikt. Contacten worden altijd gesynchroniseerd. Leads vereisen de app CRM, orders de app Verkoop en facturen de app Facturatie of Boekhouding.
  4. Een betaalsysteem in MonoChat om betaallinks te sturen. De app gebruikt uw standaardbetaalsysteem.

Odoo koppelen​

  1. Installeer de app vanuit MonoStore.
  2. Open Instellingen › Odoo.
  3. Vul het Odoo address in (bijvoorbeeld https://yourcompany.odoo.com) en de naam van de Database.
  4. Vul bij Odoo 18 en ouder onder Login (Odoo 18 and earlier) de login in van de gebruiker van de API-sleutel. Odoo 19 en nieuwer hebben die niet nodig.
  5. Plak de API key, klik op Save en daarna op Test connection.

De app gebruikt vanaf Odoo 19 de JSON-2-API van Odoo en bij oudere versies JSON-RPC; het scherm toont welke. De API-sleutel wordt niet opnieuw getoond; laat het veld leeg om de opgeslagen sleutel te houden. Alleen de eigenaar of een manager kan deze instellingen wijzigen. Als u het adres of de database wijzigt, voer de API-sleutel dan opnieuw in.

Wat wordt gesynchroniseerd​

InstellingWat het doet
Sync customers withWaar een MonoChat-klant wordt aangemaakt als Odoo geen record voor hem heeft: Contacts of CRM leads.
Add new Odoo records with a phone number as MonoChat customersEen contact of lead die na het koppelen in Odoo wordt aangemaakt, met een telefoonnummer, wordt een MonoChat-klant aan wie uw team kan schrijven.
Post each closed conversation to the record’s chatterWanneer een gesprek wordt gesloten, worden de berichten sinds de laatste notitie (hoogstens de laatste 100) als notitie in de chatter geplaatst. Interne notities worden weggelaten.
JournalHet bank- of kasdagboek waarin de betaling van een betaalde link wordt geboekt. Zonder keuze beslist Odoo.
Field mappingMaximaal vijf profielvelden, elk met de technische naam van een Odoo-veld (Odoo toont die in de ontwikkelaarsmodus) en een richting: Both ways, To Odoo only of From Odoo only. Naam, telefoonnummer en e-mailadres worden altijd gesynchroniseerd.
  • Van MonoChat naar Odoo: wanneer het profiel van een klant wijzigt, vindt de app zijn contact of lead via e-mailadres of telefoonnummer, of maakt er een aan, en stuurt alleen de gewijzigde waarden.
  • Van Odoo naar MonoChat: elke 10 minuten leest de app de in Odoo gewijzigde contacten en leads en werkt de gekoppelde klanten bij, of de klant met hetzelfde telefoonnummer of e-mailadres. Een waarde die uit Odoo kwam, wordt niet teruggestuurd.
  • Verschijnt de klant van een lead later als Odoo-contact, dan wordt de klant aan het contact gekoppeld.
  • Instellingen › Odoo toont wanneer de laatste lezing liep en de fout ervan als die mislukte.
  • Een record dat niet in MonoChat kan worden toegepast, stopt de lezing niet: het scherm toont hoeveel er zijn overgeslagen, met het laatste en de reden.

Naast het gesprek​

De kaart Odoo naast het gesprek toont de laatste facturen van de klant, met het openstaande bedrag en de betaalstatus, en zijn laatste verkooporders. Bij een onbetaalde factuur stuurt Send payment link de klant een bericht met een betaallink voor het openstaande bedrag.

In uw flows​

Voeg een Functie-knooppunt toe aan een flow onder Instellingen › Automatisering › Flows en kies een van de knooppunten van de app. Zie Flows.

KnooppuntWat het doetUitgangen
Odoo · Send orders or invoicesStuurt de klant zijn onbetaalde facturen of laatste verkooporders (nummer, bedrag en datum) onder de kop die u schrijft.Sent, None, Not in Odoo
Odoo · Send invoice payment linkMaakt een betaallink voor de oudste onbetaalde factuur van de klant, voor het openstaande bedrag, en stuurt die met uw bericht. Zet {invoice}, {amount} en {link} in het bericht waar ze moeten staan.Sent, No invoice, Not in Odoo, No payment system

Not in Odoo betekent dat de app geen Odoo-contact voor de klant vond. Weigert Odoo het verzoek, dan neemt het knooppunt zijn foutpad.

Met uw AI-agent​

Voeg de tools van de app toe aan uw AI-agent:

  • Odoo · Read the customer's orders and invoices geeft de agent de laatste verkooporders en facturen van de klant, met bedragen, datums en wat nog openstaat.
  • Odoo · Get an invoice payment link geeft de agent een betaallink voor de factuur die de klant noemt, of zijn oudste onbetaalde factuur, om in het antwoord te delen.

Als de klant betaalt​

Een betaallink is in de valuta van de factuur. Betaalt de klant hem, dan boekt de app de betaling in Odoo op de factuur, in het gekozen dagboek, met MonoChat en het nummer van de betaling als memo. Een factuur die in Odoo al betaald is, blijft ongewijzigd.

Goed om te weten​

  • Odoo kan MonoChat nog niet op de hoogte brengen, dus wijzigingen uit Odoo komen binnen 10 minuten in MonoChat aan.
  • Records die vóór het koppelen in Odoo zijn gewijzigd, worden niet gelezen. Een klant wordt aan Odoo gekoppeld wanneer zijn profiel wijzigt, een gesprek sluit of de app een wijziging in Odoo leest.
  • De app handelt in Odoo als de gebruiker van de API-sleutel: ze ziet en wijzigt wat die gebruiker mag.