Setup koppeling – Dentally Integratie

Op dit moment kan je de Dentally-koppeling niet zelfstandig instellen via de TurnUp World app. Deze koppeling wordt intern opgezet door het TurnUp-team.

🔐 Wat hebben wij van jullie nodig?

Om de koppeling op te zetten, hebben wij een access token nodig met de juiste toegangsrechten. Dit token wordt door jullie Dentally-beheerder gegenereerd en veilig aan TurnUp bezorgd.

Het token moet toegang geven tot:

• Afspraakgegevens

• Patiëntgegevens

• Agenda’s

• Redenen van afspraken (treatments)

• Webhook-permissies

🔁 Wat gebeurt er bij de eerste synchronisatie?

Zodra we het token ontvangen, starten we de initiële sync. Deze haalt de volgende gegevens op uit Dentally:

• Toekomstige afspraken

• Agendagegevens (in TurnUp: ‘zorgverleners’)

• Afsprakenredenen (in TurnUp: ‘behandelingen’)

• Patiëntgegevens

• Patiënten op de wachtlijst

• We stellen automatisch webhooks in om synchronisatie in realtime mogelijk te maken

ℹ️ De sync gebeurt met ‘checkpoints’ om overbelasting van de Dentally API te vermijden. Bij grote hoeveelheden data kan de eerste synchronisatie enkele uren duren.

🏥 Meerdere vestigingen?

Elke praktijklocatie krijgt een aparte TurnUp-omgeving. Zelfs als alle locaties onder één Dentally-account vallen, maken we voor elke vestiging een eigen TurnUp-account aan. Zo blijft alles overzichtelijk en beheersbaar.

🔄 Altijd up-to-date met webhooks en back-up syncs

Om realtime gesynchroniseerd te blijven met Dentally, gebruikt TurnUp de webhooks die Dentally aanbiedt voor afspraken en patiënten.

Daarnaast voeren we elk uur een automatische synchronisatie uit voor minder kritieke gegevens zoals:

• Zorgverleners

• Behandelingen

• Patiënten op de wachtlijst

Er is ook een geplande taak om elke dag om 16:00 uur opnieuw alle afspraken te synchroniseren ("bring back reservations into sync"). Zo blijven we actueel, ook als er iets gemist werd — ideaal om herinneringsberichten correct en tijdig te versturen.