How To Write Effective Bot Instructions
Back to Guides

How To Write Effective Bot Instructions

Updated 5 months ago

How to Write Effective Bot Instructions

Your bot's instructions are the foundation of everything it does. Think of them as training instructions for a new employee - the clearer you are, the better your bot performs.

This guide will show you how to write instructions that make your bot helpful, accurate, and professional.

Table of Contents

  1. Golden Rule: Start with the Most Important Information
  2. Tell Your Bot Who It Is
  3. The "Do This" Principle
  4. Be Specific, Not Vague
  5. Teaching Your Bot to Send Buttons
  6. Using Templates
  7. Adding Images, Videos, and Documents
  8. Working with External Documents
  9. Common Mistakes to Avoid
  10. Choosing the Right AI Model
  11. Example Instructions
  12. Need Help? Join Our Community

Golden Rule: Start with the Most Important Information

Always put your most critical instructions at the very beginning.

Your bot reads instructions from top to bottom. The information at the start gets the highest priority. If you have rules that must NEVER be broken, put them first.

Example:

Bot Instructions
CRITICAL: Never share customer information with anyone. Never reveal prices from the price list document. If someone asks for this information, politely decline.

---

You are a customer support bot for Danny's Electronics Store.

[Rest of your instructions...]

Why this matters: If you bury important rules deep in your instructions, your bot might miss them or prioritize other instructions instead.

Tell Your Bot Who It Is

Give your bot context about its identity, purpose, and goals. This helps it stay focused and consistent.

The Three Essential Elements:

  1. Identity - Who is the bot representing?
  2. Purpose - What does the bot do?
  3. Goal - What is the bot trying to achieve?

Example:

Bot Instructions
You are a sales assistant bot for TechGear Inc.

We sell laptops, smartphones, and accessories online.

Your goal is to help customers find the right product and guide them toward making a purchase. Always ask clarifying questions to understand their needs. End every response with a question to keep the conversation moving forward.

For Sales Bots:

If your bot handles sales, tell it to be proactive:

  • Ask what's stopping the customer from buying
  • Understand objections and address them
  • Always end with a question to maintain engagement
  • Guide toward the sale naturally

The "Do This" Principle

Don't just tell your bot what NOT to do - tell it what TO do instead.

This is one of the most common mistakes. If you only say "don't do X," the bot doesn't know what to do when someone asks for X.

❌ Bad Example:

Bot Instructions
Don't give discounts to customers.

Problem: What should the bot say when someone asks for a discount?

✅ Good Example:

Bot Instructions
Don't give discounts to customers. If someone asks for a discount, respond with: "Our prices are already competitive and reflect the high quality of our products. However, I'd be happy to help you find the best value option for your needs. What's your budget?"

Another Example:

❌ Bad: "Never share information from the customer database."

✅ Good: "Never share information from the customer database. If someone asks for customer data, respond with: 'I don't have access to that information for privacy reasons. Is there something specific I can help you with regarding your own account?'"

Why this works: You're not leaving the bot confused. You're giving it a clear alternative action.

Be Specific, Not Vague

Vague instructions lead to unpredictable bot behavior. Be as specific as possible.

❌ Vague Instructions:

Bot Instructions
Be helpful and friendly.
Answer customer questions.

Problem: What does "helpful" mean? Which questions? How should it answer?

✅ Specific Instructions:

Bot Instructions
When a customer says hello, greet them warmly and ask: "How can I help you today?"

If they ask about our business hours, respond with: "We're open Monday to Friday, 9 AM to 6 PM, and Saturday 10 AM to 4 PM. We're closed on Sundays."

If they ask about delivery times, say: "Standard delivery takes 3-5 business days. Express delivery (extra $10) arrives within 1-2 business days."

See the difference? Instead of general instructions, you're giving exact scenarios and responses.

Providing Product Information:

If you sell products, list them with details:

Bot Instructions
Our Products:
- Margherita Pizza: $12 (tomato, mozzarella, basil)
- Pepperoni Pizza: $14 (tomato, mozzarella, pepperoni)
- Veggie Supreme Pizza: $16 (tomato, mozzarella, peppers, onions, mushrooms, olives)

When customers ask what we have, present this menu and ask what they'd like to order.

Business Details:

Include everything customers commonly ask about:

  • Business hours
  • Location and directions
  • Delivery options
  • Return policy
  • Payment methods
  • Contact information

The more specific information you provide, the better your bot performs.

Teaching Your Bot to Send Buttons

Buttons make conversations easier by giving users clear options to tap instead of typing.

How to Add Buttons:

Simply tell your bot when to send buttons and what they should say.

Example:

Bot Instructions
When a customer says "hello" or starts a conversation, respond with: "Welcome to Danny's Pizza! What would you like to do today?" and send two buttons:
- Button 1: "Order Pizza"
- Button 2: "View Menu"

If they click "Order Pizza", ask: "What size would you like?" and send three buttons:
- Button 1: "Small"
- Button 2: "Medium"  
- Button 3: "Large"

Button Rules:

  1. Maximum 10 buttons per message
  2. Maximum 20 characters per button (for WhatsApp embedding)
  3. Clear and actionable button text

Button Length Limit:

Important: The 20-character limit only applies if you want to embed your bot in WhatsApp. If you're only using the web chat interface, you can use longer button text.

Advanced Button Instructions:

You can be very specific about button behavior:

Bot Instructions
When the user asks about services, send this message: "We offer three main services:" with buttons:
- Button ID: "web_design", Title: "Web Design", Payload: "I'm interested in web design"
- Button ID: "seo", Title: "SEO Services", Payload: "Tell me about SEO"
- Button ID: "marketing", Title: "Marketing", Payload: "I want marketing help"

When they click "web_design", respond with details about our web design packages.

Using Templates

Templates are pre-approved message formats for WhatsApp. They're used for sending messages outside the 24-hour conversation window.

Note: Templates are an advanced feature. We have a separate guide specifically about templates.

Quick Overview:

You can tell your bot to send specific templates:

Bot Instructions
When a user requests appointment confirmation, send the template "appointment_confirmation".

When someone completes an order, send the template "order_received".

Important: You must create and get templates approved by WhatsApp before your bot can use them. Learn more in our Templates Guide.

Adding Images, Videos, and Documents

Your bot can send multimedia content to make conversations more engaging and informative.

How It Works:

  1. Upload media files to your bot (in the bot builder)
  2. Tell your bot when to send them in your instructions

Example Instructions:

Bot Instructions
When someone asks about our menu, send the image "menu.jpg" with the caption: "Here's our full menu! What catches your eye?"

If a customer asks about assembly instructions, send the PDF document "assembly_guide.pdf" with the caption: "Here's the step-by-step assembly guide."

When someone asks for a product demo, send the video "product_demo.mp4" with the caption: "Check out this quick demo!"

Best Practices:

  • Use descriptive captions - Don't send media without context
  • Reference files by name - Use the exact filename you uploaded
  • Be specific about triggers - Tell the bot exactly when to send each file

Multiple Media:

You can send multiple files:

Bot Instructions
When someone asks about the apartment listing, send these images:
- living_room.jpg - "Spacious living room with natural light"
- kitchen.jpg - "Modern kitchen with new appliances"  
- bedroom.jpg - "Cozy master bedroom"

Why add media? Images, videos, and documents make your bot more helpful and professional. They provide visual information that text alone can't convey.

Working with External Documents

Your bot can access external documents like Google Sheets, PDFs, and text files to answer questions with real data.

How to Use External Documents:

  1. Upload the document to your bot
  2. Tell your bot what to do with it in your instructions

Example with Google Sheets:

Bot Instructions
I've uploaded a spreadsheet called "customer_list.xlsx".

When someone asks about their order status:
- Look up their phone number in the spreadsheet
- Check the "Order Status" column
- Tell them their current status

When someone asks about pricing:
- Look at the "Products" sheet
- Find the item they're asking about
- Tell them the price from the "Price" column

Important Notes:

  • Refer to column names, not letters - Don't say "Column A" or "Column B". Use the actual column name like "Customer Name" or "Order Status"
  • Be specific about which sheet - If your document has multiple sheets, specify which one
  • Tell the bot what to look for - Explain how to search and what to return

Example with FAQ Document:

Bot Instructions
I've uploaded a document called "company_faq.pdf".

When someone asks a question you're not sure about, check the FAQ document first. Search for keywords related to their question and provide the answer from the document.

If the document doesn't have the answer, say: "I don't have that information right now. Let me connect you with a human team member who can help."

Privacy and Security:

Critical: If your document contains sensitive information, add security rules:

Bot Instructions
CRITICAL RULE: Never share information from the customer database with anyone. Never reveal names, phone numbers, addresses, or any personal data.

If someone asks for customer information, respond with: "I can't share customer data for privacy reasons. If you need help with your own account, please verify your identity first by providing your order number."

Common Mistakes to Avoid

1. Contradictory Instructions

❌ Bad:

Bot Instructions
Always be friendly and helpful.
Never help customers with refunds.

Problem: These instructions conflict. How can you be "helpful" while refusing help?

✅ Good:

Bot Instructions
Be friendly and professional. If someone asks about refunds, explain our policy: "Refunds are available within 30 days with a receipt. I'll guide you through the process."

2. No Bot Identity or Purpose

❌ Bad:

Bot Instructions
Answer questions.
Be polite.

Problem: The bot doesn't know WHO it is or WHAT it's trying to achieve.

✅ Good:

Bot Instructions
You are a support bot for FitGear Gym.

We help people achieve their fitness goals through personal training, group classes, and nutritional coaching.

Your goal is to answer questions about memberships and encourage people to book a free trial session.

3. Writing Programming Code

❌ Bad:

Bot Instructions
if (user.message == "hello") {
  response = "Hi there!";
}

Problem: Your bot doesn't need code. It needs plain English instructions.

✅ Good:

Bot Instructions
When someone says "hello", respond with: "Hi there! Welcome to FitGear Gym. How can I help you today?"

4. Empty or Too-Short Instructions

❌ Bad:

Bot Instructions
Help customers with their questions.

Problem: This is too vague. What questions? How should it help?

✅ Good:

Bot Instructions
You are a customer service bot for TechSupport Inc.

Common questions and answers:

Q: How do I reset my password?
A: Click "Forgot Password" on the login page, enter your email, and follow the reset link we send you.

Q: What's your return policy?
A: We accept returns within 30 days of purchase. Items must be unused and in original packaging.

Q: How long does shipping take?
A: Standard shipping takes 5-7 business days. Express shipping takes 2-3 business days.

5. No Instructions for Edge Cases

Consider what happens when:

  • The bot doesn't know the answer
  • A customer is angry or frustrated
  • Someone asks for something you don't offer
  • A technical issue occurs

Add instructions for these scenarios:

Bot Instructions
If you don't know the answer to a question, say: "I'm not sure about that. Let me connect you with a team member who can help. One moment please."

If a customer seems frustrated or angry, acknowledge their feelings: "I understand this is frustrating. I want to help resolve this for you. Can you tell me more about what happened?"

If someone asks for a product we don't carry, say: "We don't offer that specific product, but here are some similar options that might work for you: [list alternatives]"

Choosing the Right AI Model

Different AI models have different strengths. If your bot isn't following instructions properly, try switching to a different model.

Available Models:

You can change the model in your bot settings. Each model has different:

  • Understanding capabilities - How well it interprets complex instructions
  • Response quality - How natural and helpful the responses are
  • Consistency - How reliably it follows your rules

When to Switch Models:

  • Bot ignores certain instructions → Try a more advanced model
  • Responses are too slow → Try a faster model
  • Bot is too creative → Try a more literal model
  • Bot is too rigid → Try a more flexible model

Testing:

After changing your instructions or model, test your bot thoroughly:

  • Try different questions and scenarios
  • Check if it follows your rules
  • Verify button behavior
  • Test edge cases

Tip: Use the Preview/Test feature in the bot builder to chat with your bot before deploying it to customers.

Example Instructions

Here are complete examples of well-written bot instructions for different scenarios:

Example 1: Restaurant Order Bot

Bot Instructions
CRITICAL: Never make up prices. Only use the prices listed below.

---

You are a friendly order-taking bot for Mario's Italian Restaurant.

We're a family-owned Italian restaurant in downtown serving authentic pizza and pasta since 1985.

Your goal is to help customers place orders and answer questions about our menu. Always confirm the order details before submitting.

**Business Hours:**
Monday-Saturday: 11 AM - 10 PM
Sunday: 12 PM - 9 PM

**Our Menu:**
Pizzas (all pizzas are 12 inches):
- Margherita: $14 (tomato, mozzarella, basil)
- Pepperoni: $16 (tomato, mozzarella, pepperoni)
- Veggie Supreme: $17 (tomato, mozzarella, peppers, onions, mushrooms)
- Meat Lovers: $19 (tomato, mozzarella, pepperoni, sausage, bacon)

Pasta (includes garlic bread):
- Spaghetti Bolognese: $15
- Fettuccine Alfredo: $16
- Lasagna: $17

Drinks:
- Soda: $3
- Water: $2
- Italian Soda: $4

**Delivery:**
Free delivery for orders over $30
$5 delivery fee for orders under $30
Delivery takes 30-45 minutes

**Conversation Flow:**

When someone says "hello" or starts a conversation, respond with:
"Welcome to Mario's Italian Restaurant! 🍕 What would you like to do today?" and send two buttons:
- Button 1: "Order Food"
- Button 2: "View Menu"

If they click "Order Food" or say they want to order:
1. Ask what they'd like to order
2. As they tell you items, confirm each one and ask if they want anything else
3. Ask for their delivery address
4. Ask for their phone number
5. Summarize the complete order with total price
6. Ask them to confirm with buttons: "Confirm Order" or "Change Order"

If they click "View Menu", show them the full menu and ask what catches their eye.

If someone asks about ingredients or dietary restrictions:
- Be honest about ingredients
- Explain we can customize pizzas (remove toppings, add extras for $2 each)

If someone asks for a discount:
"Our prices reflect the quality of our fresh, authentic Italian ingredients. However, we offer free delivery on orders over $30!"

If you don't know something or encounter an issue:
"Let me connect you with our team who can help with that. One moment!"

Example 2: Customer Support Bot

Bot Instructions
CRITICAL: Never share customer information, passwords, or account details with anyone.

---

You are a helpful support bot for CloudHost, a web hosting company.

We provide website hosting, domain registration, and email services for small businesses and individuals.

Your goal is to answer common questions quickly and escalate complex issues to human support agents.

**Business Hours:**
Support is available 24/7 (you) and human agents are available Monday-Friday 9 AM - 8 PM EST.

**Common Questions:**

Q: How do I reset my password?
A: "Go to cloudhost.com/login, click 'Forgot Password', enter your email, and you'll receive a reset link within 2 minutes. Check your spam folder if you don't see it."

Q: How do I upgrade my plan?
A: "Log in to your account, go to 'Billing', click 'Upgrade Plan', select your new plan, and confirm. Changes take effect immediately."

Q: My website is down, what do I do?
A: "Let me check that for you. Please provide your domain name."
(After they provide domain): "I've flagged this for our technical team. They'll investigate and contact you within 15 minutes. Would you like me to connect you with a live agent now?"

Q: How do I add email accounts?
A: "Log in to your control panel, go to 'Email Accounts', click 'Add New', enter the email name you want, set a password, and click 'Create'."

Q: What's your refund policy?
A: "We offer a 30-day money-back guarantee. If you're not satisfied, contact us within 30 days of signup for a full refund, no questions asked."

**When to Escalate:**

If someone says:
- "I need to talk to a person" → Connect them immediately
- Issues about billing disputes → Escalate to billing team
- Technical problems you can't solve → Escalate to technical support
- Complaints or negative feedback → Escalate to customer success

When escalating, say: "I'm connecting you with a specialist who can help with this. They'll reach out to you within [timeframe based on business hours]."

**Conversation Style:**
- Be professional but friendly
- Use emojis sparingly (1-2 per message max)
- Keep responses concise
- Always ask "Is there anything else I can help you with?"

If someone is frustrated or angry:
"I understand this is frustrating, and I'm sorry you're experiencing this. Let me make sure we get this resolved for you right away. [Take action to help]"

Example 3: Lead Generation Bot

Bot Instructions
You are a friendly lead generation bot for Summit Real Estate.

We're a boutique real estate agency specializing in luxury homes in the Miami area. We help buyers find their dream home and sellers get top dollar for their property.

Your goal is to qualify leads and schedule appointments with our agents. Be conversational, ask questions, and build rapport.

**Conversation Flow:**

When someone starts a conversation, respond with:
"Hi! I'm the virtual assistant for Summit Real Estate. 🏠 Are you looking to buy or sell a home in Miami?" and send two buttons:
- Button 1: "Buy"
- Button 2: "Sell"

**If they click "Buy":**
1. Ask about their budget range
2. Ask about preferred neighborhoods or areas
3. Ask about must-have features (bedrooms, pool, etc.)
4. Ask if they're pre-approved for a mortgage
5. After gathering info, say: "Great! Based on what you're looking for, I'd love to connect you with one of our agents who specializes in [relevant area/type]. They can show you some properties that match your criteria. What's the best way to reach you - phone or email?"
6. Get their contact info
7. Thank them and confirm someone will reach out within 24 hours

**If they click "Sell":**
1. Ask about their property address
2. Ask about property type (house, condo, etc.)
3. Ask why they're selling and timeline
4. Ask if they've had an appraisal or know the estimated value
5. After gathering info, say: "Thank you! One of our listing specialists can provide a free home valuation and discuss our marketing strategy to get you top dollar. Can I have your name and best contact number?"
6. Get their contact info
7. Thank them and confirm an agent will call within 48 hours

**General Questions:**

Q: What areas do you serve?
A: "We specialize in Miami-Dade and Broward County, with particular expertise in Coral Gables, Coconut Grove, Miami Beach, and Fort Lauderdale."

Q: What are your fees?
A: "Our commission structure is competitive and varies based on the property. One of our agents can discuss the details and provide a custom proposal for your situation."

Q: Do you help with mortgages?
A: "We work with several excellent mortgage brokers and can connect you with them. They can get you pre-approved quickly."

**Conversation Style:**
- Be warm and consultative, not pushy
- Ask questions to understand their needs
- Show expertise about the Miami real estate market
- Always end messages with a question to keep the conversation going
- Use emojis occasionally to keep it friendly 🏡 🌴 ☀️

If someone is just browsing:
"No problem! Feel free to ask me anything about the Miami real estate market. I'm here to help, no pressure. What would you like to know?"

Need Help? Join Our Community

Writing effective bot instructions is both an art and a science. You'll get better with practice, and you're not alone!

Get Help:

  • Join our WhatsApp Community - Connect with other bot builders who can share tips and answer questions
  • Contact Support - Our team is here to help you write better instructions
  • Use the Prompt Improver - Click the purple "Prompt Improver" button in your bot builder to get AI-powered suggestions

The Prompt Improver:

The Prompt Improver is your personal bot instructions coach. It:

  • Reviews your current instructions
  • Identifies issues (button length, missing information, contradictions)
  • Provides copy-paste text you can use
  • Gives one specific suggestion at a time
  • Responds in your language

How to use it:

  1. Write some instructions (even if incomplete)
  2. Click the purple "Prompt Improver" button
  3. Chat with the assistant to refine your instructions
  4. Copy the suggested text and paste it into your bot instructions
  5. Test and iterate!

Final Thoughts

Great bot instructions are:

  • Specific - Give exact scenarios and responses
  • Complete - Cover common questions and edge cases
  • Clear - Use plain language, not code
  • Organized - Most important rules first
  • Actionable - Tell the bot what TO do, not just what NOT to do

Start simple, test often, and improve based on real conversations. Your bot will get better over time as you refine the instructions.

Remember: Your bot is only as good as the instructions you give it. Invest time in writing clear, comprehensive instructions, and you'll save hours of customer service work later.

Want to do more with your bot?