onOffice direkt an WordPress anbinden

Der Konnektor spricht die onOffice-API an. Dafür brauchen Sie aus onOffice heraus zwei Zeichenketten:

• einen API-Token, 32 Zeichen lang,
• ein API-Secret.

Beides legt Ihr onOffice-Administrator im API-Modul als eigenen API-Benutzer an. Der Benutzer braucht Leserechte auf die Objekte. Für den Käufer-Abgleich zusätzlich das Recht auf die Interessenten.

Das Secret verlässt Ihre Website nie. Es wird nur benutzt, um jede einzelne Anfrage zu unterschreiben, und liegt verschlüsselt in der Datenbank.

Die direkte API-Anbindung an onOffice, also Import und Käufer-Abgleich über die Schnittstelle, gehört zu MG Connector Pro. Ohne Pro-Lizenz bleibt der Konnektor gesperrt. Kostenlos ist der Weg über OpenImmo: onOffice legt die Objekte per FTP ab, und das Plugin liest sie ein, wie in den ersten Schritten beschrieben.

Öffnen Sie MG Connector › Datenquellen › Konnektoren und dort den Unterreiter onOffice.

1. Schalter Aktiv umlegen.
2. API-Token einfügen.
3. API-Secret einfügen.
4. Speichern. Erst danach sind die Werte für Test und Import da. Beim Speichern prüft das Plugin die Verbindung, erst dann lässt sich onOffice als Hauptquelle wählen.

Unter den Feldern steht eine Zeile Gespeichert: mit zwei Häkchen, eines für Token, eines für Secret. Stehen beide auf grün, ist alles da.

Das Secret-Feld bleibt nach dem Speichern leer und zeigt nur Punkte. Das ist Absicht: Es wird nicht zurück in den Browser geschickt. Leer lassen heißt „unverändert”. Nur wenn Sie wirklich etwas hineinschreiben, wird es ersetzt.

Das ist der Schritt, der am häufigsten vergessen wird, und ohne ihn passiert später nichts.

1. MG Connector › Datenquellen › Import-Einstellungen öffnen.
2. Bei Hauptquelle (Objekte) auf onOffice (API) stellen. Diese Auswahl ist erst möglich, nachdem Token und Secret gespeichert und dabei erfolgreich geprüft wurden.
3. Speichern.

Importiert wird ausschließlich aus der Hauptquelle. Ein Konnektor kann „aktiv” sein, ohne die Hauptquelle zu sein: Dann funktioniert nur der Verbindungstest, der Knopf „onOffice jetzt importieren“ bleibt ausgegraut. Das Plugin weist im Reiter darauf hin und nennt die gerade aktive Quelle.

Zur Kontrolle steht oben auf der Seite Datenquellen eine Statuszeile, zum Beispiel „Hauptquelle: onOffice (API), Verbindung geprüft am …“.

Der Knopf Verbindung testen holt ein einziges Objekt und meldet zurück, wie viele onOffice insgesamt hat. Kommt eine Zahl, steht die Verbindung.

Der Test funktioniert auch dann, wenn onOffice nicht die Hauptquelle ist. Er sagt also nur etwas über die Zugangsdaten aus, nicht darüber, ob importiert wird.

Zwei Knöpfe, und die Reihenfolge ist wichtig.

• Vorschau (Dry-Run). Zeigt, was neu hinzukäme, was schon da ist und was entfiele, dazu Status und Datenqualität je Objekt. Es wird nichts geschrieben.
• onOffice jetzt importieren. Holt die Objekte samt Bildern und Ansprechpartnern. Der Import läuft in Portionen mit einem Fortschrittsbalken.

Sehen Sie sich die Vorschau wirklich an. Sie ist die einzige Stelle, an der Sie vor dem Schreiben erkennen, ob die Zuordnung stimmt und ob Objekte fehlen, die Sie erwarten.

Die Bilder lädt das Plugin nach dem Import im Hintergrund nach, deshalb erscheinen sie zeitversetzt. Den Stand zeigt der Abschnitt Objektbilder (Nachladen) mit der Zahl der noch offenen Bilder. Mit Bilder jetzt nachladen stoßen Sie es auch selbst an.

Über die API holen Sie neue und geänderte Objekte mit dem Knopf onOffice jetzt importieren. Der Import läuft in Portionen mit Fortschrittsanzeige, damit auch große Bestände vollständig ankommen. Die Bilder laden danach im Hintergrund nach.

Der Schalter Automatischer Sync ist derzeit gesperrt. Ein stündlicher Abgleich im Hintergrund läuft über diesen Weg also nicht. Wer neue Objekte ohne Klick auf der Website haben möchte, stellt die Hauptquelle stattdessen auf den OpenImmo-Export aus onOffice um: Den holt MG Connector auf Wunsch stündlich selbst ab. Beide Wege laufen nie gleichzeitig, die Objektnummer verhindert beim Wechsel Dubletten.

Bei onOffice läuft der Abgleich zwischen einem Objekt und Ihren Interessenten nicht auf Ihrer Website, sondern bei onOffice selbst. Das Plugin fragt die passenden Interessenten dort ab.

Daraus folgt zweierlei: Es braucht keinen Umkreis-Zwischenspeicher und kein Geokodieren, und die Trefferzahl ist genau die, die onOffice auch intern sieht.

Im Reiter steht dafür ein Testlauf. Sie geben Ort, Höchstpreis, Objekttyp und Zimmerzahl ein und bekommen die Anzahl passender Interessenten zurück. Nur die Anzahl: Es werden keine personenbezogenen Daten geholt und nichts gespeichert.

Die Fehlermeldungen des Konnektors sind unterschiedlich zu lesen.

• „onOffice lehnt die Anfrage ab.” Die Anfrage kam nicht einmal bis zur Aktion. Fast immer ist Token oder Secret falsch. Zweithäufigste Ursache: Die Uhr Ihres Servers geht falsch. Jede Anfrage trägt einen Zeitstempel, und onOffice lässt nur zwei Minuten Abweichung zu.
• „onOffice-Aktion fehlgeschlagen … errorcode …” Die Anmeldung hat geklappt, die Aktion nicht. Meist fehlen dem API-Benutzer die Rechte für genau den Bereich, der in der Meldung steht. Die Meldung nennt ihn beim Namen.
• Test läuft, der Import-Knopf ist ausgegraut. onOffice ist nicht die Hauptquelle. Zurück zu Schritt 2.
• Ein Feld fehlt bei allen Objekten. onOffice-Felder sind je Kunde benannt. Melden Sie sich bei uns, dann sehen wir uns die Zuordnung für Ihren Mandanten an.