Doctolib Integration Template
Integrate Germany’s leading doctor appointment platform Doctolib directly into your Mid-call Actions. Enable your customers to find doctors, check available appointments, and even book appointments – all while on the phone.Overview & Features
Doctor Search Automation
- Search for specialists based on location and specialty
- Filter by insurance type (public/private)
- Availability within defined timeframes
- Radius-based search for optimal accessibility
Appointment Management
- Real-time availability of doctor appointments
- Automatic appointment booking during the call
- Support for video consultations
- Full patient data integration
Setting Up Doctolib API Access
1. Doctolib Developer Account
Developer Registration
- Visit the Doctolib Developer Portal
- Register as a healthcare integration partner
- Submit your business license and data protection documentation
Tool 1: Doctor Search Tool
Configuration in Famulor Interface
- Tool Details
- Header Configuration
- Query Parameters
| Field | Value |
|---|---|
| Name* | Doctolib Arztsuche |
| Description | ”Searches for available doctors and specialists based on location and specialty” |
| Function Name* | search_doctolib_practitioners |
| Function Description* | “Searches for doctors by specialty and location. Use this function when the patient is looking for a doctor nearby.” |
| HTTP Method | GET |
| Timeout (ms) | 5000 |
| Endpoint* | https://api.doctolib.de/practitioners/search |
Parameter Schema
Response Mapping
Natural Language Integration
Agent Message Before API Call
Agent Message Before API Call
Template:
"I'm searching for {{speciality}} in {{location}} for you..."Examples:- “I’m searching for dentists in Munich for you…”
- “I’ll look for general practitioners in 10115 Berlin…”
- “I’m finding orthopedists in Hamburg who accept public insurance…”
Custom Prompt for Summary
Custom Prompt for Summary
Tool 2: Appointment Slots Inquiry
Configuration in Famulor Interface
- Tool Details
- Query Parameters
| Field | Value |
|---|---|
| Name* | Doctolib Terminslots |
| Description | ”Displays available appointments for a specific doctor” |
| Function Name* | get_doctolib_slots |
| Function Description* | “Retrieves available appointment slots. Use this function after a doctor has been selected to show concrete appointment options.” |
| HTTP Method | GET |
| Timeout (ms) | 5000 |
| Endpoint* | https://api.doctolib.de/practitioners/{practitioner_id}/availabilities |
Parameter Schema for Appointment Inquiry
Response Handling
Tool 3: Appointment Booking
Configuration for Booking Tool
- Tool Details
- Request Body Template
| Field | Value |
|---|---|
| Name* | Doctolib Termin buchen |
| Description | ”Books a doctor appointment via Doctolib” |
| Function Name* | book_doctolib_appointment |
| Function Description* | “Books a specific appointment with a doctor. Use this function only after all patient data is fully collected.” |
| HTTP Method | POST |
| Timeout (ms) | 10000 |
| Endpoint* | https://api.doctolib.de/appointments |
Complete Parameter Schema for Booking
Complete Workflow
Step-by-Step Integration
Practical Conversation Example
Scenario: Dentist Appointment Booking
Scenario: Dentist Appointment Booking
Patient: “I need a dentist appointment in Munich.”AI Assistant: “I’d be glad to help. Are you insured publicly or privately?”Patient: “Publicly insured.”AI: “Perfect. I’m searching for dentists in Munich for you…”→ Tool: AI: “I found 8 dentists. Dr. Schmidt on Maximilianstraße has an appointment available the day after tomorrow. Dr. Müller in Schwabing is available next week as well. Which practice would be more convenient for you?”Patient: “Dr. Schmidt sounds good.”AI: “I’m checking available appointments for Dr. Schmidt…”→ Tool: AI: “Dr. Schmidt has the following appointments available: Wednesday 14:30, Thursday 09:15, or Friday 16:00. What works best for you?”Patient: “Thursday 09:15 would be perfect.”AI: “Excellent! Now I need your details to complete the booking. What is your full name and birthdate?”→ Data collection → Tool:
search_doctolib_practitionersget_doctolib_slotsbook_doctolib_appointmentAI: “Appointment booked! You have an appointment with Dr. Schmidt on Thursday, January 18 at 09:15. You will receive a confirmation via SMS and email.”Advanced Scenarios
Advanced Scenarios
Emergency Appointments:Video Consultations:Multiple Specialties:
Response Handling & Error Management
Typical API Responses
- Doctor Search Response
- Appointment Slots Response
- Booking Response
Error Handling
Common Error Scenarios
Common Error Scenarios
No doctors found (404):
Appointment Booking Failed
Appointment Booking Failed
API Rate Limiting
API Rate Limiting
Advanced Features
Integration with CRM Systems
- Patient Data Sync
- Healthcare Analytics
Compliance & Data Protection
GDPR Compliance
GDPR Compliance
Healthcare Security
Healthcare Security
Performance & Monitoring
KPIs and Metrics
| Metric | Target Value | Critical Value |
|---|---|---|
| Doctor Search Response Time | <2 seconds | >5 seconds |
| Booking Success Rate | >90% | <75% |
| Patient Satisfaction | >4.5/5 | <4.0/5 |
| API Availability | >99.5% | <97% |
Monitoring Dashboard
Real-time Metrics
- API response times for all three tools
- Success / failure ratio
- Current booking rate
- Geographic heat map of requests
Business Intelligence
- Most-requested specialties
- Peak hours for appointment inquiries
- Regional demand analysis
- Patient demographics
Healthcare Integration Patterns
Expand your healthcare automation:
- Webhook Integration for complex workflows
- Salesforce Integration for CRM synchronization
- Google Sheets Integration for simple data management
Pro Tip: Start with the doctor search functionality and gradually expand to appointment booking. Most patients already appreciate the fast doctor search, even if they book the appointment themselves.

