AI Voice Agent — Test UI

Minimal frontend to test all Week 1–4 functionality. Use with backend at ./run.sh or uvicorn main:app --reload --port 8000.

📞 Quick test call

Place an outbound AI call to any number. Uses TWILIO_PHONE_NUMBER from .env.


— Use same API URL as server (see Configuration) 

    
⚠️ No transcript? Twilio Media Streams need HTTPS + wss:// port 443. If BASE_URL is http://, Twilio won't connect to the WebSocket — you'll hear "One moment" but no AI. Use ngrok or a server with SSL.

  


  

    Configuration
    

      
      
      (empty = this site’s origin)
    

    

      
      
    

    

      
      
      
      
    

  


  

    
📋 Usage Guidelines

    

      

        
Week 1 — Missed call recovery

        
    
          
  • Search numbers: Area code (e.g. 415), country US → Search → pick a number.
    • 
          
  • Purchase: Phone number + optional client_id → creates/assigns number.
    • 
          
  • Create client: Business name + Twilio number. Use purchased number or add manually.
    • 
          
  • Flow: Call → no answer → SMS sent → lead logged to Sheets (if configured).
    • 
        

      

      

        
Week 2 — AI voice agent

        
    
          
  • Enable AI: Create client with "Use Media Stream" checked, or set use_media_stream=true.
    • 
          
  • Twilio: Point "A call comes in" to {BASE_URL}/webhooks/twilio/inbound-stream.
    • 
          
  • Flow: Call → AI asks service, urgency, availability, next step → lead saved in Leads.
    • 
        

      

      

        
Week 3 — Booking + CRM

        
    
          
  • Availability: Date (YYYY-MM-DD) + client_id → slots for that day.
    • 
          
  • Confirm job: PATCH job with status=confirmed, optional scheduled_at, notes.
    • 
          
  • Confirmation: If BOOKING_CONFIRMATION_ENABLED, SMS/WhatsApp sent on confirm.
    • 
        

      

      

        
Week 4 — Follow-ups + AI callback

        
    
          
  • Follow-ups: Leads with next_step=follow_up → 10min, 24h, 48h messages (needs FOLLOW_UP_ENABLED).
    • 
          
  • SMS reply YES: Creates callback request. With CALLBACK_ENABLED, backend places outbound AI call.
    • 
          
  • Callback requests: List high-intent leads who replied YES.
    • 
        

      

    

  


  
  

    
👥 Clients

    

      

        

          

        

        

          

        

        

          

        

        

          
          
        

        

      

      
      

    

  


  
  

    
📞 Phone Numbers (Week 1)

    

      

        

          

        

        

          

        

        

      

      

      

        

          

        

        

          

        

        

      

      

    

  


  
  

    
📊 Stats

    

      

        
        
        
        
        
        
      

      

    

  


  
  

    
📅 Availability (Week 3)

    

      

        

          

        

        

          

        

        

          

        

        

      

      

    

  


  
  

    
📝 Transcripts (Week 2)

    

      
      

    

  


  
  

    
🎯 Leads

    

      

        
        
      

      

    

  


  
  

    
📋 Jobs (Week 3)

    

      

        
        
        
      

      

      

      Update Job
      

        
        
        
        
        
      

      

    

  


  
  

    
📞 Calls

    

      

        
        
        
      

      

    

  


  
  

    
📲 Callback Requests (Week 4)

    

      

        
        
        
      

      

    

  


  
  

    
⭐ Review Requests (Week 5)