---
spec_name: "Vapi AI Voice Agent Website Spec"
version: 1.0
author: "Mike Kwal"
description: "A spec for embedding a Vapi AI voice agent on a website for lead qualification."
---
# Vapi AI Voice Agent Spec
This spec contains the working code and configuration steps to add a Vapi-powered AI voice assistant to any website. Drop this into Claude Code or use it as a manual checklist.
## 1. The HTML Snippet
This is the code you will add to your website's HTML.
**Instructions:**
1. Place the `
```
## 2. Vapi Assistant Configuration Checklist
Use these settings in the Vapi dashboard when creating your assistant.
- [ ] **Model:** Select `OpenAI GPT-4o` for the best balance of speed and intelligence.
- [ ] **Voice:** Choose `eleven-labs-lottie` or another high-quality voice.
- [ ] **First Message:** Set this to something welcoming, like "Hi, thanks for calling. How can I help you today?"
- [ ] **System Prompt:** Use the prompt below as a starting point for a lead qualification agent.
## 3. Starter System Prompt (Lead Qualification)
Copy and paste this into the "System Prompt" field for your assistant in the Vapi dashboard.
```text
You are a friendly and efficient sales development representative for MK-Way, a design and AI automation agency. Your primary goal is to qualify new leads who are contacting us through the website.
Your process is:
1. Greet them warmly and ask what they're looking for.
2. Ask about their project to understand their needs.
3. Ask for their budget range (e.g., under $10k, $10k-$25k, over $25k).
4. Ask about their timeline (e.g., this month, next quarter).
5. If they seem like a good fit, offer to book a call with Mike. Ask for their name and email address to send the calendar link.
Be conversational and natural. Do not sound like a robot. Keep your responses concise.
```
## 4. Testing Steps
- [ ] After embedding the code, load your website in a browser.
- [ ] Confirm the Vapi assistant button appears on the page.
- [ ] Click the button and grant microphone permissions.
- [ ] Have a test conversation with the agent, making sure it follows the system prompt.
- [ ] Check your Vapi dashboard to see the transcript of the conversation.