So verbinden Sie Odoo mit BOTS4.me: Installationsleitfaden für den Connector (Odoo 13–19)

🧭 Wählen Sie zuerst Ihren Weg: Wo läuft Ihr Odoo?

Es gibt zwei Installationswege, und das Einzige, was darüber entscheidet, ist die Art Ihres Odoo-Hostings. Beide führen zum selben Ziel: Eine Verbindung bedient jede BOTS4.me-App, die mit Odoo arbeitet.

Sie wissen nicht genau, welches Hosting Sie nutzen, oder wählen noch aus? Lesen Sie Odoo Online vs. Odoo.sh vs. On-Premise: Was lässt sich automatisieren?

Hinweis zum Tarif: Odoo Online benötigt für den API-Zugriff den Custom-Tarif von Odoo; Odoo.sh und On-Premise funktionieren mit jedem Tarif.

🔌 Weg A: Odoo.sh & On-Premise — der Connector mit einem Klick

• Schritt 1 — Erstellen Sie Ihr BOTS4.me-Konto. Registrieren Sie sich unter bots4.me/bots oder überspringen Sie diesen Schritt und erstellen Sie das Konto in Schritt 3 direkt in Odoo. Jede kostenlos startbare App beginnt dann mit einem kostenlosen Discovery-Monat.
• Schritt 2 — „BOTS4.me Connect“ installieren. Öffnen Sie auf apps.odoo.com BOTS4.me Connect, wählen Sie Ihre Odoo-Version (13.0 bis 19.0) und laden Sie die kostenlose ZIP-Datei herunter; sie enthält einen Ordner, b4m_connect. On-Premise: Legen Sie diesen Ordner in ein Verzeichnis Ihres Addons-Pfads, starten Sie den Odoo-Dienst neu, aktivieren Sie den Entwicklermodus, öffnen Sie Apps → App-Liste aktualisieren, suchen Sie nach „BOTS4.me Connect“ und klicken Sie auf „Aktivieren“ (bei älteren Versionen „Installieren“). Odoo.sh: Committen Sie den Ordner in Ihr Repository (zuerst am besten in einen Staging-Branch) und pushen Sie; wenn der Build grün ist, installieren Sie ihn über Apps in der Datenbank dieses Builds. Die Einzel-App-Module im Store (zum Beispiel „Mail2ERP by BOTS4.me“) werden genauso installiert und zeigen nur ihre eigene App. Der Quellcode steht unter LGPL-3, sodass Sie oder Ihr Integrator jede Zeile vor der Installation lesen können.
• Schritt 3 — Den Verbindungsassistenten ausführen. Öffnen Sie als Odoo-Administrator BOTS4.me Connect → Einstellungen und klicken Sie auf Verbinden. Wählen Sie „Ein neues Konto unter www.bots4.me erstellen“ (geben Sie Ihre E-Mail-Adresse ein; wenn ein BOTS4.me-Partner uns empfohlen hat, tragen Sie seinen Code unter „Partnercode“ ein) oder „Ich habe bereits ein Konto unter www.bots4.me“ (E-Mail und Passwort). Geben Sie dann den 6-stelligen Code aus Ihrer E-Mail oder aus Ihrer Authenticator-App ein, falls Sie eine nutzen. Der Assistent kommuniziert über HTTPS direkt mit bots4.me; es werden keine Zugangsdaten auf einer Seite eines Drittanbieters eingegeben.
• Schritt 4 — Die Schlüssel werden für Sie erzeugt. Nach erfolgreicher Anmeldung stellt BOTS4.me für genau diese Odoo-Datenbank einen API-Schlüssel und ein HMAC-Signaturgeheimnis aus, und das Modul legt einen lokalen technischen Benutzer „BOTS4.me Connect“ an, sodass die Bots Odoo-Datensätze per XML-RPC mit ihrer eigenen Identität lesen und schreiben, nie mit Ihrem persönlichen Admin-Login. Dieser Benutzer erhält nur die Odoo-Rechte der Apps, die Sie aktivieren. Wie jeder interne Benutzer zählt er bei einem benutzerbasierten Odoo-Enterprise-Abonnement mit. Ab Odoo 18 begrenzt Odoo, wie lange API-Schlüssel gültig bleiben: Wenn das Modul „API-Schlüssel läuft bald ab“ anzeigt, klicken Sie auf Trennen und dann auf Verbinden — keine App-Einstellungen gehen verloren.
• Schritt 5 — Die Einrichtungsformulare sind vorausgefüllt. Der Connector sendet die Metadaten Ihres Odoo (URL, Datenbank-UUID, Rechnungsdaten des Unternehmens, IMAP-Mailserver-Adressen), um die BOTS4.me-Einrichtungsformulare vorauszufüllen. Mail-Passwörter bleiben in Ihrem Odoo, bis Sie ein Postfach an eine App übergeben, entweder mit + Mein IMAP-Postfach (1 Klick) oder durch Klicken auf Kostenlosen Discovery-Monat starten bei einer App, die E-Mails liest. Sie werden verschlüsselt, bevor sie Ihr Odoo verlassen.
• Schritt 6 — Ihre erste App aktivieren. Unter Apps zeigt jede App ihren Status (Nicht aktiviert, Einrichtung erforderlich, Aktiv, Konfiguriert). Klicken Sie einmal auf Zuerst Rechnungsdaten ergänzen, tragen Sie Ihre Rechnungsdaten auf bots4.me ein und klicken Sie dann bei der gewünschten App auf Kostenlosen Discovery-Monat starten. Dieser eine Klick aktiviert die App, verbindet dieses Odoo als ihr ERP und übergibt bei Apps, die E-Mails lesen, Ihr Odoo-IMAP-Postfach. Für alles, was noch fehlt, hat die App eine eigene Schaltfläche: + Dieses Odoo als ERP (1 Klick), + Mein IMAP-Postfach (1 Klick), + Postfach (Gmail, Microsoft 365) oder + Cloud-Speicher. Dashboard, Protokolle und Einstellungen öffnen bots4.me bereits angemeldet.

☁️ Weg B: Odoo Online — No-Code-Einrichtung mit einem API-Schlüssel

Odoo Online (die SaaS-Edition auf odoo.com) erlaubt keine eigenen Python-Module — das ist eine Plattformregel, keine Einschränkung von BOTS4.me. Der Online-Weg verwendet daher ein No-Code-XML-Helfermodul plus einen standardmäßigen Odoo-API-Schlüssel, den Sie selbst erstellen (der externe API-Zugriff ist Teil des Custom-Tarifs von Odoo):

• Schritt 1 — Erstellen Sie Ihr BOTS4.me-Konto unter bots4.me/bots.
• Schritt 2 — Einen Odoo-API-Schlüssel erstellen. Gehen Sie in Ihrer Odoo-Online-Datenbank zu Einstellungen → Benutzer & Unternehmen → Benutzer → Ihr Benutzer → Kontosicherheit (aktivieren Sie den Entwicklermodus, falls der Tab ausgeblendet ist) und klicken Sie auf Neuer API-Schlüssel. Nennen Sie ihn „BOTS4.me“, wählen Sie, wie lange er gültig bleibt (ab Odoo 18 wird danach gefragt), und kopieren Sie den Schlüssel; Odoo zeigt ihn nur einmal an. Erstellen Sie vor seinem Ablauf einen neuen und fügen Sie ihn bei bots4.me in dieselbe Odoo-Verbindung ein (Bearbeiten → ERP-Konto aktualisieren).
• Schritt 3 — Die App starten und den Schlüssel bei bots4.me einfügen. Melden Sie sich unter bots4.me/bots an, klicken Sie auf der Karte der App auf Kostenlosen Discovery-Monat starten und akzeptieren Sie einmalig die Bedingungen — keine Kreditkarte erforderlich. Öffnen Sie dann Einstellungen (Zahnrad) → die App → Access Manager, klicken Sie auf Ziel hinzufügen oder Quelle hinzufügen (die App zeigt die benötigte Option), wählen Sie ERP → Odoo und füllen Sie Odoo URL aus (bei https://yourcompany.odoo.com wird der Datenbankname automatisch ausgefüllt), Ihre Login-E-Mail als Benutzername und den API-Schlüssel unter Passwort oder API-Schlüssel. Klicken Sie auf ERP-Konto hinzufügen.
• Schritt 4 — Den Helfer ohne Code hinzufügen (optional). Das Modul „BOTS4.me for Odoo Online“ auf apps.odoo.com enthält nur Datensätze, kein Python, daher akzeptiert Odoo Online es. Es fügt Ihrem Odoo eine App BOTS4.me mit Verbinden / Dashboard, Einrichtungsanleitung und So erstellen Sie einen API-Schlüssel hinzu. Die Bots verbinden sich in jedem Fall über die externe Standard-API von Odoo.
• Schritt 5 — Im DEMO-Modus prüfen. Schalten Sie im Tab Steuerung der App den Bot-Betrieb ein und lassen Sie den Modus auf DEMO. Nach dem ersten Lauf erhalten Sie eine DEMO-Berichts-E-Mail, die auflistet, was der Bot gelesen hat und was er geschrieben hätte, und der Tab Protokolle zeigt jede Entscheidung; in Odoo ändert sich nichts. Wenn die DEMO-Berichte stimmen, stellen Sie Modus auf dem Tab „Steuerung“ auf LIVE — das wird nach der ersten DEMO-Berichts-E-Mail freigeschaltet.

🧭 Testen Sie es in Ihrem kostenlosen Discovery-Monat

Der erste Monat jeder kostenlos startbaren App ist ein kostenloser Discovery-Monat: das Nutzungskontingent des Personal-Tarifs, mit vielen Family- und Business-Funktionen zum Testen freigeschaltet, und keine Kreditkarte erforderlich. Hier ist der kürzeste Weg von „verbunden“ zu einem ersten Ergebnis in Odoo.

• 1 — Die App starten. In Odoo (Odoo.sh, On-Premise): BOTS4.me Connect → Einstellungen, einmal auf Zuerst Rechnungsdaten ergänzen klicken, dann bei der App auf Kostenlosen Discovery-Monat starten. Unter Odoo Online: Melden Sie sich unter bots4.me/bots an, klicken Sie auf der Karte der App auf Kostenlosen Discovery-Monat starten und akzeptieren Sie einmalig die Bedingungen — keine Kreditkarte erforderlich. In beiden Fällen zeigt das Dashboard dann „Kostenloser Discovery-Monat — noch N Tage“.
• 2 — Verbinden, was die App braucht. In Odoo verbindet das Starten der App bereits dieses Odoo und, falls Ihr Odoo einen IMAP-Mailserver hat, dessen Postfach. Nutzen Sie + Dieses Odoo als ERP (1 Klick) oder + Postfach (Gmail, Microsoft 365) für alles, was noch fehlt. Unter Odoo Online fügen Sie die Odoo-Verbindung im Access Manager wie in Weg B beschrieben hinzu und das Postfach mit Quelle hinzufügen.
• 3 — Im DEMO-Modus ausführen. Öffnen Sie den Tab Steuerung der App (oder Schnellsteuerung in Odoo), schalten Sie den Bot-Betrieb ein und lassen Sie den Modus auf DEMO. Schalter mit einem Discovery-Tag auf dem Tab „Steuerung“ sind in Ihrem kostenlosen Monat enthalten und starten ausgeschaltet — schalten Sie diejenigen ein, die Sie testen möchten.
• 4 — Das Ergebnis prüfen. Lesen Sie nach dem ersten Lauf die DEMO-Berichts-E-Mail und den Tab Protokolle: jedes Dokument, das der Bot gelesen hat, und was er in Odoo angelegt oder geändert hätte.
• 5 — LIVE gehen. Wenn die DEMO-Berichte stimmen, stellen Sie Modus auf dem Tab „Steuerung“ auf LIVE — das wird nach der ersten DEMO-Berichts-E-Mail freigeschaltet. Der Bot schreibt nun über die von Ihnen eingerichtete Verbindung mit den Rechten seines Odoo-Benutzers in Odoo.
• 6 — Nach dem Monat. Wenn der Monat endet, läuft die App von selbst im kostenlosen Tarif weiter, mit einem kleinen monatlichen Kontingent: Ist es aufgebraucht, warten neue Vorgänge bis zum nächsten Monat oder bis Sie einen Tarif wählen, und ein bereits begonnener Vorgang wird immer abgeschlossen. Wählen Sie einen Tarif, um alle Funktionen zu behalten — siehe die Tariftabelle auf der Produktseite der App.

🔒 Das Sicherheitsmodell, ehrlich erklärt

Sie geben einem externen Dienst Zugriff auf Ihr ERP, daher sollten Sie konkrete Angaben verlangen — nicht nur ein Siegel mit der Aufschrift „Sicherheit auf Bankniveau“. So ist BOTS4.me Connect im Detail aufgebaut:

• Nur HTTPS, fest im Code. Der API-Endpunkt ist im Modulquellcode fest auf https://bots4.me gesetzt — es ist kein bearbeitbares Einstellungsfeld, sodass ein kompromittierter Konfigurationsdatensatz Ihren API-Verkehr nicht auf einen feindlichen Server umleiten kann. Jede von der API zurückgegebene URL wird überprüft, bevor Ihr Browser sie öffnet; Antworten ohne HTTPS oder von einem fremden Host werden abgelehnt.
• Anfragensignierung mit HMAC-SHA256. Jeder Aufruf, den das Modul an BOTS4.me sendet, wird mit dem datenbankspezifischen Geheimnis signiert, sodass Anfragen während der Übertragung nicht gefälscht oder manipuliert werden können.
• Anmeldedaten auf Administratoren beschränkt. Die Felder für API-Schlüssel, Signaturgeheimnis und technischen Benutzer haben einen auf Feldebene beschränkten Zugriff, der auf die Administratorgruppe von Odoo (base.group_system) begrenzt ist. Normale interne Benutzer sehen das Launchpad und die App-Status, aber die Geheimnisse erscheinen niemals in einem Datensatz-Lesevorgang, den sie ausführen könnten — und alle Aktionen zum Verbinden/Trennen/Konfigurieren sind ausschließlich Administratoren vorbehalten.
• Open Source, LGPL-3. Der vollständige Quellcode steckt in der ZIP-Datei, die Sie von apps.odoo.com herunterladen, sodass Ihr Integrator genau prüfen kann, was Ihren Server verlässt: Metadaten zum Vorausfüllen von Formularen, ein Postfachpasswort nur dann, wenn Sie dieses Postfach an eine App übergeben (verschlüsselt, bevor es den Server verlässt), und niemals Ihre Geschäftsdokumente.
• Prüfpfad auf beiden Seiten. Das Modul führt in Odoo ein lokales Ereignisprotokoll über Verbindungen, Konfigurationsänderungen und Fehler; das BOTS4.me-Dashboard führt vollständige Entscheidungsprotokolle pro Lauf.
• Automatische Berechtigungsaktualisierung. Ein geplanter Cron prüft Ihre Abonnements regelmäßig erneut, sodass die App-Status im Launchpad aktuell bleiben — und eine gekündigte App wird umgehend nicht mehr bedient.

Mehr zur Plattformsicherheit und zum abgestuften Zugriff: bots4.me/security und Zugriffsebenen. Die Plattform wird in der EU gehostet, ist für die DSGVO konzipiert, und 2FA ist für jedes Konto verfügbar.

✅ Nach dem Verbinden: eine Verbindung für jede Odoo-App

Sie installieren den Connector genau einmal; pro App ist nichts weiter zu installieren. Eine Verbindung bedient jede BOTS4.me-App, die mit Odoo arbeitet: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP und AutoCASH, plus AutoSTOCK, AutoPURCHASE und ClientFACTORY. AutoSPAM, Mail2CLOUD und Mail2KNOW brauchen nur ein Postfach, das der Connector mit einem Klick aus Ihrem Odoo übergeben kann. Sie starten jede App einzeln, über ihre Zeile in Odoo oder ihre Karte unter bots4.me/bots.

Jede App startet im DEMO-Modus: Sie liest, entscheidet und sendet Ihnen einen DEMO-Bericht, schreibt aber nichts. Wenn die DEMO-Berichte stimmen, stellen Sie Modus auf dem Tab „Steuerung“ auf LIVE — das wird nach der ersten DEMO-Berichts-E-Mail freigeschaltet. Auf bots4.me enthält der Tab Steuerung jeder App den Bot-Betrieb, den Modus, den KI-Modus (Aus, Essential-KI, Premium-KI oder Ultra, je nach App), den Ausführungsplan und die Betriebszeiten, sofern die App sie hat, sowie ihre Funktionsschalter. Der Tab Protokolle zeigt jede Entscheidung. In Odoo deckt Schnellsteuerung in der Zeile der App Bot-Betrieb, Ausführungsplan, Demo-Modus und KI-Modus ab. Was Sie zuerst automatisieren sollten, zeigt die Übersichtsanleitung: So automatisieren Sie Odoo durchgängig.

📚 Verwandte Leitfäden

• Beginnen Sie hier: Odoo durchgängig automatisieren: von der E-Mail-Bestellung bis zur bezahlten Rechnung
• Hosting: Odoo Online vs. Odoo.sh vs. On-Premise: Was lässt sich automatisieren?
• Die ersten Bots für den Einstieg: E-Mail-Bestellungen in Odoo importieren · Bankzahlungen automatisch mit Rechnungen abgleichen
• Für Integratoren: Als Odoo-Partner wiederkehrende Einnahmen erzielen

🔗 Quellen und weiterführende Literatur

Offizielle Dokumentation und Standards, auf die sich dieser Leitfaden bezieht. Externe Links öffnen sich in einem neuen Tab.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions