AthausDoku

Eigenes System anbinden: Abgleich mit deinem CRM

Objekte mit deiner eigenen Nummer abgleichen, Fehlendes strukturiert lesen, die Anschrift verbergen und Anfragen in dein eigenes System holen.

Zuletzt aktualisiert:

Für den Abgleich mit deinem CRM nutzt du Athaus für Anbieter mit einem ath_-Schlüssel.

Objekte mit deiner eigenen Nummer

save_property nimmt external_id an, die Objektnummer deines Systems.

  • Dieselbe external_id ändert immer dasselbe Objekt, eine neue legt ein eigenes an, auch an einer Anschrift, die schon ein Objekt trägt.
  • Ohne external_id ergibt dieselbe Straße, Hausnummer und Postleitzahl kein zweites Objekt; der Aufruf nennt die Kennung des vorhandenen (adresse_vergeben).
  • Die Nummer steht in get_property, search_properties und im Ergebnis von save_property. Wo ein Werkzeug property_id nimmt, geht auch die external_id.
  • Trägt ein Objekt schon eine andere Nummer, ändert der Aufruf nichts und sagt es.

Die Nummer gilt je Büro: zwei Büros dürfen dieselbe führen.

Dateien

files[] an save_property werden angehängt, nie ersetzt. Eine Datei, deren Inhalt schon am Objekt liegt, wird übersprungen (verglichen wird der Inhalt, nicht der Name). Das Ergebnis nennt sie unter files.skipped mit already_present und der file_id der vorhandenen. Ein Abgleich darf darum bei jedem Durchgang dieselben Dateien mitschicken. Entfernen geht mit delete_item und kind: "file", immer mit Klick.

Preis ändern und Veröffentlichen ohne Klick

Zwei Arten stehen unter Einstellungen, Freigaben, zu Beginn auf Vorher fragen:

ArtAuf Automatisch
Inserat veröffentlichenpublish_listing geht ohne Klick online, wenn die Prüfung besteht und der Schlüssel freigeben trägt. Auf Aus nimmt das Werkzeug nichts an.
Preis ändernEin Preis, den dein Schlüssel in save_property ausdrücklich nennt (angebotspreis, price_change_eur, price_change_pct), steht sofort am Objekt, mit freigeben. Sonst wartet er als Vorschlag.

Preise, die Athaus aus Mails oder Unterlagen liest, warten immer auf ein Ja.

Wenn zum Inserat etwas fehlt

publish_listing antwortet mit isError, dem Code unvollstaendig (_meta["athaus/code"]) und einem structuredContent:

{
  "property_id": "0f6b9a3e-2c11-4d5e-9a77-4b1d2e3f4a5b",
  "check": {
    "ready": false,
    "photos_missing": true,
    "next_question": "Welcher Preis soll im Inserat stehen?",
    "missing": [
      { "field": "preis", "group": "preis", "question": "Welcher Preis soll im Inserat stehen?", "save_field": "fields.angebotspreis" }
    ]
  },
  "waiting_for_click": false
}

missing[].field ist der stabile Code der Pflichtangabe (etwa street_address, preis, energie_klasse), group ihre Gruppe (wo, eckdaten, preis, energie, text), save_field sagt, wohin der Wert in save_property gehört. photos_missing ist true, solange kein Foto am Objekt liegt.

Anschrift im Inserat verbergen

adresse_zeigen steht in fields von save_property:

WertDas Inserat zeigt
exaktStraße mit Hausnummer, Postleitzahl und Ort
strasseStraße ohne Hausnummer, Postleitzahl und Ort
ortnur Postleitzahl und Ort

Die Wahl gilt überall, wo das Inserat die Anschrift zeigt, auch im OpenImmo-Export. Der Kartenpunkt ist bei strasse auf rund 100 Meter, bei ort auf rund einen Kilometer gerundet. Weniger Anschrift zeigt jede Verbindung, mehr nur ein eigener ath_-Schlüssel.

Anfragen in dein eigenes System

Anfragen landen in Athaus, das Büro bekommt eine Mail. Drei Wege bringen sie zusätzlich in dein System.

Automation mit Webhook

Lege unter Automationen eine an: Auslöser Neue Anfrage, Schritt Aufruf senden (für Technik). Athaus ruft deine https-Adresse sofort auf (Port 443 oder 8443, öffentlich erreichbar), bei POST mit einem JSON-Rumpf aus den Feldern, die du festlegst. Variablen unter anderem:

  • anfrage.vorname, anfrage.name, anfrage.email, anfrage.telefon: der Interessent (bei Katalog-Anfragen nur mit Freigabe, siehe unten).
  • anfrage.nachricht, .quelle, .stand, .eingegangen, .link: Text, Herkunft, Stand, Zeitpunkt, Link in Athaus.
  • anfrage.eigenkapital_vorhanden, .finanzierung_bestaetigt (ja oder leer) und die Hauptangaben .finanzierung, .zeitrahmen, .nutzung, .budget, .haushalt_personen, .beschaeftigung, .haustiere, .wbs, .unterlagen (Suchender).
  • objekt.titel, objekt.adresse, objekt.link: das Objekt.

Jeder Aufruf trägt einen Idempotency-Key, eine Wiederholung denselben. Antwortet deine Adresse nicht mit einem Erfolg, steht das im Lauf der Automation.

Abholen mit since und cursor

search_inquiries liefert mit since (ISO 8601) nur Anfragen danach, die ältesten zuerst. Mit limit (höchstens 25) bekommst du eine Seite; steht next_cursor im Ergebnis, gibst du ihn unverändert als cursor zurück.

{ "since": "2026-11-10T08:00:00Z", "limit": 25, "cursor": "2026-11-10T09:14:02.118Z|0f6b9a3e-2c11-4d5e-9a77-4b1d2e3f4a5b" }

Nimm den angefragt_am der zuletzt verarbeiteten Anfrage als nächstes since. Alle 30 bis 60 Sekunden genügt (Grenzen). Die Einzelheiten holst du mit get_inquiry.

Name und Kontakt eines Suchenden aus dem Katalog hängen an seiner Freigabe. Solange sie gilt, tragen search_inquiries, get_inquiry (kontakt) und die Automation den ganzen Namen, die Mailadresse und das Telefon. Ohne Freigabe oder nach einem Widerruf ist der Name gekürzt ("Vorname N."), kontakt ist null, anfrage.email und anfrage.telefon sind leer; antworten kannst du im Faden. Anfragen von Portalen, von deiner Website und vom Büro erfasste tragen ihre Kontaktdaten wie bisher. Bei einem Widerruf löschst du, was dein System schon hat.

Der Suchende hinter einer Katalog-Anfrage

Kommt eine Anfrage über den Katalog von einem Suchenden mit Profil, tragen search_inquiries, get_inquiry und die Automation seine Hauptangaben: dieselben, die das Büro im Steckbrief der Anfrage sieht, Kategorien statt Beträge.

FeldInhalt
eigenkapital_vorhanden, finanzierung_bestaetigttrue, wenn der Suchende es angegeben hat (nur Kauf), sonst null. Nie ein Betrag, nie false.
hauptangaben.artkauf oder miete; bestimmt, welche Felder darunter gefüllt sein können.
finanzierungKauf: cash, mortgage_approved oder mortgage_planned.
zeitrahmenasap, 3_months, 6_months oder flexible (bei Miete der Einzug).
nutzungKauf: own_use oder investment.
budgetKauf: passt, knapp oder darunter gegen den Preis des Objekts. Nie der Betrag.
haushalt_personen, beschaeftigung, haustiere, wbsMiete: Haushalt, Beschäftigung (employed, self_employed, civil_servant, retired, student, other), Haustiere, Wohnberechtigungsschein (nur true).
unterlagenWie viele Papiere in der Mappe liegen.

Ein Wert steht da, wenn der Suchende ihn für diese Anfrage geteilt hat, sonst null; Athaus schließt nichts aus anderen Angaben. Der Block fehlt bei Anfragen von Portalen, von deiner Website, bei vom Büro erfassten und ohne Mappe, nach einem Widerruf ebenfalls. Name, Mailadresse und Telefon enthält er nie.

Ereignisse mit eigenem OAuth-Client

inquiry.received kommt als signierte Nachricht (MCP Events) mit Kennungen; Details holst du mit get_inquiry. Abonnieren geht nur über OAuth, also mit einem eigenen OAuth-Client, nicht mit einem Schlüssel. Ablauf und Signatur: Events.

Weiter lesen

Auf dieser Seite