# DB-Leads

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/db-leads/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
**DB-Leads** finds the sales mandates already hiding in your database. The database scan works through your imported contacts and their activity history for seller signals (mentioned follow-up mandates, sell intent, life events) and files evidence-backed **findings** into a review inbox. A single won mandate is worth 15 to 20k EUR in commission on average: one hit, and the tool has paid for itself.
</Lead>

## What this tool is for, and what it isn't

"Leads" can mean two very different things. DB-Leads is deliberately built for only one of them:

<DefinitionList>
  <DefItem term="New portal inquiries: not this tool">Buyers reacting to a listing or ad for the first time (portals, web forms, email). A separate tool is planned for those.</DefItem>
  <DefItem term="Sellers in your existing base: this tool">Owners who are already in your database and show seller signals, often sitting unnoticed in the activities for years. DB-Leads makes the database you already own more valuable. It is not a CRM replacement but a complement.</DefItem>
</DefinitionList>

## What it does

<FeatureGrid>
  <Feature icon="sparkle" title="Database scan">
    One click works through every imported contact in two stages: a free prefilter (time window, exclusions, signal keywords like "Folgeauftrag"), then AI deep analysis per candidate. Runs in the background and is resumable.
  </Feature>
  <Feature icon="check" title="Findings inbox">
    Every finding comes with a seller score (0 to 100), signals with evidence quotes, and a one-liner. Accept, dismiss, or snooze: the decision is always yours.
  </Feature>
  <Feature icon="sparkle" title="AI briefing per lead">
    A detail page per lead: situation summary, next step, ready-to-send opener, signals, sales-readiness. **Every statement is backed by evidence** from a concrete activity.
  </Feature>
  <Feature icon="users" title="Pipeline board & list">
    Accepted findings move through freely configurable stages. Drag & drop, or work the sortable, searchable list, including the "Last contact" filter.
  </Feature>
  <Feature icon="link" title="onOffice connection">
    Your existing database is imported and made scannable: addresses and activities, in the background, scaling to 15,000+ entries. Re-syncing updates instead of duplicating.
  </Feature>
  <Feature icon="users" title="Customer view & REOS AI">
    One click expands any lead into its own enterprise page with all facts, the briefing and the history. Alongside it the platform assistant works directly with this lead, dossier attached automatically.
  </Feature>
  <Feature icon="clock" title="Refresh contact details">
    Send a contact an email with a personal link so they can check their own details. Whatever comes back lands on the record. The drawer shows per contact what is still open and what has been answered.
  </Feature>
  <Feature icon="check" title="Run-through">
    The mode for an afternoon on the phone: the visible list becomes a queue. Read, call, press one of five outcomes, next contact. Every outcome writes to the history and to the onOffice log.
  </Feature>
  <Feature icon="link" title="Ownership">
    Which properties a contact owns, read from correspondence: address, type, size, year built, each with its evidence. Exactly what sits in no record before the mandate. You can add and confirm entries yourself.
  </Feature>
</FeatureGrid>

## Getting started

<Steps>
  <Step title="Install the tool">
    Install **DB-Leads** from the marketplace. On install, a sensible default pipeline is created, including signals and disqualification reasons.
  </Step>
  <Step title="Import your database">
    Connect onOffice (see below) and import your database: addresses and activities. If you want to look around first, you can deliberately load sample data in the setup assistant. It is labelled as such everywhere and disappears automatically once you connect your real onOffice.
  </Step>
  <Step title="Start the database scan">
    Start the **database scan** from the tool page. The free prefilter checks every contact; the AI analyzes the candidates inside the time window.
  </Step>
  <Step title="Review the findings">
    Open the **Findings** view and work through the suggestions: accept, dismiss, or snooze.
  </Step>
</Steps>

<Tip title="Works out of the box">
If no AI model is configured yet, REOS AI uses a deterministic fallback briefing. The tool works from minute one, even without a provider key.
</Tip>

## Settings

Settings (gear icon, top right, `/settings/tools/db-leads`) are organized into five groups, in the order of the work. Every area has its own address (`/settings/tools/db-leads/<area>`):

<DefinitionList>
  <DefItem term="Connection">onOffice (CRM connection, start a sync by hand) and Synchronization (inventory, last run, errors, progress). The settings open here.</DefItem>
  <DefItem term="Finding">Database scan (time window, signal keywords, auto-scan, AI limit), Qualification (what the AI recognizes and where it is written in onOffice, AGG-compliant) and REOS AI (platform AI or your own key, phase automation).</DefItem>
  <DefItem term="Working">General (assignee write-back, notes to the agents log, queue, retention), Pipeline (stages and disqualification reasons) and Rules (if-then rules with a log, details under [Rules](/tools/db-leads/regeln)).</DefItem>
  <DefItem term="Access">Grants: who additionally sees whose contacts.</DefItem>
  <DefItem term="Other">Maintenance: full scan, complete synchronization and reset.</DefItem>
</DefinitionList>

## Further guides

<CardGrid>
  <Card title="Database scan" href="/tools/db-leads/datenbank-scan">
    The core feature: prefilter, AI deep analysis, seller score, and the findings inbox.
  </Card>
  <Card title="Acquisition agent" href="/tools/db-leads/akquise-agent">
    The status engine: the AI reads the onOffice activities, derives the pipeline status, and keeps your stages sorted.
  </Card>
  <Card title="onOffice import" href="/tools/db-leads/onoffice-import">
    Connect, field mapping, background sync, and scaling to 15,000+ addresses including activities.
  </Card>
  <Card title="List, filters & export" href="/tools/db-leads/liste-filter-export">
    Filter (including "Last contact"), sort, edit many leads at once, and export the filtered set as CSV.
  </Card>
  <Card title="Customer view & AI" href="/tools/db-leads/kundenansicht">
    The enterprise detail page in a new tab and the lead-scoped REOS AI agent.
  </Card>
  <Card title="Working in the assistant" href="/tools/db-leads/assistent">
    Filter the database, read findings and dossiers, set notes, follow-ups, phases and ownership, every change after confirmation.
  </Card>
  <Card title="Rules" href="/tools/db-leads/regeln">
    The if-then rules: when something happens on a contact, the tool runs actions on its own. Starts paused, with a log.
  </Card>
  <Card title="Settings in detail" href="/tools/db-leads/einstellungen">
    Every area in five groups: Connection, Finding, Working, Access and Other.
  </Card>
  <Card title="Setup" href="/tools/db-leads/einrichtung">
    Setup in five steps: data source, import your book, write-back, opt-outs, first scan.
  </Card>
  <Card title="Board and phases" href="/tools/db-leads/board-und-phasen">
    The four views and the pipeline: your own phases, their status, drag and drop.
  </Card>
  <Card title="Durcharbeiten" href="/tools/db-leads/durchgang">
    Work a stack of contacts in one sitting: frozen queue, five outcomes, briefings prepared ahead.
  </Card>
  <Card title="Ownership" href="/tools/db-leads/objekte">
    Which properties a contact owns, with evidence. Why your own listings are not shown here.
  </Card>
  <Card title="Follow-ups" href="/tools/db-leads/wiedervorlage">
    Defer contacts as real tasks in onOffice, with a reminder on the due date.
  </Card>
  <Card title="Refresh contact details" href="/tools/db-leads/datenanfrage">
    The data request: personal link, documented consent, answer straight onto the record.
  </Card>
  <Card title="Permissions" href="/tools/db-leads/berechtigungen">
    The ten permissions, and the two deliberately preset for nobody.
  </Card>
  <Card title="Reset" href="/tools/db-leads/zuruecksetzen">
    Discard assessments and findings. Contacts and activities are never touched.
  </Card>
  <Card title="Troubleshooting" href="/tools/db-leads/troubleshooting">
    Common questions and what to do about scan, sync, AI, or permission issues.
  </Card>
</CardGrid>

<Divider label="Contact details" />

## Refreshing contact details

In a database that has grown for ten years, the most common reason a call fails is not a bad assessment but a dead phone number. Instead of guessing, you ask the person.

<Steps>
  <Step title="Ask">
    Open the contact and click "Request details" under **Data requests**. They receive an email with a personal link in the name of your office. The form asks for email, phone, address and, right at the end, whether a sale is on their mind.
  </Step>
  <Step title="Wait without chasing">
    After seven days without an answer, **exactly one** reminder goes out automatically, provided you allow that for this tool. If the action policy is set to "approval", it lands under **Approvals** and waits for your click instead.
  </Step>
  <Step title="Take the answer over">
    Whatever the person confirms is stored on the contact, and an activity is recorded as real contact. The consent at the end of the form becomes a permission in your communication settings.
  </Step>
</Steps>

The link is valid for 21 days. As long as nothing has come back you can **withdraw** it at any time; it stops working immediately. Below the list you see how many of the people contacted across the whole workspace have answered, once there are enough cases for a meaningful rate.

Two things that would otherwise surprise you:

- **The reminder carries a new link.** We cannot resend the original one because it is not stored in plain text anywhere. The old link stays valid, so anyone who finds the first email still gets through.
- **Anyone who has objected to being contacted receives nothing.** The button tells you so instead of quietly doing nothing.

<ButtonLink href="/help/compliance/datenanfrage">How data requests work</ButtonLink>

<Divider label="Integration" />

## Connecting onOffice

You set up the onOffice **connection** **centrally** under **Settings → Integrations → onOffice**, not inside the tool. That is intentional: one connection every tool uses, kept safe in one place.

<ButtonLink href="/help/integrations/onoffice">Full onOffice guide</ButtonLink>

Inside the DB-Leads tool, only the tool-specific part remains:

- **"onOffice" tab:** if onOffice isn't connected yet, a button takes you straight to Integrations. Once connected, **Sync now** imports your existing database (addresses and activities) and makes it scannable (re-run = update, not duplicate).
- **Field mapping:** which onOffice field maps to which field is managed by the central integration under Settings, Integrations, onOffice. Sensible default mappings (first name, last name, email, phone, customer no.) are set out of the box.

<Divider label="Add-on & AI" />

## What is included in the DB-Leads add-on?

DB-Leads is an add-on tool with a monthly price. Included are the AI analyses of the database scan with a fixed quota of full scans per month; incremental scans over new activity only are possible at any time and the prefilter is always free. Single briefings are billed against your credit balance, and from the Max plan you can run everything on your own provider key instead. All figures and rules: [Cost and add-on](/tools/db-leads/kosten).

## Data protection

Lead data is personal data, and owner mining needs clear boundaries:

<Callout tone="note" title="AGG- & GDPR-compliant by design">
Seller signals come exclusively from the **person's own statements** in the activities ("wants to sell", "Folgeauftrag"), never from personal attributes such as age or marital status. The score is deterministic and purely evidence-based; a human decides on every finding. Only your own customer database is analyzed (legitimate interest). When you uninstall, your data is preserved. Actually deleting it is a separate, explicit step.
</Callout>

## Frequently asked questions

Boundary to your CRM, the evidence behind each finding, anti-discrimination limits, data protection and what remains after uninstalling: [Questions and answers](/tools/db-leads/faq).
