Jonas Müller, Produktentwicklung, RegioScoutJede qualifizierte RegioScout-Anfrage entsteht in Ihrem Odoo CRM als eigener Datensatz — standardmäßig als Verkaufschance in Ihrer Pipeline, auf Wunsch als Lead. Kontaktdaten und Objektadresse stehen in den Standardfeldern, die Objektdaten im Reiter Notizen. Sie brauchen dafür die Adresse Ihrer Instanz und einen API-Schlüssel. Diese Seite beschreibt die Einrichtung, was in Odoo ankommt und das Verhalten bei Störungen.
Was Sie brauchen
Voraussetzungen
- Zugang
- Instanz-URL (nur HTTPS) und ein API-Schlüssel mit Bereich „RPC“
- Odoo-Variante
- odoo.com, Odoo.sh oder eigener Server
- Ab Odoo 19
- URL und Schlüssel genügen
- Vor Odoo 19
- zusätzlich Datenbank und Benutzer-Login
- Aufwand
- wenige Minuten
Einrichtung
- In Odoo oben rechts auf das Profilbild klicken, Meine Einstellungen öffnen.
- Auf den Reiter Kontosicherheit wechseln, dort Neuer API-Schlüssel.
- Als Bereich RPC wählen, den Schlüssel erzeugen und sofort kopieren — Odoo zeigt ihn nur einmal an.
- Im RegioScout-Portal unter Integrationen die Instanz-URL eintragen (die Adresse, unter der Sie sich bei Odoo anmelden, etwa
https://firma.odoo.com) und den Schlüssel einfügen. - Speichern. Das Portal prüft die Verbindung sofort und meldet zurück, welche Odoo-Version es gefunden hat.
Diese Prüfung ist rein lesend: Sie legt in Ihrem Odoo nichts an. Abgelehnte Zugangsdaten werden nicht gespeichert; alle Zugangsdaten liegen verschlüsselt. Nur HTTPS wird akzeptiert — über eine unverschlüsselte Verbindung gehen weder Kontaktdaten noch Ihr Schlüssel.
Ältere Odoo-Versionen. Ab Version 19 identifiziert der Schlüssel den Benutzer, und Ihre Instanz löst die Datenbank selbst auf — mehr als URL und Schlüssel ist dann nicht nötig. Bei älteren Versionen fragt das Portal genau die fehlenden Angaben nach: den Datenbanknamen (den es meist selbst erkennt und vorschlägt) und den Benutzer-Login, also die E-Mail-Adresse des Benutzers, zu dem der Schlüssel gehört.
Verkaufschance oder Lead
Nach der ersten Verbindung erscheint im Portal die Auswahl „Leads ankommen lassen als“:
- Verkaufschance in der Pipeline — der Standard. Sichtbar in jedem Odoo CRM, ohne Zusatzeinstellung.
- Lead — nur sinnvoll, wenn Sie unter CRM → Konfiguration → Einstellungen die Option Leads aktiviert haben. Ohne diese Option entstünde der Datensatz zwar, wäre in Odoo aber nirgends sichtbar. Deshalb ist das nicht die Voreinstellung.
Was in Odoo ankommt
Angelegt wird ein Datensatz je Anfrage. Der Titel enthält den Namen des Eigentümers und das Produktinteresse, etwa „Anfrage Maria Muster (Photovoltaik)“.
In den Standardfeldern stehen Kontaktname, E-Mail-Adresse und die bevorzugte Rufnummer — Mobil zuerst, sonst Festnetz. Die Objektadresse steht in Straße, Postleitzahl, Ort und Land.
Im Reiter Notizen stehen Anfrage-Nummer, der Link auf die vollständige Anfrage im RegioScout-Portal, die Verteilung (Exklusiv oder Multi), die zweite Rufnummer und alle im Gespräch erfassten Objektdaten — Haustyp, Dachform und Dachbelag, aktuelle Heizung und Heizungsalter, Anzahl Bewohner, Stromverbrauch, soweit vorhanden.
Vor dem Ernstfall: Test-Anfrage senden
Im Portal senden Sie unter Integrationen eine Test-Anfrage durch dieselbe Strecke wie später die echten. Sie erscheint in Odoo als „Max Mustermann (n. TEST)“, wird nach 15 Minuten automatisch gelöscht und ist auf drei Versuche je zehn Minuten begrenzt. Nutzen Sie das, um zu prüfen, ob die Datensätze in der richtigen Pipeline landen.
Wenn etwas nicht funktioniert
Die Anbindung ist ein zusätzlicher Weg, nicht der einzige. Jede Anfrage steht unabhängig davon im RegioScout-Portal und geht, wenn eingestellt, per E-Mail an Sie.
Schlägt die Übertragung fehl — Schlüssel zurückgezogen, Instanz nicht erreichbar, Wartungsfenster —, erhalten Sie eine Mitteilung im Portal mit der Fehlermeldung. Die Anfrage bleibt vollständig erhalten und lässt sich mit Erneut zustellen noch einmal senden.
War Ihre Instanz schon beim Speichern nicht erreichbar, weist das Portal Sie darauf hin und speichert die Zugangsdaten trotzdem. Prüfen Sie dann die Zustellung der nächsten Anfrage.
Zusammenspiel mit den anderen Wegen
Portal, E-Mail-Benachrichtigung und CRM-Anbindung laufen parallel; den Übermittlungsweg ändern Sie jederzeit im Portal. Wenn Sie zusätzlich eigene Systeme versorgen möchten, stehen Webhook, REST-API und CSV-Export unabhängig davon bereit.
Wie eine Anfrage entsteht, bevor sie in Ihrem Odoo landet, steht unter Wie RegioScout eine Anfrage qualifiziert.