Documenti professionali pronti al download e template chatbot personalizzabili. Scegli la sezione, trova il template giusto e inizia subito.
Clicca su un template per caricarlo nell'editor. Potrai personalizzare ogni dettaglio prima di scaricarlo.
Descrivi il chatbot che desideri in linguaggio naturale e Gemini 2.0 Flash genererà un template completo, pronto da personalizzare e scaricare.
La chiave resta solo nel tuo browser (localStorage). Non viene mai inviata ai server Kyntrox.
Gemini sta generando il template...
Controlla l'anteprima JSON qui sotto, poi scarica il file da importare in Kyntrox.
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 |
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.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).
Ideale per: qualificazione lead, prenotazioni, vendita. Max 3 bottoni per step, max 15 step.
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
post_flow_rag_limit nelle "Impostazioni Flusso" per controllare quante domande AI prima del form contatti. 0 = contatto immediato.Il widget chatbot guidato include automaticamente:
privacy_policy_url del profilo se impostato, (2) LegalDocument del tenant, (3) nessun link.privacy_policy_url della sezione CTA, oppure lasciare vuoto per usare il documento legale del tenant.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" |
Alla fine del flusso, puoi aggiungere un pulsante CTA. Due modalità:
Configura nella sezione "Azione Finale (CTA)" dell'editor.
rag_max_tokens ≤ 1.024 (hard cap backend)