This document will help you create effective scripts for our AI voice agents.
Following these formatting guidelines ensures optimal performance and natural conversation flow.
🧩 Basic Script Structure#
Required Elements#
✅ Waiting points for prospect responses
✅ Branching logic for different scenarios
✅ Explicit scripted lines marked with ~
Script Sections#
Line Marking#
Scripted lines that must be delivered exactly require specific formatting:~ "This is an exact script line that the AI will say word for word"
Note: The ~ symbol tells the AI this line must be delivered exactly as written.
Response Waiting Points#
After each scripted line where you expect prospect input, include:*Wait for prospect's response*
Branching Logic#
Format conditional branches as follows:[BRANCH: If prospect says X]
~ "Here is the response for situation X"
[BRANCH: If prospect says Y]
~ "Here is the response for situation Y"
Always write numbers in word form:✅ Correct: “fifty thousand dollars”
❌ Incorrect: “$50,000”
💬 Script Example#
Here’s a properly formatted script segment:## INITIAL GREETING
~ "Hi, this is Sarah from [[company_name]] Voice AI. How's your day going?"
*Wait for prospect's response*
[BRANCH: If positive response]
~ "That's great to hear! I'm reaching out because..."
[BRANCH: If negative response]
~ "I hear you. I'll keep this brief. I'm reaching out because..."
## QUALIFICATION
~ "I noticed you were looking into voice AI solutions. What sparked your interest?"
*Wait for prospect's response*
🧠 Objection Handling#
## OBJECTION HANDLING
[If prospect says "too expensive"]
~ "I understand cost is important. Actually, most of our clients see ROI within thirty days because..."
🔁 Transfer Protocols#
## TRANSFER PROTOCOL
~ "I'm going to connect you with our solutions team. Please stay on the line while I transfer you."
*Initiate transfer to department X*
⚙️ Technical Requirements#
Submit scripts in plain text or markdown
Use consistent indentation
Include clear section breaks
Character Limits#
Keep individual lines under 200 characters
Break longer statements into multiple lines
Special Characters#
Use only approved markers (~ for exact lines)
💡 Best Practices#
Keep Sentences Conversational#
Write how people speak, not how they write
Use contractions (e.g., “I’m” instead of “I am”)
Include natural speech patterns (e.g., “um,” “you know”)
Include Context Markers#
Help the AI understand the purpose of each section
Provide clear guidance for tone and delivery
🧩 Custom Variables#
| Variable | Description |
|---|
{{agentName}} | Agent Name |
{{companyName}} | Company Name |
{{industry}} | Industry |
{{firstName}} | First Name |
{{lastName}} | Last Name |
{{fullName}} | Full Name |
🧪 Testing Your Script#
Before implementing your script:1.
Read it aloud to ensure natural flow
2.
Verify all branches lead somewhere
3.
Confirm all required elements are marked with ~
4.
Check that numbers are written in word form
5.
Ensure all major objections have handling paths
🚫 Common Mistakes to Avoid#
Missing Response Wait Points#
Always include *Wait for prospect's response* after questions
Don’t stack multiple questions without wait points
Unclear Branching Logic#
Specify exact conditions for each branch
Provide clear guidance for returning to main script
Always use quotation marks for exact script lines
Maintain consistent spacing and section marking
🧭 Support and Resources#
Contact our script support team
Review our script template library
Schedule a script review session
Remember:
A well-formatted script is crucial for optimal AI voice agent performance.
Take time to verify your formatting before implementation. Modified at 2025-10-20 18:53:36