Naadham User Guide

Everything your clinic can do with its AI front desk — what each feature is, how to use it in the dashboard, and how to do the same over the API.

What is Naadham

Naadham is an AI front desk for clinics and hospitals. It answers every inbound call instantly, speaks naturally in English and Hindi, books and reschedules appointments, answers FAQs, transfers to a human when needed, and follows up over chat — 24/7, with no hold music and no missed calls. Every call is recorded, transcribed, and automatically scored for quality and compliance, so you can see exactly how your front desk is performing.

You manage all of it from one console at naadham.ai/login, and you can automate it into your own systems via the REST API and webhooks.

How it works

A patient calls your clinic number. Naadham picks up on the first ring, greets them in your configured voice and language, understands what they need, and acts: answers a question, books or reschedules an appointment, or transfers to a human. If they hang up or need a reminder, Naadham follows up over WhatsApp, SMS or web chat. Every interaction is logged, transcribed and QA-scored in your console.

Inbound call answering Core feature

What it is. This is the heart of Naadham: a phone number that your AI front desk answers 24/7, instantly, with no hold music and no missed calls. It handles many calls at once, so no patient ever gets a busy tone. You either get a new Naadham number or forward your existing clinic line to Naadham — calls then ring straight through to your configured AI.

How to set it up

1. Customise your AI first (greeting, services, hours, FAQs — see Customise).
2. Connect a number. Work with the Naadham team to either provision a new number or call-forward your existing clinic line to Naadham. From that moment, every call is answered by your AI.
3. Watch it work — answered calls appear in Calls & QA with transcript and score, and bookings land in Bookings.

Multilingual voice Core feature

What it is. Naadham speaks naturally and switches between languages mid-call — out of the box it supports English and Hindi, and detects which the caller is using. Patients are understood and answered in their own language, which dramatically improves booking rates.

How to use it

In Customise → Languages, list the languages your clinic serves (e.g. English, Hindi). The AI handles the rest — no scripting per language.

Appointment booking & rescheduling Core feature

What it is. The AI books and reschedules appointments for the services you offer. It confirms the patient's name, the service and the time before booking (a compliance best-practice), then records it. Each booking can be pushed to your EHR/calendar in real time via webhooks (FHIR R4).

How to use it

1. List your bookable services in Customise.
2. Bookings the AI makes appear in Bookings and fire a booking.created webhook to your systems.

Transfer to human & after-hours Core feature

What it is. When a caller needs a person — or asks for something outside the AI's scope — Naadham transfers to a human on the number you set. Outside working hours it follows your chosen after-hours behaviour: take a message, send to voicemail, or transfer. And there's a hard guardrail: the AI never gives medical advice, diagnosis or dosing — it politely declines and offers to book or transfer.

How to use it

Set the transfer-to-human number and after-hours behaviour in Customise.

Omnichannel follow-up Core feature

What it is. Naadham isn't just voice. The same brain handles WhatsApp, SMS and web chat, so a conversation can start on a call and continue over text — appointment reminders, confirmations, answers to follow-up questions, and re-engagement of missed callers. One AI, every channel, consistent answers.

How to use it

1. WhatsApp / SMS: connect your business number with the Naadham team; inbound messages are answered by your AI and replies go back on the same channel.
2. Web chat: embed the chat widget on your site so visitors get the same assistant (ask the Naadham team for the snippet).
3. All omnichannel conversations are metered as conversations and appear in your analytics.

Integration (webhooks)

# Naadham receives WhatsApp/SMS via signed webhooks and replies on the same channel.
# Inbound message → your AI → reply. Connect your business number with the Naadham team.
# Programmatic web chat (same brain):
curl -X POST https://naadham.ai/chat -H "Content-Type: application/json" \
  -d '{"conversation_id":"web-123","body":"do you do lab tests on weekends?"}'

Create your account Clinic admin

What it is. Your account is your clinic's secure workspace. The first person to sign up becomes the clinic admin (the owner) and gets full control; you can add staff later. On sign-up you also receive 15 free trial minutes and an API key for integrations (shown only once).

In the dashboard

1. Go to naadham.ai/login and fill in work email, organisation name, and a password (at least 8 characters). Click Create account.
2. You land in the dashboard. A green banner shows your API key once — copy and store it somewhere safe.
3. Returning later? Use the same email + password to sign in. Forgot which device has your API key? You can keep using email + password for the dashboard regardless.

Via the API

# Create an account (returns a session token for the dashboard + an API key, shown once)
curl -X POST https://naadham.ai/v1/auth/signup -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"a-strong-pass","org_name":"City Clinic"}'
# → { "tenant_id":"t_ab12…", "session_token":"naadham_sess_…", "api_key":"naadham_sk_…", "trial_minutes":15 }

# Sign in later for a fresh session token
curl -X POST https://naadham.ai/v1/auth/login -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"a-strong-pass"}'

Your dashboard — every tab explained

After you sign in at naadham.ai/login, your console has these tabs. The card for each shows what it's for, what you read there, and how to manage it. Tabs marked Clinic admin are visible only to admins; Staff can see calls, bookings and contacts.

Dashboard & minutes Clinic admin Staff

What it is. The Overview tab is your at-a-glance health check: how many minutes you have left, minutes used this month, conversations handled, plus live analytics — calls, bookings, an outcomes funnel (answered / booked / transferred / missed), average QA score, and a calls-per-day trend.

In the dashboard

1. Open the Overview tab (it's the default).
2. The ring shows minutes left. When it's low or zero you'll see a prompt to recharge.
3. Scroll for the KPI cards, the outcomes funnel, and the calls-per-day trend.

Via the API

# Minutes summary
curl https://naadham.ai/v1/usage/summary -H "Authorization: Bearer $NAADHAM_KEY"
# → { "minutes_consumed":42, "minutes_left":128, "conversations":317, "month":"2026-06" }

# Full analytics (totals, funnel, daily series, avg QA)
curl https://naadham.ai/v1/analytics -H "Authorization: Bearer $NAADHAM_KEY"

Customise the AI front desk Clinic admin

What it is. This is where you make the AI yours. Set its name, greeting, tone, languages, working hours, the services it can book, directions, FAQs, the number to transfer to a human, and after-hours behaviour. Saving applies it live — the very next call uses the new settings. FAQ answers also feed the AI's knowledge base so it answers accurately.

In the dashboard

1. Open Customise.
2. Fill in agent name, greeting, tone, languages and working hours.
3. List bookable services (comma-separated), add FAQs one per line as question | answer, set a transfer number, and choose after-hours behaviour.
4. Click Save & apply. Done — it's live.

Via the API

curl -X PUT https://naadham.ai/v1/agent/form \
  -H "Authorization: Bearer $NAADHAM_KEY" -H "Content-Type: application/json" \
  -d '{
    "agent_name":"City Clinic Front Desk",
    "greeting":"Hi, City Clinic — how can I help?",
    "tone":"friendly", "languages":["English","Hindi"],
    "working_hours":"Mon–Sat 9am–6pm",
    "bookable_services":["Consultation","Dental","Lab Test"],
    "transfer_number":"+91...",
    "faqs":[{"question":"Do you accept insurance?","answer":"Yes, most major insurers."}]
  }'

Phone number Clinic admin

What it is. The Phone tab is where you get the number patients dial to reach your AI. Naadham runs the telephony for you — you don't need your own carrier.

In the dashboard

1. Open Phone and click Request a number (tell us your city/preference if asked).
2. The status shows requested → the Naadham team provisions a number and routes it to your AI → live.
3. Once live, every call to that number is answered instantly by your customised AI and appears in Calls & QA.

Schedule & real availability Clinic admin

What it is. Upload your doctors' working schedule and the AI will book real, conflict-free slots from it — never a made-up time, and two callers can never grab the same slot.

In the dashboard

1. Open Schedule and upload an Excel of your doctor/specialty timings (one row per doctor/day with start–end times).
2. Naadham expands it into individual bookable slots; you'll see open vs booked counts.
3. From then on, when a patient asks to book, the AI offers only genuinely-open times for the right doctor/service and confirms before booking.

Calls & QA Clinic admin Staff

What it is. Every call is logged with its full transcript and an automatic quality & compliance score (greeting, understanding, resolution, compliance, etiquette) plus coaching notes — and a hard flag if the AI ever drifts toward medical advice. This is how you review what the AI said and decide with confidence.

In the dashboard

1. Open Calls & QA.
2. Each card shows the caller, time, duration, outcome, and a score (green = pass, red = review).
3. Click Transcript to read the full conversation; coaching tips appear under the score.

Via the API

curl https://naadham.ai/v1/calls -H "Authorization: Bearer $NAADHAM_KEY"
# → { "calls":[ { "caller_phone":"…","outcome":"booking","transcript":"…",
#               "qa":{ "score":4.6,"passed":true,"coaching":["…"],"flags":[] } } ] }

Bookings Clinic admin Staff

What it is. Every appointment the AI books (or reschedules) lands here — patient, phone, service, requested time, and status — so your front-desk team always has the day's list. Bookings can also be pushed to your EHR via webhooks (see section 11).

In the dashboard

Open Bookings for the running list. It updates as calls come in.

Via the API

curl https://naadham.ai/v1/bookings -H "Authorization: Bearer $NAADHAM_KEY"

Contacts Clinic admin

What it is. Everyone who has called or booked, rolled up into a contact list with phone, name, number of calls and bookings, and last-seen date — ready for your sales & marketing team. Clinic admins can export the whole list to CSV.

In the dashboard

1. Open Contacts.
2. Click ⬇ Export CSV to download the list (admin only).

Via the API

curl https://naadham.ai/v1/contacts -H "Authorization: Bearer $NAADHAM_KEY"
# → aggregated by phone: { name, calls, bookings, last_at, outcomes }

Team & roles Clinic admin

What it is. Add logins for your staff and control what they can do. Admins have full control (settings, billing, team); staff get read-only access to calls, bookings and contacts. You can promote/demote anytime. Guard rails stop you removing your own login or the last admin.

In the dashboard

1. Open Team (admins only).
2. Under Add a team member, enter their email, a temporary password, and pick a role. Share those with them — they sign in at /login.
3. Change a member's role with the dropdown, or Remove to revoke access.

Via the API

# Add a staff login (admin token required)
curl -X POST https://naadham.ai/v1/team -H "Authorization: Bearer $ADMIN" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"temp-pass-123","role":"staff"}'

curl https://naadham.ai/v1/team -H "Authorization: Bearer $ADMIN"          # list
curl -X PUT https://naadham.ai/v1/team/{id}/role -H "Authorization: Bearer $ADMIN" \
  -H "Content-Type: application/json" -d '{"role":"admin"}'               # promote
curl -X DELETE https://naadham.ai/v1/team/{id} -H "Authorization: Bearer $ADMIN"  # revoke

Recharge & minutes Clinic admin

What it is. Naadham runs on prepaid voice minutes. Every connected call draws down your balance. When it reaches zero, the AI stops taking calls (callers hear a short "please recharge" notice) until you top up — so you're never billed by surprise. Recharge packs give you more minutes at a better per-minute rate as you scale.

In the dashboard

1. Open Recharge.
2. Pick a pack (Starter / Growth / Scale / Business) and click Buy.
3. Complete payment in the checkout. Minutes are credited the instant payment is verified, and your balance updates on Overview.

Via the API

# See packs
curl https://naadham.ai/v1/recharge/plans -H "Authorization: Bearer $NAADHAM_KEY"
# Create an order (admin only) → take order_id to the payment gateway
curl -X POST https://naadham.ai/v1/recharge/order -H "Authorization: Bearer $ADMIN" \
  -H "Content-Type: application/json" -d '{"plan_id":"rp_500"}'
# After payment, the gateway's signed webhook (or a verified confirm) credits the minutes.

Verification & outbound calling Clinic admin

What it is. Before Naadham's AI can place outbound calls on your behalf (e.g. appointment reminders, recalls), your clinic completes a quick one-time verification (KYC). This is a telecom-compliance requirement and differs by country. Inbound call answering and your free trial work right away — verification only gates outbound.

How it works

1. Open the Verification tab. Your country/region is detected automatically — change it if it's wrong (this sets your plan currency and the document checklist).
2. You'll see the exact documents required for your country, for example:
   • India — company registration, GSTIN, signatory PAN/Aadhaar, DLT registration.
   • United States — business registration (EIN), authorised-rep ID, TCPA attestation; HIPAA agreement if handling patient health data.
   • UK / Europe — company registration, ID, GDPR data-processing agreement.
   • UAE / Gulf — trade licence, Emirates ID, TRA declaration.
3. Get the documents ready and click Submit for review. Your status moves to pending.
4. The Naadham team reviews and approves it — your status becomes verified and outbound calling switches on. If anything's missing you'll see a note explaining what to fix.

Developer API Clinic admin

What it is. Everything in the dashboard is also a REST API, so you can wire Naadham into your own product or back-office. Authenticate with your API key as a bearer token.

Authentication & testing your key

# Your key is in the Authorization header on every request
export NAADHAM_KEY=naadham_sk_xxxxxxxx

# Quick test — who am I? (200 = key works; 401 = bad/rotated key)
curl -i https://naadham.ai/v1/whoami -H "Authorization: Bearer $NAADHAM_KEY"
# → 200 { "tenant_id":"t_ab12…" }

Common endpoints

Full reference with request/response shapes: Developer Docs →

Webhooks & EHR Clinic admin

What it is. Naadham pushes events to your server in real time — call.completed and booking.created — each HMAC-signed so you can verify it's genuinely from Naadham. Bookings are also available as FHIR R4 Appointment resources to drop straight into an EHR.

Verifying a webhook

# Each delivery includes X-Naadham-Signature: hex(HMAC_SHA256(raw_body, your_webhook_secret))
import hmac, hashlib
def verify(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

Who can do what

FAQ & troubleshooting

The AI stopped answering calls. You're likely out of minutes — check the Overview gauge and recharge. Service resumes automatically on the next call.

I lost my API key. The key is shown only once at sign-up. Keep using email + password for the dashboard; ask the Naadham team to rotate/re-issue an API key if you need one for integration.

A staff member can't see Customise/Recharge/Team. That's by design — those are admin-only. Promote them to Admin in the Team tab if they need access.

How do I connect my clinic's phone number? Talk to the Naadham team — they provision a number or forward your existing line to your AI. Configuration (persona, hours, services) is then all yours in the console.

Got a 429 from the API. You hit the per-key rate limit — wait for the Retry-After window and retry.

Need a hand? Use the feedback button on naadham.ai or email the Naadham team.