Odoo Integration

So verbinden Sie die Open-Source-ERP-Suite Odoo mit der sipgate App für Kontakt- und Anrufaktivitäten-Synchronisierung.

Odoo ist eine vollständig integrierte und anpassbare Open-Source-Suite von Geschäftsanwendungen. Ein Großteil der Geschäftsanforderungen wie CRM, Vertrieb, Projekt, Fertigung, Inventar und Buchhaltung wird durch diese All-in-one-Softwarelösung erfüllt. Odoo ist so konzipiert, dass es die Bedürfnisse von Unternehmen unabhängig von Größe und Budget erfüllt.

In der sipgate App können Sie direkt Ihre Odoo Kontakte nutzen. So sehen Sie immer, wer gerade anruft und müssen nicht zwischen verschiedenen Tools wechseln. sipgate ist Ihre Telefonanlage mit der Telefonie App für Desktop und Mobile.

Verbinden Sie sipgate und Odoo und profitieren von der automatischen Kontaktsynchronisierung. Alle Änderungen oder neuen Kontakte, die Sie in der sipgate App während oder nach dem Telefonat hinzufügen, werden automatisch in Odoo gespeichert. Zusätzlich aktualisiert sipgate auch Ihre Anrufaktivitäten an Ihren Kontakten in Odoo. So sind Sie immer auf dem neuesten Stand und wissen, wann Sie mit welchem Ihrer Kontakte telefoniert haben und was Sie sich zu Ihrem Gespräch notiert haben.

Integration von Odoo in der sipgate App

1

Integration auswählen

Klicken Sie in der sipgate App links auf das Zahnrad und wählen Sie den Punkt "Integrationen" aus.

Unter dem Punkt "Integrationen" suchen Sie den Eintrag "Odoo" und klicken auf die Schaltfläche "Mit Odoo verbinden".

2

API-Daten eingeben

Geben Sie hier den benötigten Odoo API-Key und die API-URL ein.

Wichtig: Der API-Key ist nur im Tarif Custom enthalten und muss in der Form "DATABASE_NAME:USER_EMAIL:ODOO_API_KEY" eingegeben werden. Den Databasename kann man als Admin via Einstellungen ➔ Entwicklertools: Entwicklermodus aktivieren (mit Assets) anklicken und dann rechts oben neben dem User Logo sehen. Oder den KI-Assistent nach dem eigenen Databasename fragen.

Beispielsweise sipgate:[e-mail]:API-Key

Sollten Sie Odoo nicht selber hosten, bzw. bei Odoo hosten lassen, geben Sie die API-URL bitte in der Form "https://<Meine-Domain>.odoo.com." ein.

3

Verbindung bestätigen

Damit haben Sie Odoo und die sipgate App erfolgreich verbunden.

Je nach Anzahl der zu integrierenden Kontakte kann es einige Minuten dauern, bis diese vollständig angezeigt werden.

API-Key in Ihrem Odoo-Account finden bzw. erstellen

Klicken Sie in Ihrem Account rechts oben auf das Benutzer-Symbol und wählen den Punkt Admin-Settings aus.

Odoo1 Kopie.png

Wählen Sie im folgenden Fenster den Reiter Kontosicherheit und klicken Sie im Abschnitt API-Schlüssel auf den Button Neuer API-Key.

Odoo2 Kopie.png

Hier finden Sie bereits bestehende API-Keys, bzw. können an dieser Stelle über den Button Neuer API-Schlüssel einen neuen API-Key erzeugen.

Bitte beachten Sie, dass Sie bereits bestehende API-Schlüssel nicht mehr einsehen können. Einen entsprechenden Hinweis erhalten Sie bei der Erstellung eines API-Schlüssels.

Odoo2a Kopie.png

Welche Berechtigungen braucht der Odoo-API-User?

Der Odoo-API-User benötigt folgende Rechte. Fehlt eines davon, schlagen Teile der Integration ggf. ohne Fehlermeldung fehl:

• Kontakte (res.partner): read, write, create, unlink (Löschen wird beim Sync gebraucht)

• CRM-Leads (crm.lead): read, write, create, unlink — i. d. R. über die Gruppe „Sales / Salesperson"

• Aktivitäten (mail.activity): create und write — wir legen neue Activities an und schließen sie wieder

• Nachrichten (mail.message): write — fürs Update des Call-Log-Bodys

• Modell-Metadaten (ir.model): read

• Optional, nur falls Kontakte mit verknüpften Usern gelöscht werden sollen: res.users write + unlink (Administrator-Recht)

Wie funktioniert Click2Dial mit Odoo?

Im Kontakt/Deal neben der Rufnummer auf Anrufen klicken. Es öffnet sich nun die sipgate App und ruft die Rufnummer an. Damit der Anruf klappt sollte die Rufnummer +49 ohne Leerzeichen/Sonderzeichen hinterlegt sein. Wenn sich eine andere App öffnet, sollte man im Betriebssystem für TEL sipgate App einstellen.

Click2Dial mit Odoo WebRTC einrichten

Odoo erlaubt die Telefonie über eine eigene WebRTC Lösung. Odoo VoIP FAQ Dazu unter Odoo ➔ Benutzer ➔ Benutzer X ➔ ”VoIP” Anmeldedaten: Benutzername: SIP-ID Geheimnis: SIP-Passwort

anmelden. Anschließend ”Anbieter verwalten” anklicken VoIP Anbieter anlegen: Name: sipgate Websocket: wss://sip.sipgate.de PBX-Server-IP: sipgate.de VoIP-Umgebung: “Produktion” Zurück zum Benutzer wechseln und bei Anbieter “sipgate” auswählen. Das Telefon starten und prüfen ob Status “Verfügbar” angezeigt wird. Wenn man noch “Demo” sieht kann es helfen CMD/Strg+R” drücken.

Odoo02.png

Zurück zum Benutzer wechseln und bei Anbieter “sipgate” auswählen. Das Telefon starten und prüfen ob Status “Verfügbar” angezeigt wird. Wenn man noch “Demo” sieht kann es helfen CMD/Strg+R” drücken.

Odoo01.png

Wie funktioniert Call Logging / Notizen syncen mit Odoo?

Man kann im Anruf die Notizen öffnen und eine Notiz schreiben. Man kann am Ende des Anrufes innerhalb von 10 Sekunden eine Notiz schreiben. Die Notiz wird mit kurzer Verzögerung 2-5s zum Odoo Kontakt gesendet. In der sipgate App ➔ Einstellungen ➔ Integrationen:Call Logging 0s + Kontakte: loggt alle Anrufe automatisch ohne Notiz, wenn keine Notiz hinterlegt ist Call Logging 5s bis 60s + Kontakte: loggt nur angenommene Anrufe mit X Sekunden Dauer Wenn Anrufe auf den Anrufbeantworter nicht geloggt werden sollen, empfehlen wir, die Dauer auf 60s einzustellen. \

Wichtig: Beachten Sie, dass nur die offenen Deals vorgeschlagen werden, wenn Sie die Notizen an die Deals anhängen möchten.

Fehler & Lösungen

Fehler: "Odoo ist verbunden, aber Kontakte werden nicht geladen"\

Hinweis: sofern man 100.000 - 400.000 Kontakte hat muss man beim ersten mal bis zu 30min warten

Ursache: Dem Benutzer fehlen Rechte zum lesen/schreiben/erstellen von Kontakten Lösung: der Odoo Admininistrator kann die Rechte für die Benutzer anpassen: https://www.odoo.com/documentation/17.0/applications/general/users/access_rights.html\

Fehler: "Anmeldedaten sind ungültig" Ursache 1: Odoo Trial/Testphase (14 Tage) erlaubt keinen API-Zugriff, auch wenn ein API-Key erstellt werden kann. Lösung 1: Odoo Testphase in einen regulären Account umwandeln. Analyse 2.1: sipgate App einloggen, F12 Console öffnen (Chrome), Odoo verbinden, Fehler: POST https://integration.sipgate.cloud/users.integrations.create 400 (Bad Request) Hinweis 2.1: mydatabase.odoo.com ->”mydatabase” kann/muss aber nicht identisch mit Datenbankname sein Ursache 2.1: API-Key und/oder API URL sind ungültig Lösung 2.1: API-Key Eingabe: muss in der Form "DATABASE_NAME:USER_EMAIL:ODOO_API_KEY" eingegeben werden ohne Leerzeichen, E-Mail Adresse korrekt mit @ verwenden Datenbankname: als Administrator bei Odoo anmelden und unter Einstellungen >Entwicklertools: Entwicklermodus aktivieren (mit Assets) anklicken, oben Rechts neben User Logo sieht man nun den Datenbanknamen Oder den KI-Assistenten nach dem eigenen Datenbanknamen fragen. Ursache 2.2: Benutzerberechtigung wurde zu stark eingeschränkt Lösung 2.2: Berechtigung für Benutzer anpassen Siehe Odoo FAQ

OdooRechte2.png

Fehler: Odoo ist erfolgreich verbunden, aber es wurden 0x Kontakte gefunden Ursache: es wurden mehrere Datenbanken erstellt und Datenbank X mit 0x Kontakte verbunden Lösung: Sie finden Ihre erstellten Datenbanken unter Benutzermenü ➔ Meine Datenbanken

Fehler: Summary/Zusammenfassung wird nicht zu Odoo Kontakt übertragen ”Your latest changes for the selected associations could not be pushed” Ursache: dem Odoo-User fehlen Schreibrechte - darauf achten das in der sipgate App ➔ Enstellungen ➔ Integrationen ➔ Odoo: das Loggen an Kontakte/Deals/Unternehmen und Summary aktiviert ist, wenn man die Funktion nutzen möchte Lösung: Der Odoo Admin muss dem Odoo User Schreibrechte für mail.activity geben - es werden generell Rechte für read, write, create benötigt.