❓ FAQ e Troubleshooting - Crafter.ai

Questa guida contiene le domande più frequenti, soluzioni ai problemi comuni e best practice per ottimizzare l'uso di Crafter.ai.

🎯 Domande Frequenti (FAQ)

🚀 Introduzione e Setup

Q: Quanto tempo serve per creare il primo chatbot?

A: Per un chatbot base funzionante:

Quick Setup: 15-30 minuti
Setup Completo: 2-4 ore
Setup Avanzato: 1-2 giorni

Il tempo dipende dalla complessità della knowledge base e dal numero di Q&A personalizzate.

Q: Posso creare più chatbot con lo stesso account?

A: Sì, il numero dipende dal piano, consulta la pagina pricing a questo link.

Q: Quali lingue supporta Crafter.ai?

A: Lingue completamente supportate:

🇮🇹 Italiano
🇬🇧 English
🇧🇷 Português (Brasil)
🇪🇸 Español
🇫🇷 Français
🇩🇪 Deutsch

Q: Posso cambiare la lingua del chatbot dopo averlo creato?

A: No

🎓 Teaching e Knowledge Base

Q: Quante Q&A posso creare?

A: Puoi creare Q&A illimitate.

Q: Che formati di file posso caricare?

A: Formati supportati:

Documenti: PDF, DOCX, DOC, TXT, RTF, Excel, CSV, JSON
Dimensione max: 10MB per file

Q: Il chatbot può imparare automaticamente dalle conversazioni?

A: No, Crafter.ai non ha auto-learning automatico per sicurezza e controllo qualità. Tuttavia:

✅ Puoi analizzare i "misses" (conversazioni non risolte)
✅ Ricevi suggerimenti per nuove Q&A
✅ Dashboard analytics per identificare gap nella knowledge base

Q: Come migliorare l'accuratezza delle risposte?

A: Best practice:

Più utterances: Aggiungi varianti di ogni domanda
Linguaggio naturale: Scrivi come parlano i tuoi clienti
Contesto chiaro: Risposte complete e specifiche
Training regolare: Ri-addestra dopo modifiche
Analisi misses: Review conversazioni non risolte

🎨 Personalizzazione e Preview

Q: Posso usare il mio logo come avatar del chatbot?

A: Sì! Formati supportati:

PNG, JPG, SVG
Dimensioni: 64x64px minimo, 256x256px ottimale
Peso: Max 500KB
Forma: Automaticamente resa circolare

Q: Il chatbot è responsive su mobile?

A: Sì, completamente responsive con:

✅ Design mobile-first
✅ Touch-friendly interface
✅ Ottimizzazione automatica font/dimensioni
✅ Test su tutti i device principali

Q: Posso testare il chatbot prima di pubblicarlo?

A: Assolutamente! Nel Preview step hai:

Widget di test integrato: Test interattivo
Demo page: URL temporaneo per test
Team sharing: Condividi con colleghi per feedback

🚀 Deploy e Integrazione

Q: Su quali siti posso integrare il chatbot?

A: Il chatbot funziona su:

✅ Qualsiasi sito web (WordPress, Shopify, custom)
✅ Landing pages
✅ Web app (React, Vue, Angular)
✅ E-commerce (Magento, WooCommerce, Prestashop)

Unico requisito: supporto JavaScript.

Q: Il chatbot rallenta il caricamento del sito?

A: No, se integrato correttamente:

Caricamento asincrono: Non blocca il rendering pagina
CDN globale: Velocità ottimizzata
Lazy loading: Carica solo quando necessario
Bundle ottimizzato: <50KB gzipped

Q: Posso nascondere il chatbot su certe pagine?

A: Si.

Q: Cosa succede se il server del chatbot va offline?

Fallback message: Messaggio personalizzabile di servizio non disponibile
Auto-recovery: Riconnessione automatica

💰 Piani e Fatturazione

Q: Cosa succede se supero il limite di messaggi?

Puoi acquistare pacchetti aggiuntivi di messaggi o effettuare l’upgrade al piano successivo. In questo modo eviti interruzioni del servizio e garantisci la continuità delle conversazioni.

Q: Posso cambiare piano in qualsiasi momento?

A: Sì:

Q: Offrite sconti per no-profit o educational?

A: Contatta info@athics.ai

👥 Team e Collaborazione

Q: Come aggiungo membri al team?

A: Solo Owner e Admin possono:

Impostazioni Team → Invita Membro
Inserisci email del nuovo membro
Seleziona ruolo (Admin, Member)
Invia invito → L'utente riceve email

Q: Posso limitare l'accesso a certi chatbot?

A: Attualmente i permessi sono a livello team, non per singolo chatbot. Soluzioni:

Team separati per progetti diversi.

🔧 Problemi Tecnici

Q: Il chatbot non risponde alle domande che ho inserito

A: Checklist debug:

✅ Training completato? Verifica status "Trained"
✅ Q&A Controlla informazioni nelle Q&A
✅ Utterances sufficienti? Aggiungi varianti della domanda
✅ Linguaggio coerente? Stessa lingua chatbot/domande
✅ Test con frasi esatte: Prova con le exact utterances inserite

Q: Errore "Can't deploy - survey incomplete"

A: Soluzione step-by-step:

Vai al Teaching Step
Verifica Survey section: Tutte le domande devono avere risposte
Salva tutto: Clicca save dopo ogni modifica
Riprova deploy: Torna al Deploy step

A: Troubleshooting:

// 1. Verifica codice nel <head>
// 2. Apri Developer Tools (F12)
// 3. Controlla Console per errori
// 4. Verifica Network tab per 404/500 errors
// 5. Testa su pagina semplice (test.html)

Cause comuni:

Bot ID errato nel codice
Dominio non autorizzato
Content Security Policy troppo restrittiva
Ad-blocker che blocca il widget

🛠️ Troubleshooting Dettagliato

🔍 Diagnostica Problemi

Chatbot Non Risponde Correttamente

Sintomi:

Risponde "Non ho capito" a domande presenti nelle Q&A
Risposte non pertinenti o confuse
Comprensione inconsistente

Diagnosi:

Step 1: Verifica Training Status
├── Dashboard → Bot Status  
├── Deve essere "Trained" (verde)
└── Se "Needs Training": ri-addestra

Step 2: Analizza Utterances
├── Review Q&A con problemi
├── Aggiungi più varianti (min 3-5 per Q&A)
└── Usa linguaggio naturale dei clienti

Step 3: Check Conflitti
├── Teaching → Improve → Conflicts
├── Risolvi sovrapposizioni semantiche
└── Clarifica Q&A ambigue

Step 4: Test Sistematico
├── Prova frasi esatte delle utterances
├── Test varianti progressive
└── Document pattern di fallimento

Soluzioni:

✅ Utterances Expansion:
   Domanda: "Quanto costa la spedizione?"
   Utterances:
   - "Costo spedizione"
   - "Prezzo consegna" 
   - "Tariffe di spedizione"
   - "Spese di trasporto"
   - "Quanto pago per la consegna?"

✅ Context Addition:
   Risposta migliorata:
   "La spedizione costa 4,90€ (standard 3-5 giorni) 
   o 9,90€ (express 1-2 giorni). 
   GRATUITA per ordini sopra 50€!"

Problemi di Deploy

Errore: "Upgrade chatbot plan"

Causa: Piano insufficiente per deploy
Soluzioni:
1. Verifica piano attuale: Dashboard → Billing
2. Check usage: % messaggi utilizzati
3. Upgrade piano se necessario
4. Contatta admin team se non sei owner

Errore: "Deploy failed - server error"

Diagnosi:
1. Retry dopo 5-10 minuti

Deploy infinito (>15 minuti)

Possibili cause:
├── Knowledge base molto grande
├── Molte Q&A (>500)
├── Server overload
└── Network issues

Soluzioni:
├── Ottimizza KB (rimuovi duplicati)
├── Deploy in orari off-peak
├── Contatta supporto se persiste
└── Verifica connessione internet

Widget non visibile

Debug Checklist:
□ Bot status = "Deployed"
□ Codice nel <head>, non nel <body>
□ Bot ID corretto (no spazi extra)
□ No errori JavaScript in console
□ Test in modalità incognito
□ Disabilita ad-blocker temporaneamente

Widget visibile ma non funziona

Diagnosi:
1. Test su demo page ufficiale
2. Confronta comportamento
3. Test cross-browser (Chrome, Firefox, Safari)

🚨 Risoluzione Problemi Urgenti

Chatbot Offline Durante Traffico Alto

Azione Immediata:

1. Check Dashboard Status (2 min)
2. Verify system status page (1 min)
3. Contact support se confirmed outage (immediato)
4. Attiva fallback message se configurato
5. Notifica team/stakeholder

Health Check Routine

Daily (5 minuti):

□ Bot status check
□ Error rate review
□ New conversations scan
□ Usage metrics check

Weekly (30 minuti):

□ Performance trends analysis
□ Misses review e resolution
□ Knowledge base accuracy audit
□ User feedback analysis

Monthly (2 ore):

□ Full performance review
□ Strategic content optimization
□ Team training needs assessment
□ Technology stack review

💡 Best Practice e Suggerimenti

🎯 Ottimizzazione Performance

Content Optimization

✅ Q&A Quality:
├── 1 concept per Q&A (non multiple domande)
├── Risposte complete ma concise (<200 parole)
├── Call-to-action chiari quando appropriati
└── Linguaggio brand-consistent

✅ Knowledge Base:
├── Documenti aggiornati e rilevanti
├── Rimozione contenuti obsoleti
├── Struttura logica e navigabile
└── Format consistency

🎨 UX Best Practice

Conversational Design

✅ Natural Language:
├── Scrivi come parli
├── Evita jargon tecnico
├── Usa emoji con parsimonia 😊
└── Tono coerente con brand

✅ User Journey:
├── Onboarding clear per nuovi utenti
├── Help easily accessible
├── Progress indication per flow lunghi
└── Exit points chiari

Error Handling

✅ Graceful Degradation:
├── Messaggi errore informativi ma friendly
├── Alternative paths quando possibile
├── Handover umano quando necessario
└── Recovery suggestions concrete

📈 Growth e Scaling

Content Scaling Strategy

Phase 1: Core Q&A (0-50 Q&A)
├── Focus su domande più frequenti
├── Perfect core user journeys
└── Stabilisci baseline metrics

Phase 2: Expansion (50-200 Q&A)  
├── Aggiungi edge cases
├── Implement advanced flows
└── Optimize performance

Phase 3: Advanced (200+ Q&A)
├── Specialization per user segments
├── Advanced integrations
└── Predictive capabilities

Team Scaling

Small Team (1-3 people):
├── 1 person: All-in-one (content + tech)
├── 2 people: Content specialist + Tech lead
└── 3 people: + Analytics/optimization specialist

Medium Team (4-10 people):
├── Content Manager
├── Bot Trainer/Optimizer  
├── Technical Lead
├── Analytics Specialist
└── QA/Testing specialist

Large Team (10+ people):
├── Specialized teams per function
├── Dedicated DevOps
├── User research specialist
└── Customer success integration

🆘 Quando Contattare il Supporto

🔴 Supporto Immediato Necessario

Chatbot completamente offline >30 minuti
Perdita dati o corrupted knowledge base
Security incident sospetti

🟡 Supporto Entro 24 Ore

Deploy failures ricorrenti
Performance degradation significativa
Integration issues con servizi critici
Billing/account problems

🟢 Supporto Standard (2-5 giorni)

Feature requests
Training e best practice
General optimization advice
Non-critical technical questions

📞 Come Contattare

Email: support@athics.ai Chat: Chatbot

Informazioni da includere:

Account ID e team name
Bot ID se problema specifico
Detailed description + screenshots
Steps to reproduce
Browser/device info
Urgency level (Critical/High/Medium/Low)

💡 Ricorda: La maggior parte dei problemi ha soluzioni semplici. Segui sempre il processo di debug sistematico prima di contattare il supporto.

Risoluzione Problemi