🚀 Deploy e Manutenzione - Crafter.ai

Questa guida completa ti accompagnerà attraverso il processo di pubblicazione del tuo chatbot e la sua gestione nel tempo, inclusi aggiornamenti, manutenzione e monitoraggio.

🎯 Panoramica dello Step Deploy

Lo step Deploy è la fase finale dove:

• 🔧 Verifichi i prerequisiti per la pubblicazione
• 🚀 Pubblichi il chatbot sui server di produzione
• 🔗 Ottieni il codice per l'integrazione nel sito
• 🔄 Gestisci aggiornamenti e manutenzione

✅ Prerequisiti per il Deploy

Verifiche Tecniche Obbligatorie

1. Training Completato

✅ Status: "Trained"
✅ Knowledge Base: Popolata e processata
✅ Q&A Base: Minimo 10 Q&A attive
✅ Survey: Completato al 100%

2. Piano Attivo e Valido

✅ Subscription: Attiva e non scaduta
✅ Message Limit: Non raggiunto (< 100% usage)
✅ Payment Status: Aggiornato
✅ Team License: Valida per deploy

3. Configurazione Completa

✅ Bot Info: Nome e descrizione impostati
✅ Features: Funzionalità configurate
✅ Appearance: Personalizzazione completata
✅ Settings: Comportamenti configurati

Stati Possibili Pre-Deploy

🟢 Ready to Deploy

Tutti i prerequisiti sono soddisfatti

• Pulsante "Deploy" attivo
• Processo può iniziare immediatamente
• Stima tempo: 3-8 minuti

🟡 Needs Update (Outdated)

Chatbot esistente ma modificato

• Modifiche alla knowledge base
• Aggiornamenti alle Q&A
• Nuove configurazioni chatroom
• Azione: Clicca "Update Bot"

🔴 Cannot Deploy

Prerequisiti non soddisfatti

Possibili cause e soluzioni:

📚 Survey Incompleto

Errore: "Incomplete survey"
Soluzione: 
1. Vai al Teaching Step
2. Completa tutte le domande del survey
3. Salva e torna al Deploy

🎓 Bot Non Addestrato

Errore: "The chatbot is not trained"
Soluzione:
1. Vai al Teaching Step  
2. Clicca "Train Bot"
3. Attendi completamento
4. Torna al Deploy

💳 Problemi di Piano

Errore: "Upgrade chatbot plan"
Soluzione:
1. Verifica piano attivo
2. Controlla limiti messaggi
3. Aggiorna pagamento se necessario
4. Contatta amministratore team

⚠️ Limite Messaggi Raggiunto

Errore: "Message usage limit reached"
Soluzione:
1. Upgrade piano corrente
2. Swap a licenza disponibile
3. Attendi reset mensile contatore

🚀 Processo di Deploy

Deploy di un Nuovo Chatbot

Step 1: Avvio Deploy

1. Verifica prerequisiti: Tutti i check devono essere ✅
2. Clicca "Deploy Chatbot": Inizia il processo
3. Conferma azione: Il processo non è reversibile durante l'esecuzione

Step 2: Fasi del Deploy

Il sistema esegue automaticamente queste operazioni:

🔄 Starting Server (30-60 secondi)
   ├── Allocazione risorse server
   ├── Configurazione ambiente
   └── Inizializzazione servizi

🔄 Loading Knowledge Base (1-3 minuti)  
   ├── Upload knowledge base
   ├── Indicizzazione contenuti
   └── Ottimizzazione ricerca

🔄 Update Models (2-4 minuti)
   ├── Caricamento modelli AI
   ├── Configurazione pipeline NLP
   └── Testing automatico

✅ Deploy Completed!

Tempo totale stimato: 3-8 minuti a seconda delle dimensioni della knowledge base

Step 3: Completamento

Al termine riceverai:

• ✅ Conferma deploy completato
• 🔗 Codice di integrazione per il sito web
• 🌐 URL demo page per testing
• 📊 Link dashboard analytics

Update di un Chatbot Esistente

Quando è Necessario un Update

Update Modelli (dopo modifiche knowledge base):

• Nuove Q&A aggiunte
• Modifiche a Q&A esistenti
• Upload nuovi documenti
• Modifiche al survey

Update Chatroom (dopo modifiche UI):

• Cambio colori o font
• Nuove configurazioni settings
• Modifiche ai messaggi di sistema
• Aggiornamenti privacy policy

Tipi di Update

Update Rapido (Chatroom Only)

Tempo: 30-90 secondi
Include: 
├── Aggiornamento aspetto
├── Nuove impostazioni UI
└── Configurazioni chatroom

Update Completo (Models + Chatroom)

Tempo: 2-5 minuti
Include:
├── Ritraining modelli AI
├── Aggiornamento knowledge base  
├── Nuove Q&A e contenuti
└── Tutte le modifiche UI

Update con Restart Server

Tempo: 3-8 minuti
Include:
├── Restart completo server
├── Aggiornamento versione sistema
├── Modifiche architetturali
└── Update maggiori di configurazione

🔗 Integrazione nel Sito Web

Codice di Integrazione

Codice Standard

Alla fine del deploy riceverai un codice simile a questo:

        <!-- BEGIN CRAFTER CHATROOM -->
        <script async src="YOUR_LINK"></script>
        <!-- END CRAFTER CHATROOM -->

Dove Inserire il Codice

✅ Posizionamento Corretto:

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Il Tuo Sito</title>
    
    <!-- Altri tag head -->
    
    <!-- INSERISCI IL CODICE CHATBOT QUI -->
    <script>/* Codice Crafter.ai */</script>
    
</head>
<body>
    <!-- Contenuto della pagina -->
</body>
</html>

❌ Posizionamenti Scorretti:

• Nel <body> → Può causare ritardi nel caricamento
• Dopo altri script → Possibili conflitti
• In file JS esterni → Problemi di timing

Troubleshooting Integrazione

Widget Non Appare

Possibili cause:

🔍 Controllo 1: Console del browser
   → Apri Developer Tools (F12)
   → Cerca errori JavaScript
   → Verifica caricamento script

🔍 Controllo 2: Network tab
   → Verifica download bundle.js
   → Controlla response status (deve essere 200)
   → Verifica non ci sono blocchi CORS

🔍 Controllo 3: Bot Status
   → Vai nella dashboard Crafter.ai
   → Verifica stato = "Deployed"
   → Controlla ultimo deploy successful

Soluzioni comuni:

🔧 Errore CORS:
   → Verifica dominio autorizzato in dashboard
   → Aggiungi dominio nelle impostazioni bot

🔧 Script Blocked:
   → Controlla ad-blocker
   → Verifica Content Security Policy
   → Whitelist cdn.crafter.ai

🔧 Bot ID Errato:
   → Copia/incolla bot ID dalla dashboard
   → Verifica non ci sono spazi extra

Widget Appare ma Non Funziona

Debug steps:

1. Testa su demo page ufficiale
2. Confronta comportamento
3. Verifica versione widget (latest vs specifica)
4. Testa in modalità incognito
5. Disabilita altre estensioni/script

📊 Monitoraggio e Analytics

Dashboard Deploy

Stato Server in Tempo Reale

🟢 Deployed: Server attivo e funzionante
🟡 Updating: Aggiornamento in corso
🔴 Offline: Server offline o errore
🟠 Outdated: Serve aggiornamento

Logs e Diagnostica

Accesso ai log:

1. Dashboard Deploy → "View Logs"
2. Filtro per data/ora
3. Livelli: Info, Warning, Error
4. Export per analisi approfondite

Analytics Avanzati

Metriche di Performance

📈 Success Rate: % conversazioni risolte con successo
📈 User Satisfaction: Rating medio utenti (1-5 stelle)
📈 Average Session Duration: Durata media conversazioni
📈 Bounce Rate: % utenti che abbandonano subito
📈 Conversion Rate: % obiettivi completati

Analytics Comportamentali

🔍 Most Asked Questions: Domande più frequenti
🔍 Unresolved Queries: Domande senza risposta
🔍 User Flow Paths: Percorsi conversazioni comuni
🔍 Drop-off Points: Dove gli utenti abbandonano
🔍 Peak Usage Times: Orari di maggior utilizzo

Report Automatici

Configurazione report:

• Frequenza: Giornaliera, settimanale, mensile
• Destinatari: Team members via email
• Formato: PDF executive summary o Excel dettagliato
• Metriche personalizzate: Scegli KPI rilevanti

Alerting e Notifiche

Alert Automatici

⚠️ Downtime Alert: Server offline > 2 minuti
⚠️ High Error Rate: > 10% errori in 1 ora
⚠️ Low Success Rate: < 70% conversazioni risolte
⚠️ Usage Spike: Traffico > 300% normale
⚠️ Storage Limit: Knowledge base > 90% limit

Canali di Notifica

• Email: Alert immediati via email
• Slack/Teams: Integrazione chat aziendale
• Webhook: Integrazione sistemi custom
• SMS: Alert critici (optional)

🔄 Gestione Aggiornamenti

Pianificazione Aggiornamenti

Ciclo di Aggiornamento Consigliato

📅 Aggiornamenti Routine:
├── Quotidiano: Review nuove conversazioni
├── Settimanale: Analisi misses e miglioramenti
├── Mensile: Review performance e ottimizzazioni
└── Trimestrale: Revisione strategica knowledge base

🔄 Aggiornamenti Reattivi:
├── Immediato: Errori critici o informazioni sbagliate
├── Entro 24h: Nuove FAQ o domande frequenti
├── Entro settimana: Miglioramenti UX significativi
└── Su richiesta: Nuove funzionalità business

Best Practice Timing

Orari consigliati per aggiornamenti:

• 🌙 Ore notturne: 02:00-05:00 (minor traffico)
• 📅 Weekend: Sabato sera o domenica mattina
• 🚫 Evitare: Ore di punta, giorni promozionali

Hotfix Deployment

Per correzioni urgenti:

1. Identificazione problema critico
2. Fix rapido e testing essenziale
3. Deploy immediato con monitoring intensivo
4. Comunicazione team e stakeholder
5. Post-mortem e lesson learned

🛠️ Manutenzione Preventiva

Routine di Manutenzione

Controlli Quotidiani (5-10 minuti)

✅ Server Status: Verifica uptime e performance
✅ Error Logs: Review errori delle ultime 24h
✅ New Conversations: Analisi nuove conversazioni
✅ Usage Metrics: Controllo utilizzo risorse

Controlli Settimanali (30-45 minuti)

📊 Analytics Review: Analisi performance settimanale
🔍 Misses Analysis: Review domande senza risposta
🔧 Knowledge Base Update: Aggiornamento contenuti
📱 User Feedback: Review rating e commenti
🧪 Regression Testing: Test funzionalità critiche

Controlli Mensili (2-3 ore)

📈 Performance Report: Report completo mensile
🗂️ Knowledge Base Cleanup: Rimozione contenuti obsoleti
🔄 Workflow Optimization: Ottimizzazione flow complessi
👥 Team Training: Aggiornamento team su novità
💾 Backup Verification: Verifica backup e recovery

Controlli Trimestrali (Mezza giornata)

🎯 Strategic Review: Allineamento obiettivi business
🔍 Comprehensive Audit: Audit completo sistema
🔧 Infrastructure Review: Review architettura e scalabilità
📚 Training Data Review: Pulizia e ottimizzazione dati
🛡️ Security Audit: Revisione sicurezza e compliance

Ottimizzazione Performance

Monitoring KPI Chiave

🎯 Target Performance:
├── Response Time: < 2 secondi
├── Uptime: > 99.5%
├── Success Rate: > 85%
├── User Satisfaction: > 4.0/5.0
└── Error Rate: < 5%

Ottimizzazioni Comuni

⚡ Knowledge Base:
├── Rimozione duplicati
├── Consolidamento Q&A simili
├── Ottimizzazione indicizzazione
└── Pulizia contenuti obsoleti

🚀 Server Performance:
├── Cache optimization
├── Database query optimization
├── CDN configuration
└── Resource scaling

📋 Troubleshooting Comuni

Problemi di Deploy

Deploy Fallisce

Errore: "Deploy failed - server error"

Soluzioni:
1. Retry dopo 5-10 minuti
2. Verifica status sistema (status.crafter.ai)
3. Controlla limiti piano non superati
4. Contatta supporto con logs errore

Deploy Molto Lento

Problema: Deploy richiede > 15 minuti

Cause possibili:
├── Knowledge base molto grande (> 100MB)
├── Molte Q&A (> 500)
├── Server overload temporaneo
└── Network issues

Soluzioni:
├── Ottimizza knowledge base
├── Suddividi deploy in più fasi
├── Riprova in orari minor carico
└── Verifica connessione internet

Problemi Post-Deploy

Chatbot Non Risponde

Debug checklist:
1. Verifica bot status = "Deployed"
2. Testa su demo page ufficiale
3. Controlla integration code corretto
4. Verifica dominio autorizzato
5. Check browser console errori

Risposte Incorrect

Analisi:
1. Review conversation logs
2. Identifica pattern errori comuni
3. Verifica knowledge base aggiornata
4. Check training completato correttamente
5. Analizza conflitti Q&A

Performance Degradate

Investigazione:
1. Monitor resource usage
2. Analizza response times
3. Verifica database performance
4. Check concurrent users limits
5. Review error rate trends

✅ Checklist Deploy e Manutenzione

Pre-Deploy Checklist

• Tutti i prerequisiti verificati
• Testing completo effettuato
• Team notificato del deploy
• Backup configuration salvato
• Rollback plan preparato
• Monitoring configurato

Post-Deploy Checklist

• Deploy completato con successo
• Integration code implementato
• Widget funziona correttamente
• Analytics attivi e configurati
• Team training completato
• Documentazione aggiornata

Manutenzione Checklist

• Routine di controllo implementate
• Alert e notifiche configurati
• Performance baseline stabilite
• Backup e recovery testati
• Team responsabilità assegnate
• Escalation procedures definite

🔗 Prossimi Passi

Dopo il deploy di successo:

1. Analytics e ottimizzazione
2. Formare il team
3. Funzionalità avanzate

---

⏱️ Tempo stimato primo deploy: 15-30 minuti (inclusa integrazione)
🎯 Obiettivo: Chatbot live, stabile e monitored in produzione