operanda Hilfe

casavi anbinden

Das Mieterportal casavi verbinden: Objekte, Mieter, Vorgänge, Dokumente, Schwarzes Brett und Zählerstände im Chat.

Mit deinem operanda-KontoJetzt verbinden

casavi ist das Kunden- und Mieterportal für Hausverwaltungen: Vorgänge (Tickets) mit Kommentaren und Aufträgen an Dienstleister, Dokumente für Bewohner und Eigentümer, das Schwarze Brett mit Beiträgen und Terminen, Zähler und Zählerstände. Mit casavi verbunden sieht der Agent eure Objekte mit Einheiten und Verträgen, die Kontakte, wer für ein Objekt zuständig ist, und den Verlauf jedes Vorgangs. Er beantwortet Fragen wie „Welche Vorgänge in der Lindenstraße 12 sind noch offen?“, „Wer wohnt in Einheit 7?“ oder „Was hat der Hausmeister gestern zum Heizungsausfall geschrieben?“.

Mit der passenden Stufe legt er Vorgänge an und ändert sie, schreibt interne Notizen, erfasst Zählerstände, antwortet dem Mieter im Portal, veröffentlicht Beiträge und Termine, stellt Dokumente ins Portal und erteilt Aufträge an Dienstleister.

Was du vorher brauchst

WerWas
casavieinen Administrator, der API-Zugangsdaten anlegen darf
DuAPI-Key und Secret, siehe Schritt 1
operandaRolle Inhaber oder Verwaltung, wenn das Konto der Firma gehören soll; sonst reicht jedes Mitglied

Mieter und Eigentümer sind Personendaten. Verbinde casavi nur, wenn das im Unternehmen abgestimmt ist, und gib das Konto nur den Projekten, die es wirklich brauchen.

Schritt 1: API-Zugangsdaten in casavi anlegen

  1. In casavi als Administrator anmelden.
  2. Administration, dann Allgemein, dann API-Zugangsdaten.
  3. Ein neues Paar anlegen und einen Namen vergeben, etwa „operanda“. casavi zeigt danach API-Key und Secret. Das Secret zeigt casavi nur dieses eine Mal; verlierst du es, legst du ein neues Paar an.
  4. Beides kopieren.

Was der Zugang sehen und ändern darf, stellt ihr in casavi ein. Manche Bereiche gehören nicht zu jedem casavi-Vertrag, etwa Zählerstände oder Aufträge an Dienstleister.

Schritt 2: Konto verbinden

  1. Konten, dann Konto verbinden, dann casavi.
  2. Wem gehört das Konto?
    • Mir: Nur du entscheidest, welche Projekte es benutzen.
    • Der Firma: Die Leitung entscheidet, und das Konto bleibt, wenn du gehst. Diese Wahl sehen nur Inhaber und Verwaltung.
  3. API-Key und Secret eintragen. Eine Bezeichnung ist freiwillig und hilft, wenn ihr mehrere casavi-Konten verbindet.
  4. Verbinden. operanda holt damit ein Token und liest einmal die erste Seite eurer Objekte, ändert aber nichts. Erst wenn casavi das Paar annimmt, wird das Konto gespeichert, Key und Secret verschlüsselt.
  5. Bei „Wer soll es benutzen?“ die Projekte einschalten. Eingeschaltet heißt Lesen.

Aus einem Projekt geht es auch direkt: im Projekt unter Konten auf Konto hinzufügen, dann Neues Konto verbinden. Das Konto heißt danach „casavi“ mit der Zahl der Objekte, etwa „casavi (48 Objekte)“.

Schritt 3: Recht im Projekt einstellen

StufeWas der Agent darf
LesenObjekte, Einheiten, Verträge, Kontakte, Zuständigkeiten, Mitarbeitende, Tickets mit Kommentaren und Aufträgen, Dokumente, Beiträge, Termine, Zähler und Zählerstände sehen
Bearbeitendazu Tickets anlegen und ändern, interne Kommentare schreiben und Zählerstände erfassen
Senden & Löschendazu Kommentare schreiben, die der Mieter im Portal sieht, Beiträge am Schwarzen Brett veröffentlichen, Termine anlegen, Dokumente ins Portal stellen, Aufträge an Dienstleister erteilen und Tickets löschen

Ein Ticket anlegen fragt der Agent im Chat vorher auf einer Karte nach. Ein Kommentar, der nicht intern ist, erreicht den Mieter im Portal und in der App, und er bekommt eine Benachrichtigung. Beiträge, Termine und Dokumente sehen alle Bewohner, für die sie freigegeben sind. Deshalb steht all das unter Senden & Löschen: Was einmal draußen ist, lässt sich nicht zurückholen.

Drei Dinge, die beim Arbeiten mit casavi auffallen:

  • Referenz-IDs. Jede Kennung, die der Agent benutzt, ist die Referenz-ID aus eurem Verwaltungsprogramm, also die Nummer, mit der das Objekt, die Einheit oder der Kontakt nach casavi importiert wurde. Bei Impower-Kunden ist das die Kennung im Feld casaviId. casavis eigene Nummern (internalId) nimmt er nirgends.
  • Kontakte nur lesen. Mieter, Eigentümer und Bewohner kommen aus dem Import eures Verwaltungsprogramms. Über die Schnittstelle lassen sie sich lesen, aber nicht anlegen oder ändern.
  • Dokumente kommen zeitversetzt an. Ein Dokument ins Portal stellen ist in casavi ein Auftrag im Hintergrund. Der Agent bekommt eine Auftragsnummer (jobId) zurück und kann mit casavi_job nachsehen, ob der Import fertig ist.

Prüfen, ob alles stimmt

Am Konto unter Mehr auf Verbindung prüfen tippen. operanda holt dann ein frisches Token und liest die erste Seite der Objekte, ändert aber nichts. Danach im Chat des Projekts „Welche Vorgänge in casavi sind offen?“ fragen.

Was du siehstWoran es liegtWas hilft
„casavi hat Key oder Secret abgelehnt“falsch kopiert, oder das Paar wurde in casavi gelöschtin casavi unter API-Zugangsdaten nachsehen; fehlt das Paar, ein neues anlegen und neu verbinden
„casavi verweigert diesen Aufruf (403)“dem API-Zugang fehlt ein Recht, oder euer casavi-Vertrag enthält den Bereich nicht, etwa Zählerstände oder Aufträgein casavi die Rechte des Zugangs ansehen; sonst bei casavi nach dem Modul fragen
„casavi kennt das Gesuchte nicht (404)“die Referenz-ID gibt es in casavi nicht, oder der Agent hat eine interne Nummer benutztdas Objekt oder den Kontakt im Chat erst suchen lassen und die id aus der Antwort nehmen
Am Konto steht „neu verbinden nötig“das Paar wurde in casavi gelöscht oder ersetztin casavi ein neues Paar anlegen, dann am Konto unter Mehr auf Neu verbinden; Projekte, Apps und Rechte bleiben

Trennen unter Konten, casavi öffnen, Trennen. Key und Secret werden bei operanda gelöscht. Das Paar bleibt in casavi bestehen, bis du es dort unter API-Zugangsdaten löschst.

casavi gehört der casavi GmbH mit Sitz in München.

Quellen

Mehr zu Verbindungen