Developer Mockup · Voice Registration Agent

Kumbh Mela 2027 Visitor Registration

Complete specification for building an AI voice agent that registers visitors over a phone call — conversational collection, Aadhaar + OTP verification, pass generation, and SMS/WhatsApp confirmation — using the same backend APIs as the website.

Conversational (not form-based) Government helpdesk tone ~3–4 min call Pass: KM2027-XXXXXX

1. Objective

The agent must complete end-to-end visitor registration on an incoming call and behave like a polite government helpdesk executive — never a telemarketer.

01 Welcome the visitor and explain the purpose of the call
02 Collect all required information naturally in conversation
03 Validate Aadhaar number (format + Verhoeff checksum) and mobile number
04 Confirm details before submission
05 Create registration in backend and generate Kumbh Pass + QR
06 Inform visitor of success and trigger SMS / WhatsApp confirmation

2. Agent Persona

Tone and behaviour constraints for prompt / system instructions.

Character

Official Kumbh Mela 2027 Virtual Registration Assistant. Calm, clear, respectful. Speaks short sentences suitable for phone audio. Uses “Namaste” greeting. Confirms before acting. Never rushes or upsells.

Language

Primary: Hindi or English (detect from caller). Keep scripts below as English baseline; localize TTS/prompts as needed. Spell out numbers digit-by-digit when collecting Aadhaar and OTP.

Do / Don’t

Do ask one question at a time
Do repeat back critical fields before submit
Do offer to resend OTP (max 3 attempts)
Don’t sound promotional or pushy
Don’t invent Aadhaar / UIDAI data
Don’t store raw Aadhaar unencrypted

3. Registration Call Flow

Ordered state machine for the conversation. Orange = AI turns; teal = system / backend actions.

Incoming CallTwilio / telephony webhook → start agent session

GreetingWelcome + purpose + duration (~3–4 min) + consent

Consent to RegisterYes → continue · No → polite end

Collect Aadhaar Number12 digits · numeric · Verhoeff checksum

OTP VerificationBackend sends OTP → AI collects → validate · max 3 attempts

Fetch Aadhaar DetailsOptional eKYC: Name, Gender, DOB · confirm name

Mobile ConfirmationConfirm Aadhaar-linked mobile or collect 10-digit Indian mobile

Emergency Contact · State · Arrival · Transport · StayCollect remaining mandatory fields one by one

Repeat & ConfirmSummarize · Yes → submit · No → edit field

Create RegistrationINSERT visitor · pass KM2027-###### · QR code

Send SMS / WhatsAppGovernment gateway + WhatsApp Business API

Success Message & End CallRead pass number · remind to carry Aadhaar + pass

4. Conversation Scripts

Canonical turns for the agent. Use as prompt examples / TTS scripts. Click a step to preview.

5. Interactive Call Walkthrough

Click through a happy-path mock conversation to validate UX timing and confirmations before coding the real agent.

Live Call Simulation

Ready — press Start Call

6. Database Fields & Validation

Same schema for web registration and voice agent — one backend, two channels.

Field	Source	Notes
Pass Number	Auto Generated	`KM2027-000001` sequential
Aadhaar Number	User	Unique · Verhoeff · tokenize at rest
Name	Aadhaar / User	Confirm with caller
Age	Aadhaar / User	Derived from DOB when available
Gender	Aadhaar	Optional eKYC
Mobile	OTP Verification	10-digit Indian format
Emergency Contact	User	Must ≠ primary mobile (recommended)
State	User	Or country if international
Arrival Date	User	Future date only
Transport Mode	User	Train / Flight / Bus / Personal Vehicle
Stay Type	User	Hotel / Tent City / Akhada / Day Visit
Registration Time	System	Server timestamp
Status	System	`Approved` on success
QR Code	System	Server-side generation

Validation rules

✓ Aadhaar number must be unique in the visitors table
✓ Aadhaar must pass Verhoeff checksum validation
✓ Mobile number must be OTP verified before registration
✓ Arrival date cannot be in the past
✓ Emergency contact should not match primary mobile
✓ All mandatory fields completed before INSERT

Enums

Transport Mode

Train · Flight · Bus · Personal Vehicle

Stay Type

Hotel · Tent City · Akhada · Day Visit

7. Backend Contracts & Payloads

Illustrative contracts the voice agent tools should call. Align paths with the shared web API.

Suggested agent tools

Tool	Purpose	Key input
`validate_aadhaar`	Format + checksum (+ uniqueness check)	aadhaar_number
`send_otp`	Dispatch OTP to registered / provided mobile	aadhaar_number \| mobile
`verify_otp`	Confirm OTP (track attempt count)	session_id, otp
`fetch_aadhaar_profile`	Optional eKYC name/gender/DOB	session_id
`create_registration`	INSERT visitor · pass · QR · notify	full payload below

create_registration payload

{
{
  "aadhaar_number": "XXXXXXXXXXXX",
  "name": "Rajesh Kumar",
  "age": 34,
  "gender": "Male",
  "mobile": "98XXXXXXXX",
  "emergency_contact": "97XXXXXXXX",
  "state": "Uttar Pradesh",
  "arrival_date": "2027-01-18",
  "transport_mode": "Train",
  "stay_type": "Tent City",
  "channel": "voice_agent"
}

Pass number format

KM2027-000001
KM2027-000002
KM2027-000003
# Sequential via DB sequence / auto-increment

QR code payload

{
{
  "pass_no": "KM2027-000001",
  "name": "Rajesh Kumar",
  "arrival": "2027-01-18",
  "status": "Approved"
}

Prefer encoding only pass_no and resolving details server-side after scan for stronger security.

SMS / WhatsApp template

Government of India

Dear Rajesh Kumar, Your Kumbh Mela 2027 registration has been approved. Pass Number: KM2027-000001 Arrival Date: 18-Jan-2027 Please carry your Aadhaar Card and this pass during your visit. Download your pass: https://kumbh.gov.in/pass/KM2027-000001

Success voice script

Agent

Congratulations. Your registration has been completed successfully. Your Kumbh Pass Number is KM2027-000001. A QR Code and registration details have been sent to your mobile number through SMS and WhatsApp. Please carry your Aadhaar card and this pass while travelling. We look forward to welcoming you to Kumbh Mela. Thank you.

8. Recommended Technology Stack

Shared platform for web + voice. Voice layer plugs into the same registration APIs.

Frontend (web)

React.js or Next.js — responsive self-service registration

Backend

Node.js (NestJS / Express) or Java Spring Boot

Database

PostgreSQL with sequence for pass numbers

Auth

OTP via mobile number

Identity

UIDAI Aadhaar eKYC where legally authorized

Voice AI

OpenAI Realtime API or Twilio ConversationRelay + Deepgram/Whisper STT + natural TTS

Messaging

Gov-approved SMS gateway + WhatsApp Business API

Server-side generation embedded in digital pass

Hosting

NIC Cloud, AWS, Azure, or gov-approved cloud

Security

HTTPS · Aadhaar tokenization · audit logs · RBAC · Indian DPDP + UIDAI compliance

Derived from initial-details.md · Kumbh Mela 2027 Visitor Registration · AI Voice Agent Developer Mockup