Phone providers
Keep the phone system your practice already uses — JustCall, Aircall or VoiceStack — and still get calls on the patient's timeline, callers recognised while the phone rings and calls dialled from Smileline.
Open Settings → Phone providers if your practice wants to keep its existing phone system, instead of Smileline Voice or alongside it. It needs the owner or manager role, and only the practice owner can enter or replace the provider credentials.
Smileline connects to JustCall, Aircall and VoiceStack. Each card takes the credentials the provider issues to your practice; nothing is shared between practices, and Smileline never sees your provider login.
Any other phone system that can send an HTTPS request when a call rings and ends — a reseller's platform, or a system you host yourself — connects through the Other phone system (webhook) card instead. See Phone system webhook for the format and a worked example.
What the integration gives you
Once connected:
- Finished calls land on the patient's timeline, with who took the call and how long it lasted.
- Callers are recognised while the phone rings. Smileline looks the number up the moment the provider reports an incoming call and creates the lead when nobody matches, exactly like a website enquiry. An Incoming call card then pops up in Smileline with the caller's name, linking to their record (or their number, when no record could be made); it goes when the call ends, after two minutes, or when you close it with its ×. It shows to the people who work the practice's leads in Today, not to dentists, hygienists or nurses. A call Smileline itself put through to your phone system doesn't pop up twice. With Aircall the caller's name also appears inside the Aircall phone. VoiceStack calls don't pop up: VoiceStack asks Smileline who is calling without saying which call it is asking about.
- Recordings are copied into Smileline: once a call ends, Smileline saves its own copy of the recording, plays and transcribes it from there, and deletes it when your call-recording retention window passes. The copy in your provider's account stays there; Smileline never deletes it.
- Voicemails land in the voicemail inbox, even when the recording could not be copied.
- Call AI analyses provider calls in the UK and the US once Smileline has its copy of the recording: the summary, outcome, next step and call brief. On pay-as-you-go every practice gets it, billed per AI call, even before Smileline Voice is set up; on the older price list it needs the Smileline Voice add-on. Live transcription and live suggestions are for Smileline Voice calls only. Until Smileline has analysed a call, the call shows your provider's own summary if it wrote one (JustCall; Aircall with its AI add-on; VoiceStack). That summary is removed with the transcript when your recording retention window passes.
- Missed calls are followed up as on Smileline Voice. A call nobody answered shows in the bell as a Missed call (a voicemail is announced as a voicemail instead). With Text missed calls on under Settings → Automations → Missed calls, the caller gets the missed-call text — once a day per caller, and in the US only between 08:00 and 21:00 — from your practice's SMS number, not your provider's. Once Smileline Voice is set up, an A call is missed AI calling rule can also have the AI ring them back.
- A call Smileline puts through to your phone system counts once. When a Smileline tracking number or Smileline Voice forwards a call to one of your provider's numbers, your provider's record of it is filed with the Smileline call: one call in the call log, Today and the Calls report, one Call AI analysis and one missed-call follow-up, with your provider's agent shown on it. If your phone system picks the forward up (its menu, queue or voicemail) and then nobody answers, the miss shows as its own missed call and is followed up.
Call from Smileline through your provider
With JustCall or Aircall live, a call button in Smileline dials through your provider for anyone mapped to one of its users:
- Aircall starts the call in your Aircall app, from your own default number in Aircall. Without a default number, Aircall Workspace opens with the number filled in and you choose the line. Keep Aircall Workspace open and set yourself available; if you aren't, Smileline asks you to and nothing is dialled.
- JustCall opens its dialer in a small window with the number filled in. Sign in to JustCall in the same browser, and allow pop-ups for Smileline if your browser asks.
A call you make from a lead's card in Today with JustCall is linked to that card: once the call ends, it is filed on that patient's record and its timeline entry joins the card's journey, whatever number you dialled. If you call again from the same JustCall window, that second call is filed on its own. If the card was moved to another patient while you were on the call, the call stays on the patient you rang and an item in the review queue asks you to check it. Aircall doesn't tell Smileline which call it started, so an Aircall call is matched to the patient by their number, as any other call.
Anyone not mapped to a provider user, and every VoiceStack practice, gets a
tel: link instead, which your computer or phone hands to whichever app owns
calls. Set your provider's app as the default calling app to dial through it.
A provider can run alongside Smileline Voice. Calls on both land in the same call log and on the same timelines. Once Voice is set up with a number to call from, a call button in Smileline dials through Voice instead of your provider's app. Calls on your provider are never billed as Smileline Voice minutes.
Connect JustCall
JustCall's API is available on the Team plan and above.
In JustCall, open your profile icon → APIs and Webhooks and copy the API key and API secret. Resetting that pair later invalidates the connection, so reconnect afterwards.
In Smileline, click Connect on the JustCall card, paste the two values and click Connect. Smileline checks them with JustCall before storing anything.
That is all: Smileline registers its own webhook in your JustCall account (you will see it under Webhook Settings as three subscriptions — incoming call, completed call and AI report). Nothing to copy.
The badge reads Connected as soon as the registration succeeds. If JustCall refuses it, the card says so under the badge and the badge reads Webhook registration incomplete — connect again; clicking Connect again repeats the registration. Smileline also re-checks the registration once a day.
Connect Aircall
Aircall's API is available from the Essentials plan up.
In the Aircall dashboard, open Integrations → API keys, click Generate an API key and copy the API ID and API token (the token is shown once).
In Smileline, click Connect on the Aircall card, paste the two values and click Connect. Smileline checks them with Aircall before storing anything.
Smileline registers its own webhook in your Aircall account (visible under Integrations → Webhooks as Smileline). Nothing to copy.
Under People on the card, check that everyone who calls is mapped to their Aircall user: their call buttons then dial through Aircall. For anyone else, set Aircall Workspace as the default calling app, since their call buttons open a tel: link.
While the phone rings, Aircall shows a Smileline card in the Aircall phone with the caller's name (or New lead), their number and a link to the record.
Connect VoiceStack
You need the API user VoiceStack issued for your practice.
Click Connect on the VoiceStack card.
Enter the Username and Password, then click Connect. Smileline checks them with VoiceStack before storing anything, so a typo is refused immediately rather than failing quietly later.
Copy the two URLs Smileline shows you into your VoiceStack configuration, then click Done.
The two VoiceStack URLs are shown once. Smileline stores only a hashed copy and genuinely cannot show them again. If you lose one, click New call-webhook URL or New lead-lookup URL to mint a replacement — the old one keeps working for 24 hours so the swap is never a race. JustCall and Aircall have no URLs to copy, so those buttons are not shown for them.
What each VoiceStack URL is for:
- Completed-call webhook URL — VoiceStack tells Smileline a call finished. Smileline then fetches the record itself over an authenticated connection, so nothing in that message is taken on trust.
- Lead lookup / create URL — VoiceStack asks who is calling, and creates the lead when nobody matches. Leads created this way go through the same intake as a web form: duplicate detection, journey defaults and the timeline all behave identically. Smileline stores each create request before it reads it; if the lead can't be created at that moment, VoiceStack gets the same error as before, the lead is created from the stored request within moments, and VoiceStack's retry is answered with that lead — once, however often it sends it.
The VoiceStack badge reads Waiting for the first call until the first completed call arrives; that record is what tells Smileline which VoiceStack practice the credentials belong to. It then reads Connected.
Map people to your provider's users
The People list on the card is what lets a finished call say who took it, and what lets each person's call buttons dial through JustCall or Aircall as their own user.
Smileline matches a provider user to a Smileline member automatically when their email addresses are identical, and marks the row matched by email. Set anyone else by hand from the dropdown. The match is checked again on every call: a member whose access is suspended, or who has left, is no longer credited.
A choice you make by hand always wins. Later automatic passes never overwrite it, so correcting one mismatch is permanent.
Click Sync now to re-read the provider's users and numbers after adding staff there. Smileline also syncs once a day on its own.
Pause or disconnect
The dropdown on the card controls the connection:
- Live — normal operation.
- Paused — Smileline stops recognising callers and stops importing finished calls. Calls already imported stay exactly as they are. Deliveries that arrive while paused are kept for 30 days as evidence but never imported.
- Disconnected — the same, and the practice is treating the integration as finished. For JustCall and Aircall, Smileline also removes its webhook from your provider account; setting the connection back to Live registers it afresh. Closing the practice removes it the same way.
Neither pausing nor disconnecting removes call history from patient records.
When something cannot be imported
Every delivery from JustCall, Aircall or VoiceStack — a ringing call or a finished one — is stored the moment it arrives and answered at once. Smileline then recognises the caller (or creates the lead) and posts the caller card, or imports the finished call, within a few seconds. One that can't be finished straight away is retried automatically.
A delivery Smileline could not process — a body it could not read, a signature that no longer verifies because the API key was reset in the provider, a call the provider re-notified more times than Smileline re-reads on its own — is never dropped. It lands in the review queue with View details, Try again, Mark as handled and Delete; reconnecting the provider makes a signature-failed item replay on Try again.
Privacy
Three details are worth knowing:
- Your provider never receives a Smileline patient ID. VoiceStack lookups use an opaque per-connection reference that maps to the patient on Smileline's side and can be revoked without touching the patient. Aircall's caller card carries the caller's name, number and a link to the record that only a signed-in Smileline user can open.
- JustCall stores its data, including recordings and AI transcripts, in the United States; Aircall stores recordings for EMEA accounts in Frankfurt and call metadata in the US. That is the provider's own processing, and your agreement with them governs it.
- Every provider lookup and creation is audited, and appears in Activity log like any other access to patient data.
Using another phone system?
If your phone system isn't listed on this page and can't send the phone system webhook, the Using another phone system? card below the provider cards points you to call tracking instead. A Smileline tracking number goes in front of your line: patients see it on your website or adverts, Smileline answers and records the call, then puts it through to your phones as before. Calls that come in this way get:
- A recording and transcript — transcribed when the transcription switch is on — and a Call AI summary on pay-as-you-go, or with the Smileline Voice add-on on the older price list.
- The caller on Leads while the phone rings, as a new lead when nobody matches.
- Missed-call follow-up when nobody answers.
Calls you make stay in your own phone system. Click Set up call tracking on the card to start. The card appears for practices in the UK and the US, where call tracking is available.
Next steps
AI outbound calling
Let the AI voice agent ring new enquiries back — assignment rules, the per-lead hand-over, the calling window, attempt limits, and what happens when it gives up.
Phone system webhook
Connect a phone system Smileline has no direct connection to by sending each ringing and finished call to a signed webhook.