 |
 |
 |
 |
%%{init: {'theme':'dark', 'themeVariables': { 'primaryColor':'#6366F1','secondaryColor':'#10B981','tertiaryColor':'#F59E0B','lineColor':'#6366F1','fontSize':'18px'}}}%%
graph LR
A[📱 INCOMING<br/>CALL] --> B[🎙️ VOICE<br/>GREETING]
B --> C[👂 LISTEN<br/>INPUT]
C --> D[🧠 PROCESS<br/>DTMF]
D --> E[📅 SCHEDULE<br/>APPOINTMENT]
E --> F[✅ CONFIRM<br/>BOOKING]
F --> G[💬 SEND<br/>CONFIRMATION]
style A fill:#6366F1,stroke:#fff,stroke-width:4px,color:#fff
style B fill:#10B981,stroke:#fff,stroke-width:4px,color:#fff
style C fill:#F59E0B,stroke:#fff,stroke-width:4px,color:#fff
style D fill:#EF4444,stroke:#fff,stroke-width:4px,color:#fff
style E fill:#8B5CF6,stroke:#fff,stroke-width:4px,color:#fff
style F fill:#10B981,stroke:#fff,stroke-width:4px,color:#fff
style G fill:#6366F1,stroke:#fff,stroke-width:4px,color:#fff
|
✅ AWS Polly Integration |
✅ Twilio VoiceML |
✅ Smart Scheduling |
Python 3.9+
FastAPI Framework
Twilio Account (Free tier available)
ngrok for local testing# Clone the repository
git clone https://github.com/yourusername/ai-voice-assistant-appointment-booking.git
# Navigate to project directory
cd ai-voice-assistant-appointment-booking
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run the application
uvicorn main:app --reload --host 0.0.0.0 --port 8000# Download and install ngrok
# Start ngrok tunnel
ngrok http 8000
# Copy the HTTPS URL and configure in Twilio webhook
https://your-ngrok-url.ngrok.io/voice
from fastapi import FastAPI, Form
from fastapi.responses import PlainTextResponse
app = FastAPI(
title="AI Voice Assistant",
description="Enterprise Voice Automation Platform",
version="1.0.0"
)
@app.post("/voice", response_class=PlainTextResponse)
def voice_response():
"""
Initial voice greeting endpoint
Handles incoming calls with AWS Polly voice
"""
return TwiML_XML_Response
@app.post("/process", response_class=PlainTextResponse)
def process_response(Digits: str = Form(...)):
"""
Process DTMF input from caller
Routes to appropriate appointment slot
"""
return Confirmation_Response1️⃣ Call Initiated → FastAPI /voice endpoint triggered
2️⃣ AWS Polly speaks greeting message
3️⃣ Gather DTMF input (1, 2, or 3)
4️⃣ Process selection → /process endpoint
5️⃣ Confirm appointment with voice response
6️⃣ End call with confirmation
|
**10:00 AM** Dr. Smith Consultation |
**2:00 PM** Dr. Smith Consultation |
**6:00 PM** Dr. Smith Consultation |
| Voice Name | Gender | Language | Use Case |
|---|---|---|---|
| Polly.Joanna | Female | en-US | Professional, Clear |
| Polly.Matthew | Male | en-US | Authoritative |
| Polly.Amy | Female | en-GB | British English |
| Polly.Brian | Male | en-GB | Formal |
|
Calls Handled |
 Response Time |
 Success Rate |
 Cost Reduction |
 HEALTHCARE Patient Appointments Prescription Refills Test Result Queries |
 BANKING Account Inquiries Loan Applications Customer Support |
 REAL ESTATE Property Viewings Agent Meetings Document Signing |
 EDUCATION Admission Counseling Parent-Teacher Meetings Campus Tours |
 Natural Language Understanding Intent Recognition Sentiment Analysis |
 Confirmation Messages Appointment Reminders Follow-up Texts |
 Call Analytics Conversion Rates Performance Insights |
 End-to-End Security |
 Healthcare Compliance |
 Data Protection |
 Payment Security |
|
https://drive.google.com/file/d/1fGiFCd6z0v6ljt-3x9ORWebncsL5EHFV/view?usp=drive_link ✅ FastAPI Framework - Modern async Python web framework |
✅ 60% Cost Reduction - Automated appointment scheduling |
⭐ STAR THIS REPOSITORY TO SUPPORT VOICE AI INNOVATION! ⭐
Built with 🎙️ and AI for Enterprise Automation
© 2025 AI Voice Assistant Platform
This project demonstrates:
- Full-Stack Development with FastAPI
- Cloud Integration (AWS, Twilio)
- Voice AI Implementation
- RESTful API Design
- Production-Ready Code
- Enterprise Architecture
Showcases skills in: Python, FastAPI, Cloud Services, Voice Technology, API Development, Webhooks, Real-time Processing