How to use Carviq
Everything you need to get started and get the most out of the platform.
๐Getting Started
First Login
Open the Carviq dashboard and authenticate with your PIN or Face ID. First time? You'll set up a 4-digit PIN. Each provider has their own credentials โ no shared logins.
Dashboard Layout
The web dashboard is organized into sections accessible from the left sidebar:
- Schedule โ Today's visits with drive times and gap detection
- Clinical Inbox โ Patient message threads with AI triage
- Members โ Patient roster, profiles, and lifecycle management
- Documents โ School forms, excuses, and e-sign templates
- Vaccines โ ACIP planner, records, and lot tracking
- Insights โ Visit volume, MRR, churn, and operational metrics
- Settings โ Team management, calendars, scheduling groups, branding
๐ Scheduling
Native Booking Page
Each practice gets a branded booking page where families can request appointments. The scheduling engine uses route scoring to suggest optimal slots based on provider location, existing visits, and drive times. Booking eligibility gating ensures only active members (or approved visit types) can book.
CalDAV Calendar Sync
Connect your external calendars (Apple iCloud, Google, etc.) via CalDAV. External events automatically create buffer blocks on your Carviq schedule, preventing double-booking. Sync runs continuously โ changes in either direction are reflected within minutes.
Groups & Availability
Scheduling groups let you define which providers handle which visit types or service areas. Each group has its own availability windows. For example, you might have a "Well Visits" group with morning availability and a "Sick Visits" group that runs all day.
Extended Visits & Capacity
Extended visit types (like new patient consults) automatically swap into longer time slots. Resource capacity enforcement prevents overbooking โ once a provider's slots are full, the booking page shows the next available date.
๐ฌClinical Inbox
AI Triage
Every incoming message is automatically triaged by AI into urgency levels: ๐ด Urgent, ๐ก Moderate, ๐ข Routine, โช Informational. The AI reads the message content, considers patient history, and assigns a level. Triage is a suggestion โ you can always re-categorize.
Responding to Messages
When you open a thread, AI drafts a response in your provider's voice based on the message content and patient context. Review the draft, edit as needed, and tap Send. The AI learns from your edits over time. Nothing ever sends without your explicit approval.
Encounters
AI automatically groups messages into clinical encounters. If a family messages about two different children or two separate complaints, each gets its own encounter thread. Previous encounters collapse so you can focus on what's active. You can also manually split or merge encounters.
๐Connecting Spruce
Carviq reads your Spruce messages so they appear in the Clinical Inbox, get AI-triaged, and attach to the right patient. This takes about ten minutes and you only do it once.
Before you start
You need to be an administrator on your practice’s Spruce account, and Spruce’s API access must be enabled on your plan. If you do not see API settings, contact Spruce support — it is usually a plan setting rather than a permission.
Step 1 — Enable API access
In Spruce, go to Settings → Organization → API and turn on API access.
Step 2 — Create an API token
Still in API settings, create a new token. Name it Carviq so you can recognise it later. Copy the token immediately — Spruce shows it once and will not show it again.
Step 3 — Add a webhook
Add a new webhook pointing at your practice’s own Carviq address:
https://api.carviq.co/api/spruce-webhook/your-practice-slug
Replace your-practice-slug with the slug Carviq gave you. This matters: the slug is how Carviq knows the messages belong to your practice. Without it, your messages will not be accepted — and that is deliberate, so no practice can ever receive another practice’s patient messages.
Subscribe the webhook to conversation item created events, then copy the signing secret Spruce generates.
Step 4 — Note your phone lines
Write down the name and number of each Spruce phone line you use (for example “Main” and “Nurse line”). Carviq uses these to route messages to the right person.
Step 5 — Send the details securely
Send your Carviq contact three things: the API token, the webhook signing secret, and your phone lines.
Do not email the token. Use a password manager share link, an encrypted message, or read it over the phone. A Spruce API token can read your patient conversations, so treat it like a password.
What happens next
Once your credentials are in place, new messages appear in your Clinical Inbox within a few seconds. Historical messages are not imported — Carviq starts from the moment you connect.
If something is not working
No messages appearing — the webhook is usually the cause. Check in Spruce that it is enabled, that the URL ends with your practice slug, and that it is subscribed to conversation item created events.
Messages appear but not the sender’s name — the contact may not be matched to a patient yet. Link them from the thread and future messages will attach correctly.
A note on privacy
Your Spruce messages are visible only to your practice. Each practice has its own webhook address and its own signing secret, and Carviq verifies every message against the secret for that practice before storing it.
๐Documents & E-Sign
School Forms & Excuses
Upload any PDF form. Carviq's AI detects fillable fields automatically. You can drag-and-drop to adjust field mapping, then auto-fill from patient data. Stamp the provider signature and the completed PDF is ready in seconds โ no printing required.
E-Sign Flow
For documents requiring signatures from families or other parties:
- Upload a PDF template and map signature, initial, and text fields
- Send the document โ the recipient gets a signing link via SMS and email
- They sign on a mobile-friendly page (works on any phone or tablet)
- Provider co-signing is supported for documents that need both parties
- Completed documents are stored in the patient's record automatically
๐ฑMobile App
Installation
The Carviq iOS app is currently distributed via TestFlight. Your administrator will send you a TestFlight invite link. Tap the link on your iPhone to install. The app requires iOS 16 or later.
App Layout
The app has two main tabs:
- Schedule โ Your day's visits with drive times, one-tap navigation, and visit status updates
- Inbox โ Clinical message threads with AI triage and draft responses, same as the web dashboard
Authentication
The app supports PIN and Face ID authentication. On first launch, you'll set a 6-digit PIN. Face ID can be enabled in app settings. The app locks automatically when backgrounded โ no PHI is ever cached on device.
โFrequently Asked Questions
Go to Settings โ Calendars and tap Add Calendar. For Apple iCloud, use your iCloud email and an app-specific password (generate one at appleid.apple.com โ Sign-In and Security โ App-Specific Passwords). For Google Calendar, use your Gmail address and a Google App Password (generate at myaccount.google.com โ Security โ 2-Step Verification โ App passwords). Enter the CalDAV server URL, username, and app password โ Carviq handles the rest.
When a CalDAV calendar is connected, external events automatically create buffer blocks on your Carviq schedule. By default, any event on your external calendar blocks that time slot from being bookable. You can adjust buffer settings per calendar โ for example, adding 30 minutes before and after external events for travel time.
Pausing a calendar temporarily stops sync for that specific calendar connection. The provider remains active and can still see patients โ their other calendars (if any) continue syncing, and they can still be manually scheduled. Deactivating a provider removes them from all scheduling entirely. They won't appear on the booking page, can't receive new appointments, and their existing future appointments need to be reassigned. Use pause for vacations; use deactivate for providers who have left the practice.
Go to Settings โ Scheduling โ Groups. Create a group (e.g., "Well Visits" or "West Side"), assign providers to it, and set availability windows. Each group can have its own bookable visit types and time slots. On the booking page, families select a visit type, and only providers in the matching group with open availability are shown.
When a message arrives in the Clinical Inbox, AI analyzes the text content (and any attached photos) against the patient's recent history. It assigns an urgency level (๐ด๐ก๐ขโช) and drafts a response. The AI uses your practice's communication patterns and each provider's voice. Triage runs within your HIPAA-compliant AWS environment โ no patient data leaves your infrastructure. You can always override the triage level or discard the draft.
Can't find what you're looking for?
Contact Support โ