Zum Hauptinhalt springen
Dein Assistent findet Objekte, beantwortet Fragen dazu, bietet freie Besichtigungszeiten an und bucht Besichtigungen in deinem onOffice-enterprise-Konto. Neue Anrufer legt er mit ihrem Suchprofil als Interessenten an, und beendete Anrufe kann er im Maklerbuch festhalten.
Das onOffice-API-Modul ist eine kostenpflichtige Zusatzoption. Lass es von deinem onOffice-Ansprechpartner freischalten, bevor du verbindest, und frag nach, was onOffice für die API-Nutzung berechnet.

Konto verbinden

  1. Öffne in onOffice enterprise Extras → Einstellungen → Benutzer und lege einen API-Benutzer nur für den Assistenten an.
  2. Gib dem API-Benutzer diese Rechte:
    • Adressen: lesen und schreiben.
    • Objekte: lesen.
    • Kalender: schreiben.
    • Maklerbuch: schreiben.
    Stelle die Leserechte auf alle Datensätze, nicht auf „nur eigene“. Bei „nur eigene“ antwortet onOffice auf Suchen mit leeren Listen.
  3. Kopiere den API-Token (32 Zeichen) und das API-Secret (64 Zeichen). onOffice zeigt das Secret nur einmal an. Meldet die Verbindung, dass Token und Secret vertauscht aussehen, trage sie andersherum ein.
  4. Öffne Agent Tools → Marketplace → onOffice, gib Token und Secret ein und passe die Einstellungen unten an, falls deine von den Standardwerten abweichen. Wähle Hinzufügen. Die Verbindung wird geprüft, bevor sie gespeichert wird. Weise sie danach deinem Assistenten zu.
Die Prüfung beim Speichern kann die Schreibrechte für Kalender und Maklerbuch nicht testen, ohne etwas zu schreiben. Fehlt ein Recht, schlägt die erste Buchung oder Notiz mit einer Meldung fehl, die es nennt.

Das kann der Assistent

Standardmäßig aktiv:
  • Objekte finden nach Straße, Ort, Kauf oder Miete, Objektart, Zimmern, Budget oder der Objektnummer aus einer Anzeige.
  • Objektdetails: Preis, Zimmer, Flächen, Etage, Baujahr, Zustand, Heizung, Kosten, Haustiere, Beschreibung und Verfügbarkeit.
  • Freie Besichtigungszeiten im Kalender des zuständigen Maklers.
  • Besichtigungen buchen, nachdem der Anrufer bestätigt hat.
  • Interessenten anlegen mit Suchprofil, nachdem der Anrufer zugestimmt hat.
  • Anrufer erkennen an der Telefonnummer.
Optional unter Bearbeiten:
  • Anrufnotizen: eine Notiz über einen beendeten Anruf ins Maklerbuch schreiben. Das ist für Automationen gedacht, siehe unten.

Welche Objekte der Assistent sieht

Die Einstellung Objekte, über die der Assistent sprechen darf entscheidet:
  • Auf deiner Website veröffentlicht (Standard): aktive Objekte, die auf deiner Website veröffentlicht sind.
  • Vermarktungsstatus offen: aktive Objekte, die weder verkauft oder vermietet noch reserviert sind, veröffentlicht oder nicht.
Straße und Postleitzahl lässt er weg, wenn in onOffice „Objektadresse freigeben“ für das Objekt ausgeschaltet ist. Inaktive und archivierte Objekte liest der Assistent nie. Er nennt die Verfügbarkeit: verfügbar, reserviert, verkauft oder vermietet. Interne Datensatznummern liest er nie vor. Die externe Objektnummer aus deinen Anzeigen ist in Ordnung.

Besichtigungen

Der Assistent bucht eine Besichtigung im Kalender des zuständigen Maklers des Objekts. Ein Objekt ohne zuständigen Makler nutzt den Standard-Makler aus den Einstellungen. Gibt es beides nicht, lässt sich das Objekt nicht buchen, und der Assistent bietet einen Rückruf des Teams an.
  • Zeiten: ab morgen, jeden Tag einschließlich Wochenende, innerhalb der Besichtigungszeiten (Standard 08:00–18:00) in deiner Zeitzone. Die Zeiten folgen einem 30-Minuten-Raster und dauern so lange wie die Dauer der Besichtigung (Standard 30 Minuten).
  • Belegte Zeiten: Jeder Kalendereintrag dieses Maklers gilt als belegt. Ganztägige Einträge blockieren den ganzen Tag. Abgesagte Einträge zählen nicht.
  • Buchung: Der Assistent fragt nach Vor- und Nachname, wiederholt Objekt, Tag und Uhrzeit und wartet auf ein klares Ja. Er prüft noch einmal, ob die Zeit frei ist, und legt dann den Termin an, verknüpft mit Objekt und Kontakt. „Gebucht“ sagt er erst, nachdem onOffice bestätigt hat.
  • Kontakte: Ein Kontakt mit der Nummer des Anrufers wird wiederverwendet. Mehrere Kontakte mit einer Nummer unterscheidet er am Nachnamen. Sonst legt er einen neuen Kontakt an, mit E-Mail-Adresse nur, wenn der Anrufer eine genannt hat.
  • Unterdrückte Nummern: Anrufer, die ihre Nummer verbergen, können nicht buchen. Der Assistent bietet einen Rückruf an.
Der Termin nutzt den Termintyp für Besichtigungen aus den Einstellungen (Standard Besichtigung). Seine Notiz nennt, wer gebucht hat, mit deiner Marke. Ein Timeout beweist nicht, dass eine Buchung gescheitert ist. Wiederholte Anfragen sind gegen Doppelbuchungen geschützt. Meldet der Assistent ein unbekanntes Ergebnis, prüfe den Kalender des Maklers, bevor du erneut buchst.

Interessenten

Sucht ein Anrufer ein Objekt, sammelt der Assistent Vor- und Nachname, Kauf oder Miete und alles, was der Anrufer nennt: Ort, Objektart, Zimmer und Budget. Nach einem klaren Ja speichert er den Anrufer als Kontakt und ergänzt ein Suchprofil mit diesen Wünschen.
  • Ein Kontakt mit derselben Nummer wird wiederverwendet statt doppelt angelegt.
  • Eine E-Mail-Adresse wird nur geschrieben, wenn der Anrufer eine genannt hat. Es gibt keine Platzhalter-Adresse.
  • Das Profil enthält nur Kriterien, die dein onOffice-Konto als Suchkriterien anbietet.
  • Lehnt onOffice das Profil ab, bleibt der Kontakt bestehen, und der Assistent sagt, dass das Team die Wünsche ergänzt.

Anrufnotizen im Maklerbuch

Anrufnotizen sind für Assistenten aus. Nutze die Automations-Vorlage Anrufe in onOffice festhalten (New → Start from template, Kategorie CRM): Nach jedem eingehenden Anruf mit Zusammenfassung sucht onOffice nach Kontakten mit der Nummer des Anrufers, bis zu drei, und schreibt eine Notiz in deren Maklerbuch. Die Notiz beginnt mit „Call with“ und deiner Marke, danach folgen Zusammenfassung und Gesprächsdauer.
  • Schalte Anrufnotizen für die Verbindung unter Automationen → Verbindungen ein: Sie sind standardmäßig aus, und die Vorlage schlägt fehl, bis du es tust. Nutze eine dort angelegte Verbindung, keine aus dem Agent-Tool importierte, damit der Assistent keine Anrufnotizen bekommt.
  • Aktionsart und Aktionstyp für Anrufnotizen (Standard Telefonat und Eingang) müssen in onOffice existieren. Tun sie das nicht, wird die Verbindung trotzdem gespeichert, aber Anrufnotizen werden mit einem Hinweis abgelehnt.
  • Anrufer, die nicht in onOffice stehen, bekommen keine Notiz.
  • Der Anruflink wird nicht geschrieben.
  • Vorlagen erscheinen in Workspaces von Reseller-Kunden nicht. Baue dieselbe Automation mit der Aktion onOffice · Anrufnotizen; die Telefonnummer wird nicht eingegeben, sie kommt aus dem Anruf.
Die Vorlage deckt eingehende Anrufe ab. Für ausgehende Anrufe baust du die Automation selbst mit derselben Aktion; es wird die gewählte Nummer verwendet.

Anrufer erkennen

Passt die Nummer des Anrufers zu genau einem aktiven Kontakt, begrüßt der Assistent ihn mit Namen. Teilen sich mehrere Kontakte die Nummer, fragt er nach dem Nachnamen. Ist die Nummer unterdrückt oder unbekannt, behandelt er den Anrufer als neu. Objekte sind öffentliche Daten und brauchen keine Prüfung. Der Assistent liest nie E-Mail-Adressen, Telefonnummern oder Adressen aus deinen Kontakten vor.

Einstellungen

Ändere sie unter Automationen → Verbindungen oder entferne das Tool und verbinde es erneut. Buchung, Interessenten und Anrufnotizen schaltest du unter Bearbeiten am Tool.

Sicher testen

Buchungen, Interessenten und Notizen sind echt. Teste mit einem Testobjekt, einem Kalender, den du aufräumen kannst, und deiner eigenen Telefonnummer, und lösche danach den Testtermin und den Testkontakt in onOffice. Textsimulationen rufen onOffice nicht auf.

Kanäle

Objektsuche und Objektdetails funktionieren auf jedem Kanal. Erkennung, Besichtigungen und Interessenten nutzen die Telefonnummer, die die Unterhaltung mitbringt: Telefon, WhatsApp und SMS haben eine. Webchat und E-Mail nicht, deshalb bietet der Assistent dort einen Rückruf an, statt zu buchen.

Automationen

Jede Operation steht als Aktion unter onOffice · … bereit. Verbinde onOffice unter Automationen → Verbindungen oder importiere die Agent-Tool-Verbindung. Eine Automation, die ein Anruf oder eine Textunterhaltung startet, kennt die Nummer der Gegenseite aus diesem Anruf selbst, nie aus den Auslöserdaten oder einer Schritt-Eingabe. Deshalb hat Anrufnotizen kein Feld für die Telefonnummer. Läufe, die anders starten (Webhook, Zeitplan), haben keine Nummer: Buchung und Interessenten antworten, dass sie nicht verfügbar ist, und Anrufnotizen schreiben nichts. Ein manueller Lauf hat nur dann eine Nummer, wenn seine Laufdaten einen Anruf oder eine Unterhaltung deines Workspaces nennen. Auslöser für neue Objekte oder Kontakte gibt es noch nicht.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/onoffice · MCP connect_integration · CLI famulor connect-integration onoffice. Das Tool startet mit aktivierter Objektsuche, Besichtigungen und Interessenten. client.api.connectIntegration braucht famulor-sdk 0.2.12 oder neuer. Aktualisiere die CLI mit npm install --global famulor, bevor du connect-integration verwendest.
Optionale Felder sind estate_rule (published oder open), default_agent, viewing_type, viewing_minutes, viewing_hours, log_action_kind, log_action_type und timezone.

Fehlersuche

  • „onOffice did not accept the API token, secret or rights.“ Prüfe beide Werte, prüfe, ob der API-Benutzer aktiv ist und die Rechte von oben hat, und lege Token und Secret neu an, falls du sie in onOffice neu erzeugt hast.
  • „onOffice rejected the signature.“ Token und Secret sind vertauscht, oder das Secret wurde unvollständig kopiert. Der Token hat 32 Zeichen, das Secret 64.
  • „The server clock is out of sync with onOffice.“ Das ist vorübergehend. Versuche es später erneut.
  • Suchen finden nichts, obwohl es die Objekte gibt. Prüfe, ob die Leserechte alle Datensätze umfassen und nicht „nur eigene“, und ob das Objekt zu Objekte, über die der Assistent sprechen darf passt.
  • „Check the appointment type.“ Trage den Termintyp für Besichtigungen genau so ein, wie der Aktionstyp für Termine in onOffice heißt.
  • „The action kind or type for call notes does not exist.“ Trage Aktionsart und Aktionstyp so ein, wie sie in onOffice heißen.
  • „The default agent was not found.“ Gib den Benutzernamen oder die ID eines Benutzers ein, den onOffice für den API-Benutzer auflistet.
onOffice-API-Dokumentation