Atlas
  1. Documentation
Atlas
  • Documentation
    • Welcome to Atlas!
    • Connect your calendar
    • Twilio Integration
    • Dashboard
    • Knowledge
    • Contacts
    • Script Formatting
    • Global Actions
    • Call Records
    • Account
    • Campaigns
      • Campaigns
      • Calls Enrichment
        • Enriching Calls with External CRM and Data Sources
        • Go High Level - Call Enrichment
        • Pipedrive - Call Enrichment
        • Shopify - Call Enrichment
        • Monday - Call Enrichment
        • Hubspot - Call Enrichment
    • Integrations
      • Zapier
      • Make
      • Keragon
      • Go High Level
    • Phone Systems Integrations
      • Dialpad Integration
  • API Reference
    • API documentation
    • Authentication
      • Authentication
      • Authorization
      • Token
      • User Info
    • Triggers
      • Subscribe
      • Unsubscribe
      • Campaigns
      • PerformList operation
    • Actions
      • Start a Call
  1. Documentation

Script Formatting

Atlas Voice AI 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 [[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#

File Format#

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#

VariableDescription
{{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

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.
Modified at 2025-10-20 18:53:36
Previous
Contacts
Next
Global Actions
Built with