In questo corso costruirai e comprenderai un chatbot web completo basato su un progetto reale: un widget JavaScript embeddabile e un backend FastAPI che espone API REST per configurazione, inizializzazione sessione e chat. Vedrai come strutturare un servizio multi-tenant tramite site_id, come integrare un provider LLM mantenendo controllo su contesto, history e output, e come progettare contratti request/response chiari con validazione Pydantic, gestione errori coerente e CORS. Affronteremo anche gli aspetti pratici che fanno la differenza in un progetto reale: limiti sulla history e sulla lunghezza dei messaggi, protezione anti-bot con Cloudflare Turnstile, variabili d'ambiente e checklist di configurazione per passare da locale a produzione senza sorprese. Chiudiamo con il deploy minimale in produzione tramite Apache reverse proxy, HTTPS con Let's Encrypt e process manager, fino al flusso end-to-end dall'aggiunta di un nuovo tenant alla generazione dello snippet JavaScript da integrare nel sito.

- Sviluppatori web junior e mid che vogliono un esempio end-to-end riutilizzabile tra widget e API. - Freelance e consulenti che devono consegnare un chatbot deployabile e protetto da abusi. - Backend developer che vogliono coprire anche l'integrazione frontend tramite widget embeddabile. - Maker e founder tecnici che vogliono un MVP multi-sito con prompt e limiti per tenant. - Chi usa Cursor come acceleratore, mantenendo controllo su codice e flusso di lavoro.

- Comprendere e progettare API REST per un chatbot con endpoint, JSON, status code ed error handling. - Leggere e modificare un backend FastAPI reale con routing, validazione Pydantic, CORS e risposte coerenti. - Integrare un widget JavaScript embeddabile che chiama le API e gestisce lo stato della chat. - Integrare un LLM via API usando system prompt e limiti per controllare output, contesto e costi. - Applicare Cloudflare Turnstile end-to-end con configurazione client e verifica server-side. - Gestire la multi-tenancy tramite site_id con configurazioni per dominio, hostname, prompt e limiti per tenant. - Impostare un deploy minimale con Apache reverse proxy e HTTPS tramite Certbot seguendo una checklist operativa.

- Conoscenze base di programmazione e capacità di leggere codice. - Un PC con editor come VS Code e un browser moderno. - Python per eseguire e comprendere il backend FastAPI. - Per la parte deploy, un server Linux o VPS con dominio e accesso SSH è utile ma opzionale.

Introduzione

1 lezioni

Presentazione docente e panoramica del corsoAnteprima16 min

REST in FastAPI (fondamenti sul progetto)

2 lezioni

REST per il chatbot: endpoint, JSON e status code36 min
Pratica: leggiamo app/main.py (Pydantic, CORS, errori)15 min

Tour del progetto e widget embeddabile

2 lezioni

Teoria: architettura e flusso end-to-end della chat35 min
Pratica: widget JS (embed, UI, chiamate API)29 min

LLM e multi-tenant (site_id)

2 lezioni

Teoria: system prompt e limiti per tenant28 min
Pratica: /api/chat e client LLM (Groq)20 min

Cloudflare Turnstile (anti-bot)

2 lezioni

Teoria: come funziona Turnstile nel nostro flusso33 min
Pratica: crea e configura Turnstile su Cloudflare20 min

Deploy minimale e chiusura

5 lezioni

Teoria: reverse proxy e HTTPS (cosa serve davvero)40 min
Teoria: process manager e variabili d'ambiente (pm2 e .env)18 min
Pratica: leggiamo i vhost Apache e verifichiamo il proxy10 min
Pratica: aggiungere un tenant e update automatici (GitHub Actions)4 min
Pratica: test del chatbot in azione2 min

Chatbot AI per Siti Web con JavaScript, FastAPI e Turnstile

Descrizione del corso

Destinatari

Obiettivi

Prerequisiti

Chatbot AI per Siti Web con JavaScript, FastAPI e Turnstile

Descrizione del corso

Destinatari

Obiettivi

Prerequisiti