Skip to content

AtakanGueven/guven-ai-receptionist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Güven AI Receptionist

AI powered virtual receptionist built with Vapi, n8n, Google Calendar and Gmail.

Workflow

Overview

Güven AI Receptionist is an intelligent voice assistant designed to automate customer communication and appointment scheduling.

The assistant can:

  • Answer incoming calls
  • Understand customer intent
  • Schedule appointments automatically
  • Handle callback requests
  • Check calendar availability in real time
  • Generate call summaries
  • Send email notifications automatically

The system combines conversational AI with workflow automation to reduce manual administrative work and improve customer communication.


Features

  • AI powered phone receptionist
  • Voice based customer interaction
  • Appointment scheduling via Google Calendar
  • Real time availability checking
  • Callback request management
  • Automatic email notifications
  • Automated call summaries
  • Workflow automation with n8n
  • Structured data collection
  • Intent detection and routing

Tech Stack

Component Technology
Voice AI Vapi
Workflow Automation n8n
Calendar Integration Google Calendar API
Email Notifications Gmail API
AI Model OpenAI
Communication Webhooks
Version Control GitHub

Architecture

Incoming Call
      │
      ▼
Vapi Voice Assistant
      │
      ▼
Intent Detection
      │
      ├─────────────► Callback Request
      │                    │
      │                    ▼
      │              Gmail Notification
      │
      ▼
Appointment Request
      │
      ▼
Google Calendar
      │
      ▼
Appointment Confirmation
      │
      ▼
Call Summary
      │
      ▼
Email Notification

Workflow

The workflow is built using n8n and consists of the following steps:

  1. Receive call data from Vapi
  2. Validate caller information
  3. Detect customer intent
  4. Route request based on intent
  5. Create notifications
  6. Generate conversation summary
  7. Send confirmation response

Example Use Cases

Appointment Scheduling

The assistant collects customer information, checks calendar availability and schedules appointments automatically.

Callback Requests

The assistant records callback requests and forwards structured information via email.

Call Documentation

Every interaction can be summarized automatically and delivered via email.


Project Structure

guven-ai-receptionist
│
├── docs
│   └── workflow.png
│
├── prompts
│   └── vapi-system-prompt.md
│
├── n8n
│   └── receptionist-workflow.json
│
├── README.md
└── LICENSE

Future Roadmap

  • CRM integration
  • WhatsApp integration
  • Lead qualification
  • Multi language support
  • Analytics dashboard
  • Recruitment automation
  • Customer support workflows

Author

Atakan Güven

Hamburg, Germany

GitHub: https://github.com/AtakanGueven


License

This project is licensed under the MIT License.

About

AI powered phone receptionist built with Vapi, n8n, Google Calendar and Gmail for appointment scheduling and call handling.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors