Vai al contenuto

Risoluzione dei problemi

Problemi comuni e come risolverli. Per ogni problema, inizia con la prima soluzione suggerita: è la causa più probabile.

Il widget non appare sul mio sito web

  1. Controlla la dashboard — Apri direttamente l'URL della tua dashboard. Se non si carica, il server potrebbe essere inattivo: contatta il tuo account manager.
  2. Verifica data-bot-id — L'ID del bot nel tuo codice di incorporamento deve corrispondere allo slug effettivo del tuo bot. Controlla in Dashboard → Embed.
  3. Verifica data-backend-url — Deve includere il protocollo (https://) e il dominio corretto.
  4. Controlla la console del browser — Apri DevTools (F12) → Console per individuare eventuali errori JavaScript.

Il widget appare ma il bot non risponde

  1. Controlla l'indicatore di salute dell'LLM — Se è rosso, OpenRouter è disconnesso. Vai su Settings → AI Engine e riconnettilo.
  2. Verifica che sia selezionato un modello — Un modello AI deve essere scelto nel menu a discesa.
  3. Controlla la knowledge base — Se è vuota, il bot potrebbe rispondere in modo generico o non rispondere affatto. Aggiungi contenuti in Knowledge Base.

La cronologia della chat non persiste tra i caricamenti della pagina

  1. LocalStorage deve essere abilitato — Il widget memorizza i dati della sessione nel localStorage del browser. La modalità privata/incognito potrebbe bloccarlo.
  2. L'ID del bot deve essere coerente — Se il data-bot-id differisce tra le pagine, il widget le tratterà come bot separati con cronologie separate.

Il dominio personalizzato non funziona

  1. Attendi la propagazione DNS — Le modifiche possono richiedere da 5 a 30 minuti.
  2. Verifica il record A — Controlla il pannello di controllo del tuo provider DNS per confermare che il record A punti all'IP del tuo server.
  3. Prova a rinnovare l'SSL — Vai su Settings → Custom Domain → Renew SSL.
  4. Utenti Cloudflare — Assicurati che la modalità SSL sia impostata su Full (Strict).
  5. Contatta il tuo account manager se il problema persiste dopo la propagazione del DNS.

Le impostazioni non vengono salvate

  1. Controlla l'indicatore di salute del DB — Dovrebbe essere verde nella parte superiore della pagina.
  2. Aggiorna la pagina — Le impostazioni sono memorizzate nella cache; un aggiornamento forza una rilettura.
  3. Contatta il tuo account manager se l'indicatore del DB è rosso.

La dashboard si carica ma non mostra dati

  1. Controlla gli indicatori di salute — Se DB o VEC sono rossi, un servizio backend potrebbe richiedere attenzione.
  2. Aggiorna la pagina — I dati potrebbero non essere stati caricati alla prima visita.
  3. Contatta il tuo account manager se gli indicatori rimangono rossi.

Il test di integrazione fallisce

  1. Verifica le credenziali — Chiavi API, password SMTP e URL dei webhook devono essere aggiornati.
  2. Controlla gli Activity Logs — Filtra per il modulo Integrations per messaggi di errore dettagliati.
  3. Testa il servizio esterno — Conferma che l'endpoint del webhook, il server SMTP o l'API siano accessibili.

Il bot risponde in modo generico (ignora la knowledge base)

  1. Controlla i Sync Jobs — File o URL potrebbero essere ancora in fase di elaborazione. Attendi lo stato Completed.
  2. Aggiorna la knowledge base — Vai su Knowledge Base e clicca su Refresh.
  3. Rivedi il system prompt — Istruzioni contrastanti in Settings → Model Behavior possono prevalere sul recupero della knowledge base.
  4. Aggiungi FAQ — Per domande critiche, aggiungi una FAQ con la risposta esatta. Le FAQ hanno la priorità.

I messaggi WhatsApp non arrivano

  1. Controlla lo stato del servizio WhatsApp — Vai su Settings → WhatsApp e verifica che il servizio sia Running.
  2. Controlla l'API health check — L'indicatore di stato dovrebbe essere verde.
  3. Verifica la sessione del codice QR — Se disconnesso, scansiona nuovamente il codice QR.
  4. Contatta il tuo account manager se il servizio non si avvia.

Le prestazioni sono lente

  1. Passa a un modello AI più veloce — Gemini Flash o Claude Haiku per una latenza inferiore. Vedi Modelli AI.
  2. Riduci i max tokens — Abbassa il limite di lunghezza della risposta in Settings → Model Behavior.
  3. Ottimizza la knowledge base — Rimuovi documenti obsoleti per velocizzare la ricerca.
  4. Aggiungi FAQ — Le domande comuni risolte dalle FAQ saltano interamente il modello AI.
  5. Contatta il tuo account manager se la lentezza persiste: il server potrebbe aver bisogno di un aggiornamento delle risorse.

Sei ancora bloccato?

  • Controlla gli Activity Logs nella dashboard per individuare messaggi di errore.
  • Contatta il tuo account manager fornendo una descrizione del problema ed eventuali messaggi di errore visualizzati.