# Lakmus

Verbinden Sie das Lakmus-System der Klinik, damit der Agent freie Zeiten findet und Patienten Termine bei Fachärzten bucht

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Lakmus ist ein medizinisches Informationssystem für Kliniken. Nach dem Verbinden findet der Agent die Leistungen und Fachärzte der Klinik, prüft deren freie Zeiten und trägt den Termin des Patienten direkt aus dem Chat oder Anruf in Lakmus ein. Unterstützt werden sowohl die Cloud-Version als auch selbst gehostete Installationen von Lakmus.

## Bevor Sie beginnen [#before-you-start]

* **Lakmus-Adresse**, aus dem Internet per HTTPS erreichbar, z. B. `https://clinic.lakmus.org`.
* **Lakmus-API-Schlüssel** mit Zugriff auf die Booking API. Beides erhalten Sie vom Lakmus-Support oder von Ihrem Lakmus-Administrator.
* **HAPP-Workspace** mit mindestens einem Agenten, der für Gespräche mit Patienten konfiguriert ist.

## Verbinden [#connect]

1. Öffnen Sie in HAPP **Integrationen** und finden Sie Lakmus unter **CRM hinzufügen**.
2. Klicken Sie auf **Verbinden** und füllen Sie die beiden Felder aus.
3. Klicken Sie auf **Verbinden** — HAPP prüft den Schlüssel vor dem Speichern mit einer Live-Anfrage an Lakmus.

| Feld           | Wert                                                                                 |
| -------------- | ------------------------------------------------------------------------------------ |
| Lakmus-Adresse | Ihre Lakmus-Adresse, z. B. `clinic.lakmus.org` — `https://` wird automatisch ergänzt |
| API-Schlüssel  | Der für die Booking API ausgestellte Schlüssel                                       |

Der Schlüssel wird verschlüsselt gespeichert und nie wieder angezeigt.

## Einstellungen [#settings]

Klicken Sie auf der Lakmus-Karte des Agenten auf das Zahnradsymbol.

* **Online-Buchung** — der Agent durchsucht Leistungen und Fachärzte, prüft freie Zeiten (bis zu 14 Tage im Voraus) und bucht den Termin mit Namen, Telefonnummer und Beschwerden des Patienten.
* **Filiale** — freie Zeiten werden in dieser Filiale angezeigt und Buchungen dort vorgenommen. Hat die Klinik mehrere Filialen, wählen Sie eine aus: Ohne Auswahl kann der Agent nicht buchen.

Der Agent bucht nur Zeiten, die er unmittelbar zuvor als frei abgefragt hat, und teilt dem Patienten die Buchung erst mit, wenn Lakmus den Termin bestätigt hat.

## Fehlerbehebung [#troubleshooting]

| Problem                                        | Ursache                                                     | Lösung                                                                                                                 |
| ---------------------------------------------- | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| „Lakmus rejected the API key“                  | Falscher Schlüssel oder die Adresse ist keine Lakmus-API    | Prüfen Sie beides gemeinsam mit dem Lakmus-Support. Verwenden Sie die Adresse ohne Pfad — HAPP ergänzt `/api2` selbst. |
| „Host must be a public https address“          | `http://`, eine IP eines lokalen Netzwerks oder `localhost` | Lakmus muss aus dem Internet per HTTPS erreichbar sein.                                                                |
| „Choose the branch“ beim Buchen                | Die Klinik hat mehrere Filialen und keine ist ausgewählt    | Öffnen Sie die Lakmus-Einstellungen des Agenten und wählen Sie die Filiale.                                            |
| Die Telefonnummer des Patienten wird abgelehnt | Keine ukrainische Nummer                                    | Buchungen akzeptieren ukrainische Nummern (`050…`, `+380…`).                                                           |

Kommen Sie nicht weiter? [Wenden Sie sich an den Support](https://happ.tools/contacts) und geben Sie den Fehlertext an.

## Trennen [#disconnect]

Öffnen Sie **Integrationen** > **Lakmus** und klicken Sie auf **Trennen**. Der Agent bucht keine Termine mehr; bereits in Lakmus vorhandene Termine bleiben unberührt. Der Schlüssel wird in Lakmus nicht widerrufen — widerrufen Sie ihn dort bei Bedarf.

## Weiter [#next]

* [CRM](/docs/integrations/crm) — alle CRM-Integrationen
* [Tools](/docs/agents/tools) — das CRM während des Gesprächs aufrufen
* [Integrationen](/docs/integrations) — der vollständige Katalog