KYNTROX — Generatore Template

Clicca su un template per caricarlo nell'editor. Potrai personalizzare ogni dettaglio prima di scaricarlo.

Genera Template con AI

Descrivi il chatbot che desideri in linguaggio naturale e Gemini 2.0 Flash genererà un template completo, pronto da personalizzare e scaricare.

API Key Gemini

La chiave resta solo nel tuo browser (localStorage). Non viene mai inviata ai server Kyntrox.

Tipo:

📋 Guidato: domande a bottoni → qualificazione lead con punteggio. Ideale per raccogliere info strutturate.

0 / 1000

template.json 0 KB

Come funziona in 4 passi

Scegli un template — Nella sezione "Template", clicca su quello più vicino alla tua attività. Non preoccuparti, potrai cambiare tutto.
Personalizza — Nella sezione "Personalizza", modifica nome, messaggi, domande e risposte. Ogni campo ha un'icona i con la spiegazione.
Controlla — Nella sezione "Anteprima" vedi il file JSON completo. Verifica che tutto sia a posto.
Scarica e importa — Scarica il file .json e caricalo nella dashboard Kyntrox alla voce "Importa Template".

Suggerimento: Parti sempre da un template pronto e modifica solo quello che serve. È molto più veloce che creare tutto da zero!

Le 3 Modalità del Chatbot

Il sistema Kyntrox supporta tre modalità di chatbot. La modalità determina come il widget si comporta con i visitatori:

Modalità	Quando si attiva	Cosa vede l'utente
AI Chat	steps[] vuoto	Chat libera con LLM, risponde in base al system_prompt e ai documenti RAG
Guidato	steps[] popolato	Bottoni a imbuto, step-by-step con punteggio lead
Ibrido	steps[] popolato + system_prompt completo	Prima il flusso guidato a bottoni, poi fino a N domande AI/RAG, infine il form contatti

Regola chiave: Se steps[] è vuoto → il widget usa ChatWidget (AI libera). Se steps[] ha almeno 1 step → usa GuidedChatWidget (bottoni). Per l'ibrido: flusso guidato → domande RAG (limite configurabile con post_flow_rag_limit) → form contatti.

AI Chat — Quando usarla

Ideale per: assistenza clienti, FAQ, consulenza, supporto tecnico. L'utente scrive liberamente e l'AI risponde usando il system_prompt e i documenti PDF caricati (RAG).

Un system_prompt dettagliato — è il "cervello" del chatbot
Documenti PDF nella Knowledge Base (RAG)
Nessuno step — l'array steps deve restare vuoto

Nel system_prompt includi: chi sei, cosa fai, regole (lingua, tono), FAQ principali, cosa NON deve fare.

Guidata — Quando usarla

Ideale per: qualificazione lead, prenotazioni, vendita. Max 3 bottoni per step, max 15 step.

Lead caldo (70-100 pt) = chiamare subito · Tiepido (45-69) = proposte · Freddo (0-44) = nurturing

Ibrida — Il meglio di entrambi

Bottoni per qualificare, poi domande AI per approfondire (limite configurabile), infine il form contatti. Serve: steps popolati + system prompt completo.

Flusso: Step guidati → Domande RAG (default 3) → Form contatti → CTA finale

Configura post_flow_rag_limit nelle "Impostazioni Flusso" per controllare quante domande AI prima del form contatti. 0 = contatto immediato.

Privacy e Conformità GDPR

Il widget chatbot guidato include automaticamente:

Checkbox Privacy Policy — Prima dell'invio del form contatti, l'utente deve spuntare "Ho preso visione della Privacy Policy". Senza il check, il bottone "Invia" resta disabilitato.
Link Privacy Policy (dinamico) — Risolto in ordine: (1) privacy_policy_url del profilo se impostato, (2) LegalDocument del tenant, (3) nessun link.
Tracciamento consenso GDPR — Il consenso viene salvato nella sessione con versione e hash del documento, indirizzo IP, e timestamp per audit trail completo.
Disclaimer AI — In fondo alla chat appare "Guardrail attivo — Risposte verificate dal sistema di sicurezza AI".

Il consenso privacy e il disclaimer sono attivi automaticamente. Puoi personalizzare l'URL della privacy policy nel campo privacy_policy_url della sezione CTA, oppure lasciare vuoto per usare il documento legale del tenant.

Protezioni di Sicurezza Automatiche (SOL-373)

Il backend Kyntrox applica automaticamente le seguenti protezioni su ogni messaggio del chatbot. Non è necessaria alcuna configurazione — sono sempre attive:

Protezione	Cosa fa	Impatto sul template
Prompt Injection Guard	44 pattern regex (IT+EN) rilevano tentativi di manipolazione AI	Nessuno — protezione trasparente
reCAPTCHA Hard-Fail	Se la verifica reCAPTCHA fallisce, la richiesta viene rifiutata (HTTP 403)	Se Google API è down, il widget è temporaneamente bloccato
Sanitizzazione I/O	Unicode NFKC, rimozione zero-width chars, limite 2.000 char, bleach output	NO HTML nei system prompt, solo testo
Token Hard Cap (1.024)	Limite assoluto per ogni risposta AI	`rag_max_tokens` limitato a 1.024 effettivi
Validazione UUID	Il `tenant_id` deve essere un UUID valido	No stringhe come "default"

CTA Finale — Calendario Prenotazioni

Alla fine del flusso, puoi aggiungere un pulsante CTA. Due modalità:

Link esterno — Apre Google Calendar, Calendly o Kyntrox Calendar in una nuova tab
Widget embedded — Integra il calendario direttamente nel chatbot via iframe

Configura nella sezione "Azione Finale (CTA)" dell'editor.

Kyntrox Calendar: Se usi il calendario Kyntrox, inserisci il codice widget nel campo "Widget Calendario" per embedding diretto.

Checklist Pre-Lancio

Modalità chatbot scelta (AI / Guidato / Ibrido)
Nome assistente personalizzato
System prompt completo (per AI e Ibrido) — solo testo, NO HTML
Messaggi di benvenuto e completamento
Pulsanti e punteggi adatti (per Guidato e Ibrido)
Colori brand impostati
CTA finale configurato (testo + URL calendario/link)
Documenti PDF caricati nella Knowledge Base
Test completo su mobile e desktop
Limite RAG post-flusso configurato (per Ibrido)
Privacy URL impostato o LegalDocument tenant configurato
Tenant ID valido (UUID) nel codice embed widget
rag_max_tokens ≤ 1.024 (hard cap backend)

Modifica Pulsante