# Eigenes System anbinden: Abgleich mit deinem CRM

Adresse: https://docs.athaus.ai/mcp/eigenes-system

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

Typ: Anleitung
Zuletzt aktualisiert: 2026-11-10

Für den Abgleich mit deinem CRM nutzt du [Athaus für Anbieter](/mcp) mit einem [`ath_`-Schlüssel](/api/schluessel).

## Objekte mit deiner eigenen Nummer [#external-id]

`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 [#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 [#stufen]

Zwei Arten stehen unter [Einstellungen, Freigaben](https://app.athaus.ai/einstellungen/freigaben), zu Beginn auf **Vorher fragen**:

| Art                         | Auf **Automatisch**                                                                                                                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Inserat veröffentlichen** | `publish_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 ändern**            | Ein 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 [#fehlend]

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

```json
{
  "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]

`adresse_zeigen` steht in `fields` von `save_property`:

| Wert      | Das Inserat zeigt                            |
| --------- | -------------------------------------------- |
| `exakt`   | Straße mit Hausnummer, Postleitzahl und Ort  |
| `strasse` | Straße ohne Hausnummer, Postleitzahl und Ort |
| `ort`     | nur 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]

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

### Automation mit Webhook [#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](#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` [#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.

```json
{ "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](/mcp/grenzen#anbieter)). 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 [#suchender]

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.

| Feld                                                      | Inhalt                                                                                                                                                         |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `eigenkapital_vorhanden`, `finanzierung_bestaetigt`       | `true`, wenn der Suchende es angegeben hat (nur Kauf), sonst `null`. Nie ein Betrag, nie `false`.                                                              |
| `hauptangaben.art`                                        | `kauf` oder `miete`; bestimmt, welche Felder darunter gefüllt sein können.                                                                                     |
| `finanzierung`                                            | Kauf: `cash`, `mortgage_approved` oder `mortgage_planned`.                                                                                                     |
| `zeitrahmen`                                              | `asap`, `3_months`, `6_months` oder `flexible` (bei Miete der Einzug).                                                                                         |
| `nutzung`                                                 | Kauf: `own_use` oder `investment`.                                                                                                                             |
| `budget`                                                  | Kauf: `passt`, `knapp` oder `darunter` gegen den Preis des Objekts. Nie der Betrag.                                                                            |
| `haushalt_personen`, `beschaeftigung`, `haustiere`, `wbs` | Miete: Haushalt, Beschäftigung (`employed`, `self_employed`, `civil_servant`, `retired`, `student`, `other`), Haustiere, Wohnberechtigungsschein (nur `true`). |
| `unterlagen`                                              | Wie 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 [#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](/mcp/ereignisse).
