Bots & Agents

SchnellterminAgent

SchnellterminAgent ist ein von Nutzer:innen ausgelöster Abrufdienst von Schnelltermin.at.

Er läuft weder regelmäßig noch im Hintergrund.

Eine Anfrage wird nur ausgelöst, wenn eine Patientin oder ein Patient auf Schnelltermin eine Suche startet und für die zu dieser Suche passenden Gesundheitsanbieter aktuelle Verfügbarkeiten benötigt werden.

Die vom SchnellterminAgent abgerufene Live-Verfügbarkeit wird direkt in den Suchergebnissen angezeigt und kann genutzt werden, um die Ergebnisse nach dem frühesten freien Termin zu sortieren.

Der SchnellterminAgent arbeitet daher nicht als periodischer Webcrawler und baut keinen eigenen Index externer Buchungsplattformen auf.

Schnelltermin nutzt zwei unterschiedliche technische Systeme, um öffentlich verfügbare Terminverfügbarkeiten abzurufen:

SchnellterminBotEin geplanter, robots.txt-konformer Crawler für die regelmäßige Aktualisierung von Verfügbarkeiten.Mehr erfahren

SchnellterminAgentEin von Nutzer:innen ausgelöster Abrufdienst, der die aktuelle Verfügbarkeit prüft, wenn jemand auf Schnelltermin eine Suche startet.Diese Seite

Beide Systeme sind darauf ausgelegt, möglichst wenige Anfragen zu stellen, unnötige Last auf externen Plattformen zu vermeiden und die eigentliche Buchung beim ursprünglichen Buchungsanbieter zu belassen.

So funktioniert SchnellterminAgent

Schnelltermin kennt den Gesundheitsanbieter bereits aus dem eigenen Verzeichnis und aus öffentlichen Quellen.

Auch der zugehörige Buchungsweg ist bereits bekannt — etwa über die Website der Ordination, die Website einer Klinik oder eine andere öffentliche Quelle.

Startet eine Patientin oder ein Patient eine Suche auf Schnelltermin, ermittelt Schnelltermin zuerst die passenden Gesundheitsanbieter anhand der eigenen Anbieterdatenbank von Schnelltermin.

Für relevante Ergebnisse, für die noch kein aktueller zwischengespeicherter Verfügbarkeitswert vorliegt, kann der SchnellterminAgent die Live-Verfügbarkeit über den bereits bekannten Buchungsverweis abfragen.

Die externe Buchungsplattform wird also nicht dafür genutzt herauszufinden, welche Gesundheitsanbieter zur Suche passen.

Sie dient ausschließlich dazu, die Verfügbarkeit von Gesundheitsanbietern abzurufen, die Schnelltermin bereits ermittelt hat.

Ablauf

Patient:in startet eine Suche auf Schnelltermin
        │
        ▼
Schnelltermin findet passende Gesundheitsanbieter
im eigenen Verzeichnis
        │
        ▼
für relevante Ergebnisse:
aktuelle Verfügbarkeit zwischengespeichert?
       │              │
       Ja            Nein
       │              │
       │       SchnellterminAgent
       │              │
       │       bekannter Buchungsverweis
       │              │
       │       Live-Abfrage der Verfügbarkeit
       │       beim Buchungsanbieter
       │              │
       └───────┬──────┘
               ▼
nächster freier Termin
        │
        │  12 h aktuell, höchstens 7 Tage gespeichert
        ▼
Suchergebnisse mit Verfügbarkeit
        │
        ▼
sortiert nach frühestem Termin
        │
        ▼
Patient:in wählt ein Ergebnis
        │
        ▼
ursprüngliche Buchungsplattform / Ordination

Eine eigene Schaltfläche „Verfügbarkeit prüfen“ ist nicht nötig.

Die Suche selbst löst die Verfügbarkeitsabfrage aus, wenn Live-Informationen benötigt werden.

Kein Crawling im Hintergrund

Der SchnellterminAgent unterscheidet sich bewusst vom SchnellterminBot.

SchnellterminBot

Zeitplan
   ↓
regelmäßige Verfügbarkeitsprüfung
   ↓
robots.txt-konformes Crawling im Hintergrund

SchnellterminAgent

echte Patientensuche
   ↓
relevante Gesundheitsanbieter aus der eigenen Schnelltermin-Datenbank
   ↓
Live-Verfügbarkeitsprüfung, wo nötig
   ↓
Suchergebnisse sortiert nach frühestem Termin

Der SchnellterminAgent:

durchsucht Buchungsplattformen nicht periodisch
zählt keine Anbieter- oder Ärzt:innen-IDs durch
nutzt externe Buchungsplattformen nicht, um passende Gesundheitsanbieter zu finden
aktualisiert Verfügbarkeiten nach Ablauf der Speicherdauer nicht automatisch im Hintergrund
baut keinen vollständigen Terminindex einer externen Plattform auf

Direkter Auslöser durch Nutzer:innen

Eine externe Verfügbarkeitsanfrage entsteht nur aufgrund einer echten Patientensuche auf Schnelltermin.

Beispiel:

Patient:in sucht:
„Hautarzt Wien morgen“
        │
        ▼
Schnelltermin findet passende Anbieter
im eigenen Verzeichnis
        │
        ▼
für relevante Ergebnisse ohne aktuellen Cache:
SchnellterminAgent prüft die bereits bekannten
Buchungsverweise
        │
        ▼
Live-Termine werden den Suchergebnissen hinzugefügt
und für die Sortierung nach frühestem Termin genutzt

Die Buchungsplattform wird nicht gefragt:

„Welche Hautärzt:innen in Wien passen zu dieser Suche?“

Stattdessen kennt Schnelltermin die passenden Anbieter bereits und fragt nur die Verfügbarkeit genau dieser bekannten Buchungsverweise ab.

Datenminimierung

Der SchnellterminAgent verarbeitet nur die Informationen, die zur Beantwortung der Terminsuche nötig sind.

Typischerweise sind das:

Gesundheitsanbieter
Buchungsanbieter
nächster freier Termin
Zeitpunkt der Verfügbarkeitsprüfung
Buchungslink

Vollständige externe Terminkalender werden nicht dauerhaft gespeichert.

Abgerufene Terminverfügbarkeiten gelten 12 Stunden als aktuell und werden höchstens 7 Tage gespeichert — danach nur noch zur Sortierung, nie als aktuelle Termine — und nicht dauerhaft in unserer Datenbank archiviert.

Nach Ablauf der Speicherdauer aktualisiert der SchnellterminAgent sie nicht automatisch im Hintergrund.

Erst eine neue, relevante Patientensuche kann eine weitere Live-Abfrage auslösen.

Warum speichern wir Ergebnisse zwischen?

Die Zwischenspeicherung vermeidet unnötige Anfragen an externe Buchungsplattformen.

Beispiel:

14:00
Patient:in A startet eine relevante Suche
        ↓
Dr. Beispiel ist ein passendes Ergebnis
        ↓
1 externe Live-Anfrage
        ↓
Ergebnis 12 Stunden aktuell, bis zu 7 Tage gespeichert

16:30
Patient:in B startet eine ähnliche Suche
        ↓
Dr. Beispiel ist wieder relevant
        ↓
Cache-Treffer
        ↓
keine neue externe Anfrage

Der Zwischenspeicher dient genau dazu, die Last auf externen Plattformen zu verringern.

Keine Weitergabe der medizinischen Suche

Der SchnellterminAgent soll nur den technischen Buchungsverweis übermitteln, der zum Abruf der Verfügbarkeit nötig ist.

Der externe Buchungsanbieter benötigt keine Informationen wie:

den Suchbegriff der Patientin oder des Patienten
Symptome
Diagnosen
medizinische Suchbegriffe
die Schnelltermin-Konto-ID
die E-Mail-Adresse
die Telefonnummer

Beispiel:

Innerhalb von Schnelltermin:

„Psychotherapie Wien Depression“
        ↓
Schnelltermin ermittelt Dr. Beispiel
        ↓
Externe Anfrage des Agents:

nur:
bekannter Buchungsverweis von Dr. Beispiel

Identifikation

Der SchnellterminAgent gibt sich als eigener technischer Client zu erkennen.

User-Agent

SchnellterminAgent/1.0 (+https://www.schnelltermin.at/agent)

Kontakt

[email protected]

SchnellterminBot und SchnellterminAgent sind getrennte Systeme mit eigenen Identitäten und Zugriffsmustern.

Keine Verschleierung

Der SchnellterminAgent ist nicht dafür gedacht, ausdrückliche technische Sperren zu umgehen.

Insbesondere versucht er nicht:

403
 ↓
andere IP-Adresse
 ↓
anderer User-Agent
 ↓
erneuter Versuch

oder:

CAPTCHA
 ↓
automatisch lösen

Sperrt ein Anbieter den Zugriff ausdrücklich, wird der SchnellterminAgent nicht eingesetzt, um diese Sperre zu umgehen.

Technische Grenzen

Der SchnellterminAgent greift nur auf öffentlich erreichbare Buchungsinformationen zu.

Der Agent:

umgeht keine Login-Pflicht
nutzt keine Benutzerkonten Dritter
umgeht keine CAPTCHAs
nutzt keine Sitzungen von Patient:innen zur automatisierten Datenerhebung
umgeht keine technischen Sperren durch einen Wechsel seiner Identität oder IP-Adresse

Ist kein Zugriff möglich, kann Schnelltermin weiterhin den bekannten Buchungslink anbieten und die Patientin oder den Patienten direkt zum ursprünglichen Anbieter weiterleiten.

Zugriff nur auf Auslösung durch Nutzer:innen

Der SchnellterminAgent ist nur aktiv, wenn eine konkrete Patientensuche aktuelle Verfügbarkeiten für relevante Ergebnisse benötigt.

keine Patientensuche
        ↓
0 Anfragen durch den SchnellterminAgent


Patientensuche
        ↓
passende Gesundheitsanbieter
aus der Schnelltermin-Datenbank
        ↓
für relevante Ergebnisse:
Cache vorhanden?
   │             │
   Ja           Nein
   │             │
Cache nutzen     Agent prüft
                 den bekannten
                 Buchungsverweis
        │
        ▼
Suchergebnisse erhalten
Live-Verfügbarkeit und werden
nach frühestem Termin sortiert

Verhältnis zum SchnellterminBot

Die beiden Systeme dienen unterschiedlichen Zwecken.

SchnellterminBot
────────────────────────────
regelmäßige Aktualisierung
Betrieb im Hintergrund
robots.txt-konform
niedrige Anfragerate
höchstens 24 h zwischengespeichert


SchnellterminAgent
────────────────────────────
ausgelöst durch eine echte Patientensuche
kein geplantes Crawling im Hintergrund
prüft relevante, bekannte Buchungsverweise
12 h aktuell, höchstens 7 Tage gespeichert
keine automatische Aktualisierung nach Ablauf

Eine fehlgeschlagene oder gesperrte Anfrage des SchnellterminBot wird nicht automatisch als Anfrage des SchnellterminAgent wiederholt.

Anfragen des Agents entstehen ausschließlich aus tatsächlichen Patientensuchen auf Schnelltermin.

Für Plattformbetreiber

Der SchnellterminAgent soll für Plattformbetreiber transparent und steuerbar bleiben.

Betreiber können:

den Zugriff drosseln
Anfragen sperren
Schnelltermin direkt kontaktieren
eine offizielle Integration über Schnelltermin Connect bereitstellen

Kontakt, auch für offizielle Integrationen

[email protected]

Schnelltermin Connect als bevorzugte Integration

Wo eine offizielle API oder Integration verfügbar ist, bevorzugen wir Schnelltermin Connect gegenüber automatisierten Abrufen.

Ordinationssoftware / Buchungsplattform
        │
        │ API
        ▼
Schnelltermin Connect
        │
        ▼
Verfügbarkeit in Echtzeit
        │
        ▼
Patient:in
        │
        ▼
Buchung im ursprünglichen System

Die Vorteile:

Verfügbarkeit in Echtzeit
kein automatisierter Abruf von Websites
geringere Serverlast
klare technische Schnittstelle
bessere Synchronisation
volle Kontrolle für den Plattformbetreiber

Technische Zusammenfassung

Name: SchnellterminAgent
User-Agent: SchnellterminAgent/1.0 (+https://www.schnelltermin.at/agent)
Zweck: Abruf aktueller Terminverfügbarkeiten als Antwort auf eine Patientensuche
Auslöser: Konkrete Patientensuche auf Schnelltermin
Verwendung: Live-Verfügbarkeit in den Suchergebnissen und Sortierung nach frühestem Termin
Crawling im Hintergrund: Nein
Plattformweite Ärzt:innen-Suche: Nein
Durchzählen von Ärzt:innen oder Anbietern: Nein
Zwischenspeicherung: 12 Stunden aktuell, höchstens 7 Tage gespeichert
Automatische Aktualisierung nach Ablauf: Nein
Dauerhafte Speicherung von Terminverfügbarkeiten: Nein
Historische Terminkalender: Werden nicht angelegt
Weitergabe der medizinischen Suche an den Anbieter: Nein
Umgehung von Authentifizierung: Nein
Umgehung von CAPTCHAs: Nein
IP- oder User-Agent-Wechsel zur Umgehung von Sperren: Nein
Kontakt: [email protected]