Telefonie (CTI)

Die Telefonie-Anbindung verbindet Ihre Telefonanlage mit rose: Klingelt es, sucht rose die Rufnummer im Patientenstamm und zeigt am Arbeitsplatz sofort, wer anruft — als Hinweis zum Anklicken oder direkt als geöffnete Patientenseite.

Damit ist der Behandlungsverlauf schon sichtbar, während Sie den Hörer abnehmen. Als Anbieter wird zurzeit sipgate unterstützt.

INFO

rose springt dabei nicht ins PVS — Ziel ist immer die rose-Patientenseite. Die Rufnummer wird nicht gespeichert; die Zuordnung passiert im Connector in Ihrer Praxis.

Voraussetzungen

Voraussetzung	Warum
Lizenz Telefonie (CTI)	Ohne sie erscheint der Abschnitt in den Einstellungen nicht.
PVS: charly	Nur charly liefert den Telefon-Index, mit dem rose eine Rufnummer einem Patienten zuordnen kann. Bei anderen PVS bleibt es aus.
sipgate-Konto mit sipgate.io	sipgate meldet eingehende Anrufe nur, wenn im sipgate-Konto das (kostenlose) Feature sipgate.io gebucht ist.
Gepflegte Rufnummern	Gefunden wird nur, wessen Nummer am Patienten hinterlegt ist.

Schritt 1: Personal Access Token in sipgate erzeugen

Das Token ist der Schlüssel, mit dem rose bei sipgate nachfragen darf. Damit trägt rose die Webhook-Adresse selbst ein und liest die Namen Ihrer Nebenstellen.

1. In sipgate anmelden und Personal-Access-Token öffnen: app.sipgate.com/personal-access-token
2. Rechts oben auf Hinzufügen klicken.
3. Einen Token Namen vergeben, z. B. rose, und auf Weiter klicken.
4. Die drei Berechtigungen (Scopes) aus der Tabelle unten ankreuzen.
5. Token erzeugen und Token-ID und Token kopieren.

Scope	Wofür rose sie braucht
users:read	Namen der Nebenstellen, damit sie auswählbar sind
settings:sipgateio:read	Nachsehen, welche Webhook-Adresse bei sipgate hinterlegt ist
settings:sipgateio:write	Die Adresse von rose eintragen lassen

Das Token wird nur ein einziges Mal angezeigt

Kopieren Sie es sofort. Geht es verloren, lässt es sich nicht wieder anzeigen — dann legen Sie ein neues an. Auch die Berechtigungen lassen sich später nicht ergänzen: fehlt ein Scope, brauchen Sie ebenfalls ein neues Token.

Schritt 2: In rose eintragen

Unter Einstellungen → Schnittstellen im Abschnitt Telefonie (CTI):

1. Schnittstelle oben rechts auf Aktiv stellen.
2. Als Anbieter sipgate wählen.
3. Token-ID und Token aus Schritt 1 eintragen und die Einstellungen speichern.
4. Auf Zugang testen klicken. Bei Erfolg meldet rose, wie viele Nebenstellen gefunden wurden, und listet sie auf.
5. Auf Webhook bei sipgate eintragen klicken. Danach steht dort in Grün, dass die Adresse bei sipgate hinterlegt ist — mehr ist bei sipgate nicht zu tun.

Erst speichern, dann testen

„Zugang testen" prüft die gespeicherten Zugangsdaten, nicht die gerade getippten. Wer nur tippt und gleich testet, bekommt das Ergebnis der alten Daten.

„Es ist bereits ein anderer Webhook eingetragen"

sipgate kann nur eine Adresse für eingehende Anrufe kennen. Meldet rose eine fremde Adresse, hängt dort eine andere Anbindung (z. B. ein CRM). Ersetzen Sie sie erst, wenn geklärt ist, dass diese Anbindung nicht mehr gebraucht wird — sie bekommt sonst ohne Meldung keine Anrufe mehr.

Schritt 3: Arbeitsplätze freischalten

Ob an einem Rechner etwas erscheint, entscheidet der Rechner selbst — im rose-Client unter Anrufe. Voreinstellung ist aus, jeder Arbeitsplatz wird einzeln eingeschaltet.

Einstellung	Bedeutung
Anruf-Popups	Hauptschalter für diesen Arbeitsplatz.
Welche Anrufe	alle oder nur bestimmte Nebenstellen — am Empfang meist alle, im Behandlungszimmer nur die eigene.
Nebenstellen	Auswahl der Nebenstellen. Sind Zugangsdaten hinterlegt, stehen hier die Namen; sonst ein Textfeld für die IDs (w0, w3). Leere Auswahl = kein Anruf.
Beim Anruf	Hinweis zum Anklicken oder Patientenseite direkt öffnen. Direkt geöffnet wird nur bei genau einem Treffer, sonst erscheint der Hinweis.

Warum jeder Arbeitsplatz einzeln

Das Popup zeigt Patientennamen — an einem Rechner, an dem gerade niemand angemeldet ist. Deshalb wird jeder Arbeitsplatz bewusst freigeschaltet und nicht die ganze Praxis auf einmal.

Alternative: Webhook von Hand eintragen

Hat Ihr Token die Scopes settings:sipgateio:* nicht, zeigt rose statt des Knopfes die Adresse zum Kopieren. Dann tragen Sie sie einmalig selbst ein:

1. console.sipgate.com öffnen und anmelden.
2. Links Webhooks → URLs wählen.
3. Beim Eintrag Incoming auf das Zahnrad klicken.
4. Die aus rose kopierte Adresse einfügen und speichern.

Die Adresse gilt für die ganze Praxis und ändert sich nicht — außer Sie wechseln den Anbieter. Dann muss sie neu eingetragen werden.

Wenn kein Popup erscheint

Der Weg hat mehrere Schalter, und jeder einzelne genügt, um alles stillzulegen. Von oben nach unten prüfen:

Prüfen	Wo
Schnittstelle auf Aktiv?	Einstellungen → Schnittstellen → Telefonie (CTI)
Webhook bei sipgate eingetragen?	ebenda — grüne Meldung im Abschnitt „Webhook bei sipgate"
Arbeitsplatz eingeschaltet?	rose-Client, Abschnitt Anrufe (Voreinstellung: aus)
Richtige Nebenstelle ausgewählt?	ebenda — leere Auswahl bedeutet: an diesem Arbeitsplatz erscheint nichts
Rufnummer am Patienten gepflegt?	Patientenkarte. Unterdrückte Nummern lassen sich grundsätzlich nicht zuordnen.
Connector online?	Einstellungen → Praxis → Connector — ohne ihn gibt es keine Telefonsuche

Bleibt es dabei, hilft der rose-Support weiter.

Verwandte Seiten

• Patientensuche — die Patientenseite, die beim Anruf geöffnet wird
• Einstellungen — alle Schnittstellen im Überblick