Skip to main content

Semble Integration

The Semble integration is built for clinics that run their diary in Semble. Once connected, visitors can book an appointment from the widget, and your AI chat and voice agents can book one in conversation. Each booking goes straight into your Semble diary against a real patient record, for the appointment type, clinician, and location the patient picked.

Connecting Semble​

  1. Go to Settings → Integrations and find the Semble card (Clinic Calendar) under Calendars & booking.
  2. Click Connect Semble.
  3. In Semble, go to Settings > API Access > New, create a token, and paste it into Semble API token.
  4. Click Connect. Once the token checks out you'll see "Semble connected — now choose what to book" and move straight on to the booking settings.

The token needs access to the practice, users, products, availability, bookings, and patients (create, update, and delete bookings; create patients), plus Semble's four webhook permissions so that changes you make in Semble sync back straight away.

Choosing what patients can book​

The Semble booking settings step lists what your practice offers. Tick at least one of each:

  • Appointment types: your bookable Semble appointment products, with their length (for example "New patient (30 min)").
  • Clinicians: who patients can book with. If your practice has availability that isn't tied to a clinician, it appears here as General.
  • Locations: your Semble sites.

Click Save & enable booking. Every ticked combination becomes something a patient can choose: an appointment type, with a clinician, at a location. When you tick more than one clinician, patients can also pick any available clinician, and whoever is free at that time gets the booking. The modal tells you how many options patients will see and warns you if the list gets long (more than 20). In that case, consider ticking fewer.

Booking turns on as soon as you save. Until then the card says "Choose what to book to turn booking on". Once it's on, the card shows the practice you're connected to and how many appointment types, clinicians, and locations patients can choose from. Click Booking settings on the card at any time to change your choices.

What patients see​

When a patient books from the widget, they choose first and then pick a time:

  1. Location (only shown when you offer more than one), then Clinician, then Appointment type, then Continue. If you offer just one option, this step is skipped.
  2. The calendar shows free times for that choice only: the clinician's real Semble availability, split into slots as long as the appointment type.
  3. If that choice has no free time, the widget says "No available times for this choice. Go back and pick another clinician or location." so the patient can try a different option.

When your AI agent books by chat or on a call, it asks the same questions in conversation: what kind of appointment they need, whether they want a particular clinician or anyone available, and which location. It never guesses a choice. If there's no free time, it says so and offers another clinician or location.

To book, Knock Knock needs an email address or a phone number. The patient is matched to an existing Semble patient by exact email first, then by phone number, and only a new patient gets a new record (with their name, email, and phone). Bookings carry the comment "Booked via Knock Knock". No clinical information is read or written.

See Meeting Booking for the rest of the booking flow.

Changes made in Semble​

If your team moves or cancels a booking inside Semble, Knock Knock picks it up. The visitor's booking is updated or marked cancelled, and you get the usual notification. Semble normally tells Knock Knock straight away. If it can't (webhooks aren't enabled for your practice, or Semble paused them after failed deliveries), the card shows a note such as "Live updates from Semble are off … changes made in Semble sync every 15 minutes", and changes are picked up every 15 minutes instead.

Moving a meeting from the widget or through the AI keeps the same clinician and only offers times they're free. Cancelling deletes the booking in Semble, and Semble sends the patient its own cancellation message.

How Semble fits with other calendars​

Semble is the last calendar in the priority order. If LeadConnector, HubSpot meetings, Calendly, Google Calendar, or Jobber is also connected for booking, that one is used instead. Semble only takes priority over a custom booking link.

Replacing the token​

If Semble rejects the stored token, the card turns amber with Reconnect needed. Click Replace token and paste a new one. It must belong to the same Semble practice, and your booking settings are kept. To switch to a different practice, disconnect first and then connect again.

Disconnecting​

Click Disconnect and confirm: "Your AI agent and widget will stop booking into Semble. Existing Semble appointments are not affected."

Next Steps​