Nookal Setup
Connect your Nookal practice management system to QuackChat for live appointment availability and direct booking. Nookal exposes a self-service REST API — you generate the key yourself from your account, with no partner approval or developer application required.
Prerequisites
- A QuackChat account on the Pro plan or above
- A Nookal account with admin access (no account yet? Start a free 30-day trial)
- An active Nookal API key (generated in the steps below)
Step 1: Generate an API Key in Nookal
- Log in to Nookal
- Go to Setup → Connections → API Keys
- Click Generate API Key
- Configure the key:
- Locations — select the location(s) the key may access (include every clinic the bot should book for)
- Status — set to active
- Note — add a label such as "QuackChat" so you can identify it later
- Save the key
For Nookal's own reference, see the Nookal developer & API docs, which also link to their "Generating API Keys" article.
Step 2: Copy the API Key
Copy the generated key. Nookal lets you view it again later from the same screen, but it's easiest to copy it now.
Step 3: Enter the Key in QuackChat
- Open your bot's workspace and go to Settings → Integrations
- Start a new PMS connection and choose Direct booking (or Live availability if you only want the bot to read availability)
- Select Nookal as the provider
- Paste your API key into the API Key field
- Continue through the wizard — QuackChat verifies the key against Nookal immediately
Services, practitioners, and locations sync automatically from Nookal once connected — you don't enter them manually.
Step 4: Test the Connection
- After saving, open the connection and click Test Connection — a successful test shows a green "Healthy" status
- Ask your bot about appointment availability to confirm it reads live slots, then try a booking to confirm the full flow
What QuackChat Can Do with Nookal
- Live availability — read each practitioner's open slots in real time
- Direct booking — create, reschedule, and cancel appointments in Nookal on the patient's behalf
- New-patient intake — register a new patient in Nookal and book them in, all from one chat conversation
Troubleshooting
"Unable to verify account" / invalid key
- Check the key was pasted in full, with no leading or trailing spaces
- Confirm the key's Status is active in Nookal (Setup → Connections → API Keys)
- Make sure the key has access to the location(s) you want to book for
No available slots returned
- Confirm practitioners have availability configured in Nookal for the dates being queried
- Check that appointment types (services) are set up and offered at the selected location
- Verify the location on the API key matches the clinic you're booking for
Bookings aren't being created
- Make sure the connection mode is Direct booking, not just Live availability
- Confirm the practitioner and appointment type chosen are valid for the location
Auto-disabled connection (5 consecutive failures)
- The connection auto-disables after 5 consecutive sync failures to protect your account
- Fix the underlying issue (usually an expired or deactivated key), then re-enable it with the Active toggle and click Test Connection to verify