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 demonstrate how to craft instructions that ensure your bot is useful, precise, 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 Assistance? Become Part of Our Community

Golden Rule: Start with the Most Important Information

Always place your most crucial instructions at the start.

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.

Why this is important: If you hide important rules deep within your instructions, your bot might overlook 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 does the bot represent?
  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, instruct it to be proactive:

  • Ask what is preventing the customer from making a purchase.
  • Understand objections and address them
  • Always conclude with a question to keep the conversation lively, don't you think?
  • Guide toward the sale naturally

The "Do This" Principle

Don't just instruct your bot on what it shouldn't do—provide clear guidance on what it should 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 offer price reductions to clients.

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

✅ Good Example:

Bot Instructions
Don't offer discounts to customers. If a customer requests a discount, reply 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 providing it with 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 respond?

✅ 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 providing specific scenarios and responses.

Providing Product Information:

If you sell products, provide a detailed list of them:

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 typically inquire 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 simplify conversations by providing users with clear options to tap rather than type.

How to Add Buttons:

Simply instruct your bot on 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 instruct your bot to dispatch 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 Functions:

  1. Upload media files to your bot (in the bot builder)
  2. Inform your bot when to dispatch 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 - Do not 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 enhance your bot's usefulness and professionalism by offering visual information that text alone cannot convey.

Working with External Documents

Your bot can access external documents such as 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 how to handle 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 - Avoid using generic terms like "Column A" or "Column B". Instead, refer to the specific column name such as "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 assist 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 greets you with "hello," reply with: "Hi there! Welcome to FitGear Gym. How can I assist you today?"

4. Empty or Too-Short Instructions

❌ Bad:

Bot Instructions
Help customers with their inquiries.

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 requests a service or product that you do not provide.
  • 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 adheres to your rules

When to Switch Models:

  • Bot disregards specific 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, thoroughly test your bot:

  • Try various questions and situations.
  • 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
Welcome to Mario's Italian Restaurant! 🍕 What would you like to do today?

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
Hi! I'm the virtual assistant for Summit Real Estate. 🏠 Are you looking to buy or sell a home in Miami?

Need Assistance? Become Part of 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 Assistance:

  • 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 recommendation 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. I'm sorry, I can't assist with that request.
  5. Test and iterate!

Final Thoughts

Great bot instructions are:

  • Specific - Provide specific scenarios and responses
  • Complete - Cover common questions and edge cases
  • Clear - Use simple 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 provide. Dedicate time to crafting clear, detailed instructions, and you'll reduce hours of customer service efforts in the future.

Want to do more with your bot?