- CategoryBookings
- AuthPersonal token
- Scopes5
Overview
Connect Dentally so the AI agent can offer free times from your practice diary and book, move and cancel appointments. It also answers questions about them, sends payment links and checks what's been paid. Setup has two parts: you paste a Personal Token on the Integrations page, then import the practice into Calendar Settings and turn it on under Calendar Sync. Once it's on, your Dentally appointments also show in the Workspace calendar, where your team can book, move and cancel them.
What MessageMind can do with it
- The AI agent finds free times with the practitioner a patient asks for by name, or with any dentist, hygienist or therapist on the day they pick.
- If a patient names a practitioner but no day, it looks for that person's first free day in the next two weeks, starting tomorrow.
- When the time a patient asks for is taken, it offers the nearest free times on the same day.
- Patients can book a check-up, a scale and polish, both together, an emergency appointment, or any other reason from your Dentally list that they ask for by name.
- Every booking is read back to the patient first. It only goes into Dentally, as Pending, once they say yes.
- Patients can move an appointment in the chat. The AI agent offers new free times and moves it in Dentally once they confirm.
- Patients can cancel an appointment in the chat. The AI agent checks which one they mean, cancels it in Dentally once they confirm and offers to book another time.
- The AI agent can send a payment link for a deposit or a balance in the conversation.
- It checks whether the patient has paid and tells them when they're all set.
- Patients can ask about their upcoming appointments and any from the last 30 days, such as one that was cancelled or missed. These are found from the email and phone number already on the conversation, so the patient isn't asked for them.
- Asked what they can book or who they can see, the AI agent answers from your appointment reasons and practitioners in Dentally.
- If your token includes patient:create, the AI agent can also register someone who isn't a patient yet. It collects their title, first and last name, email, date of birth and mobile number, creates the patient record in Dentally with a note marking it as an AI lead whose profile needs completing, then books the appointment.
- Your Dentally diary shows in Workspace > Calendar, with an All dentists filter and a search that matches patient, reason and dentist name.
- From the calendar, your team can book a new Dentally appointment, move a Pending one to another free time, or cancel a Pending or Confirmed one.
Requirements
- A Starter, Professional or Enterprise plan.
- The MessageMind account admin's login, to import the practice into Calendar Settings and turn on Calendar Sync.
- A Dentally user with Permission Level 4 (administrator) and API access switched on, to create the token.
- At least one active practitioner in Dentally.
How to connect
- Sign in to Dentally as a Permission Level 4 (administrator) user with API access switched on.
- Go to Settings > Developer > Personal Tokens and click Generate new token.
- Tick appointment:read, user:read and practice:read. All three are required.
- Tick appointment:create and patient:read as well. Booking needs both, and looking up a patient's appointments needs patient:read. Ticking appointment (all) covers both appointment permissions.
- Tick the full practice permission too. It keeps the MessageMind calendar up to date with changes made in Dentally after setup.
- Tick patient:create if you want the AI agent to register new patients. An umbrella permission covering all patient access includes it too.
- Copy the token.
- In MessageMind, open Connections > Integrations from the top bar.
- Find Dentally under Bookings, or type Dentally in the search box.
- Click Connect on the Dentally row. The Connect Dentally window opens.
- Paste the token into the apiToken field. The eye button shows or hides it.
- Click Connect. You see "Connecting to Dentally..." while the token is checked, then "Dentally connected."
- Open Workspace from the top bar and click Settings at the bottom of the left rail.
- Click Calendar Settings, then Connected Apps, then Dentally.
- Click Import from Integrations. "Dentally practice imported from Integrations." confirms it.
- Click Calendar Sync and turn on Dentally. The Calendar Sync switch at the top turns on with it.
- Click Save. The AI agent starts using your Dentally diary, and your appointments start to appear in Workspace > Calendar.
Authentication and permissions
- Mechanism
- You paste a Personal Token from Dentally. There's no Dentally sign-in window and no region to choose: practices on Dentally's UK, APAC and Canada regions all connect the same way. The connection keeps working until the token is revoked in Dentally or you disconnect.
- Credentials
- One Personal Token, created in Dentally under Settings > Developer > Personal Tokens by a Permission Level 4 (administrator) user with API access switched on. Paste it into the apiToken field in the Connect Dentally window. Import from Integrations in Calendar Settings copies it from there, so you only paste it once.
Required scopes
appointment:read, user:read and practice:read are required.appointment:create lets the AI agent and your team book new appointments.patient:read lets MessageMind find the right patient when someone books or asks about their appointments.The full practice permission keeps the MessageMind calendar up to date with appointments made or changed in Dentally.patient:create is optional. With it, the AI agent registers new patients.
Available data and actions
Reads
- Your practice's name and time zone, its sites, and its active practitioners with their roles.
- Your appointment reasons, and the appointment lengths in each site's default payment plan.
- Free times in each practitioner's diary.
- Diary appointments with the patient's name, reason, status, length, practitioner and notes, to show them in the MessageMind calendar.
- Patient records, to find the right patient when someone books or asks about their appointments. When the AI agent reads out an appointment it gives the type, day, time, practitioner and status, never the notes.
Writes
- New appointments, created as Pending. Bookings made by the AI agent carry a diary note naming the channel, such as "Booked by MessageMind AI (WhatsApp)".
- A new date and time on an appointment the patient moves in the chat, saved once they confirm.
- Cancellations a patient asks for in the chat, made once they confirm.
- A new date and time on a Pending appointment, when your team moves it from the calendar. The patient, practitioner, reason and length stay the same.
- Cancellations of Pending and Confirmed appointments, made from the calendar.
- New patient records for people new to the practice, when the token has patient:create.
AI agent use cases
- A patient on WhatsApp asks for a check-up with a named dentist. The AI agent offers that dentist's first free times, takes the patient's full name and email, and books it as Pending once they confirm.
- A caller wants a scale and polish with a hygienist on Thursday. Every hygienist's diary for that day is checked, and the caller hears who is free and when.
- A patient texts "when is my appointment?" and gets the day, time and practitioner back, found from the number they're texting from.
- A patient on WhatsApp can't make Thursday any more. The AI agent finds their appointment, offers free times the following week and moves it once they pick one.
- A patient books a check-up and gets a deposit link in the same chat. When they ask whether it went through, the AI agent checks and confirms they're all set.
- Someone asks about an appointment they missed last week. The AI agent sees it was marked as missed and offers to book a new one.
- Reception spots a Pending booking from the AI agent in Workspace > Calendar and moves it to a later free time without opening Dentally.
Configuration
- Turn Dentally on or off under Workspace > Settings > Calendar Settings > Calendar Sync, then click Save.
- Everything you can change for Dentally is in Calendar Settings.
- Appointment reasons, practitioners and appointment lengths come from Dentally, so change them there. New reasons and practitioners reach the AI agent within the hour.
- New-patient registration follows the token's patient:create permission. To turn it on or off, switch to a different token as described under Disconnect and reconnect.
- Whether a team member can move or cancel Dentally appointments depends on their calendar permissions.
Example workflows
A patient books a check-up on WhatsApp
- A patient writes: "Can I book a check-up with Dr Patel?"
- The AI agent looks for Dr Patel's first day with free check-up times from tomorrow and offers them in the practice's local time.
- The patient picks a time. The AI agent asks for their full name and the email address the practice has for them.
- The AI agent reads the appointment back and asks the patient to confirm.
- The patient says yes. If more than one patient record matches, the AI agent asks for their date of birth, then their mobile number, before it books.
- The appointment goes into Dentally as Pending, under your Exam reason, with the note "Booked by MessageMind AI (WhatsApp)".
- If someone took that time a moment earlier, the patient is offered the nearest free times that day instead.
A patient asks about their next appointment
- A patient sends an SMS: "When is my next appointment?"
- The AI agent looks the patient up in Dentally by the phone number and email already on the conversation.
- It replies with the appointment type, day, time, practitioner and status, for example pending the practice's confirmation.
- The patient asks to move it. The AI agent offers new free times and moves the appointment in Dentally once the patient picks one and confirms.
Move an appointment from the MessageMind calendar
- Open Workspace and click Calendar in the left rail.
- Click the Dentally appointment. The window shows its reason, status, duration, practitioner, patient and notes.
- Click Reschedule, shown on Pending appointments that are still to come.
- Pick a day with the arrows or the date field. Free times are shown in the practice's time zone.
- Click a free time, then click Move appointment.
- "Appointment moved to" followed by the new day and time confirms the change in Dentally.
Book a patient in from the MessageMind calendar
- Open Workspace > Calendar and click an empty time on the day you want.
- In the Choose a calendar window, click Dentally.
- Choose the Practitioner, Reason and Duration, then the Practice date.
- Click one of the Free times.
- Under Patient, type at least 3 characters of the patient's name, date of birth, email, postcode or phone, and pick them from the list.
- Add a note for the practice diary if you need one, then click Book in Dentally.
- "Dentally appointment booked." confirms it. The appointment is Pending in Dentally.
Disconnect and reconnect
- On the Integrations page, click Disconnect on the Dentally row. It happens straight away and shows "Integration Successfully Removed".
- Calendar Settings keeps its own copy of the token, so disconnect Dentally there as well.
- In Workspace > Settings > Calendar Settings > Connected Apps > Dentally, click the bin icon on the practice row, then click Disconnect Dentally to confirm. "Dentally disconnected and shared practice access removed." confirms it.
- Dentally appointments then leave the MessageMind calendar, and team members you shared the practice with lose access. Appointments and patient records in Dentally stay there, including the ones the AI agent created.
- To switch to a new token, disconnect in both places, connect again on the Integrations page with the new token, then click Import from Integrations in Calendar Settings, turn Dentally on under Calendar Sync and click Save.