Documentation
Complete guide from setup to advanced insights - everything you need to maximize your customer insights
🚀 Quick Start Guide
Get up and running in 15 minutes
Step 1: Create your account at app.awareto.com/signup
Step 2: Complete the onboarding wizard (business name, products, competitors)
Step 3: Train your chatbot - add FAQs and product info in Knowledge Base
Step 4: Copy the widget embed code from Dashboard → Widget
Step 5: Paste the code before </body> on your website
Step 6: Test a conversation in test mode
Step 7: Go live - switch off test mode
⚙️ Widget Installation
Platform-specific setup instructions with code examples
Universal JavaScript snippet:
<!-- Paste before </body> -->
<script src="https://app.awareto.com/widget.min.js"></script>
<script>
Awareto.init({
tenantId: 'YOUR_TENANT_ID',
primaryColor: '#4F46E5',
position: 'bottom-right'
});
</script>🛍️ Shopify Installation:
→ Admin → Online Store → Themes → Actions → Edit Code → theme.liquid → paste before </body>
🛒 WooCommerce Installation:
→ Appearance → Theme Editor → footer.php → paste before </body>
Shopware
→ Admin → Content → Shopping Experiences → Add HTML element with code
⚡ Custom HTML Installation:
→ Paste before </body> on any HTML page
📊 Dashboard Guide
Comprehensive overview of each dashboard section
Overview Section:
Conversation volume trends, engagement rates, key performance metrics over time. Your north star numbers.
Purchase Barriers:
Ranked list of what prevents visitors from buying. Frequency, severity, and business impact scores for each barrier.
Awareness Levels:
Eugene Schwartz model distribution - Problem Aware, Solution Aware, Most Aware. Match your messaging to your audience's mindset.
Language Bank:
Real customer phrases organized by theme. Copy-paste into your ads, headlines, and product descriptions.
Ad Angles:
AI-generated creative angle suggestions based on real conversations. Turn objections into advertising opportunities.
Conversations:
Browse individual chat transcripts. Filter by barrier type, awareness level, or product category.
🧠 Knowledge Base Setup
How to train your chatbot for better conversations
Adding Entries:
Create question-answer pairs with keywords. Example: Q: 'Do you ship internationally?' A: 'Yes, we ship worldwide. Shipping costs calculated at checkout.' Keywords: shipping, international, worldwide, delivery
Bulk Import:
Import from existing FAQ pages or CSV files. Drag and drop your FAQ content - AI will format it automatically.
Best Practices:
→ Use natural language, not corporate speak
→ Include specific product details and dimensions
→ Address common objections directly
→ Update seasonal information (shipping delays, inventory)
How Chatbot Uses Knowledge:
AI matches visitor questions to your knowledge base using semantic search. It provides accurate answers while capturing the visitor's underlying concerns for analysis.
❓ Frequently Asked Questions
How long until I see results?
First conversations appear immediately. Patterns emerge after 1-2 weeks with meaningful traffic. Actionable insights ready within 30 days - timing depends on your visitor volume.
What if visitors don't use the chat?
Typical engagement rate is 8-15% of visitors. At 10k monthly visitors, that's 800-1,500 conversations per month - more data points than any survey or user interview study.
Is it GDPR compliant?
Yes. EU servers, no personal data storage, full data portability. GDPR compliance built-in, not bolted on. Data Processing Agreement (DPA) available on request.
Can I customize the chatbot's personality?
Yes, through your business profile and custom prompts. Set tone (professional, friendly, direct), industry context, and specific response guidelines.
What languages does it support?
German and English, auto-detected based on visitor behavior and browser language. Expanding to French and Spanish in Q3 2026.
🔧 Troubleshooting
Widget not appearing?
Check: 1) Code pasted correctly before </body>, 2) No JavaScript errors in console, 3) Tenant ID matches dashboard
No conversations appearing?
Ensure: 1) Widget is visible to visitors, 2) Test mode is enabled for testing, 3) Ad blockers aren't blocking the script
Data looks incomplete?
Wait for statistical significance (100+ conversations) before drawing conclusions. Quality patterns emerge with volume.
Ready to Start Collecting Awareto?
Get started in 15 minutes.