Lakmus
Connect the clinic's Lakmus so the assistant finds free time and books patients to specialists
Lakmus is a medical information system for clinics. Once it is connected, the assistant finds the clinic's services and specialists, checks their free time, and books the patient into Lakmus right from the chat or call. It works with both cloud and self-hosted Lakmus.
Before you start
- Lakmus address reachable from the internet over HTTPS, e.g.
https://clinic.lakmus.org. - Lakmus API key with access to the Booking API. Both are issued by Lakmus support or your Lakmus administrator.
- HAPP workspace with at least one assistant configured to talk to patients.
Connect
- In HAPP open Integrations and find Lakmus under Add a CRM.
- Click Connect and fill in the two fields.
- Click Connect — HAPP checks the key with a live request to Lakmus before saving it.
| Field | Value |
|---|---|
| Lakmus address | Your Lakmus address, e.g. clinic.lakmus.org — https:// is added automatically |
| API key | The key issued for the Booking API |
The key is stored encrypted and is never shown again.
Settings
Open the gear icon on the assistant's Lakmus card.
- Online booking — the assistant searches services and specialists, checks free time (up to 14 days ahead), and books the patient with their name, phone, and complaints.
- Branch — free time is shown and bookings are made in this branch. If the clinic has several branches, pick one: without it the assistant cannot book.
The assistant books only a time it has just seen as free, and tells the patient they are booked only after Lakmus confirms the appointment.
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| "Lakmus rejected the API key" | Wrong key, or the address is not a Lakmus API | Check both with Lakmus support. Use the address without a path — HAPP adds /api2 itself. |
| "Host must be a public https address" | http://, an IP of a local network, or localhost | Lakmus must be reachable from the internet over HTTPS. |
| "Choose the branch" when booking | The clinic has several branches and none is selected | Open the assistant's Lakmus settings and pick the branch. |
| The patient's phone is rejected | Not a Ukrainian number | Bookings accept Ukrainian numbers (050…, +380…). |
Still stuck? Contact support with the error text.
Disconnect
Open Integrations > Lakmus and click Disconnect. The assistant stops booking; appointments already in Lakmus stay untouched. The key is not revoked in Lakmus — revoke it there if needed.
Next
- CRM — all CRM integrations
- Tools — call the CRM during conversations
- Integrations — the full catalog
Help me solve it
Happ answers right away and hands over to a manager when needed.