Voice AI

Voice AI Script Formatting Guide

Format effective scripts for Atlas AI voice agents

Welcome to Atlas’s Script Formatting Guide. 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

  • Clear section markers
  • Waiting points for prospect responses
  • Branching logic for different scenarios
  • Explicit scripted lines marked with ”~“

Script Sections

  • Initial Greeting
  • Qualification
  • Discovery
  • Value Proposition
  • Call-to-Action
  • Closing

Formatting Rules

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"

Number Formatting

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 Atlas 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

File Format

  • Submit scripts in plain text or markdown
  • Use consistent indentation
  • Include clear section breaks

Character Limits

  • Keep individual lines under two hundred 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

VariablePlaceholder
Agent Name{{agentName}}
Company Name{{companyName}}
Industry{{industry}}
First Name{{firstName}}
Last Name{{lastName}}
Full Name{{fullName}}

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

Inconsistent Formatting

  • Always use quotation marks for exact script lines
  • Maintain consistent spacing and section marking

Support and Resources

For additional help:

  • 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.