Passa al contenuto principale
DocumentationAPI ReferenceVideo Tutorials

Domande frequenti

Trova risposte alle domande più comuni sulla piattaforma Hanc.AI.

Domande generali​

Cos'è Hanc.AI?​

Hanc.AI è una piattaforma per creare agenti vocali IA in grado di gestire automaticamente le chiamate telefoniche. Il tuo agente vocale IA può rispondere alle domande dei clienti, prenotare appuntamenti, trasferire chiamate e molto altro -- 24/7, senza intervento umano.

Ho bisogno di competenze tecniche per usare Hanc.AI?​

No. La piattaforma è progettata per utenti business senza esperienza di programmazione. Configuri gli agenti tramite un'interfaccia visiva, scrivi istruzioni in linguaggio naturale e carichi documenti per creare una knowledge base.

Quali lingue supporta Hanc.AI?​

L'interfaccia della piattaforma è disponibile in:

  • Inglese (EN)
  • Tedesco (DE)
  • Spagnolo (ES)
  • Francese (FR)
  • Italiano (IT)
  • Ungherese (HU)

Gli agenti vocali IA supportano più di 25 lingue. Puoi impostare la lingua per ogni agente in modo indipendente. L'agente può anche cambiare automaticamente lingua durante una chiamata per adattarsi al chiamante.

Come fa l'IA a capire i chiamanti?​

Tu parli, l'IA comprende le tue parole, elabora il significato e risponde naturalmente con la voce. La piattaforma gestisce tutta la complessità dietro le quinte affinché le conversazioni risultino naturali e fluide.

Account e fatturazione​

Come creo un account?​

  1. Visita il sito web Hanc.AI
  2. Clicca su "Registrati" o "Inizia"
  3. Inserisci la tua email e crea una password
  4. Verifica il tuo numero di telefono via SMS
  5. Completa il tuo profilo

Quali piani sono disponibili?​

Hanc.AI offre cinque livelli di piano:

  • Free -- Assegnazione di credito una tantum, limite di 1 agente. Ideale per i test.
  • Starter -- Crediti mensili, agenti illimitati. Per piccole aziende.
  • Pro -- Più crediti, tariffe al minuto più basse. Per aziende in crescita.
  • Business -- Alta allocazione di crediti, supporto prioritario, SLA 99,9%. Per aziende consolidate.
  • Enterprise -- Prezzi personalizzati, manager dedicato, white-label, SSO/SAML. Per grandi organizzazioni.

La fatturazione annuale è disponibile con uno sconto rispetto a quella mensile. Visita Impostazioni > Fatturazione per i prezzi attuali.

Come funziona la fatturazione basata sui crediti?​

Ogni piano include crediti mensili (package_credits). Tutto l'utilizzo viene dedotto dal saldo crediti su queste categorie:

  • Crediti chiamate telefoniche -- Tariffe al minuto per chiamate telefoniche
  • Crediti chiamate web -- Tariffe al minuto per chiamate widget (in genere tariffa inferiore)
  • Crediti messaggi di testo -- Per ogni SMS inviato come azione post-chiamata
  • Crediti inoltro chiamate -- Per ogni chiamata inoltrata a un umano
  • Crediti numero di telefono -- Costo mensile per ogni numero di telefono attivo

La piattaforma supporta le valute USD ed EUR. I crediti inutilizzati si trasferiscono al periodo di fatturazione successivo.

Posso cambiare il mio piano?​

Sì. Gli upgrade hanno effetto immediato (proporzionato). I downgrade hanno effetto al successivo ciclo di fatturazione. Vai su Impostazioni > Fatturazione per cambiare il tuo piano.

Quali metodi di pagamento sono accettati?​

  • Carte di credito/debito (Visa, Mastercard, American Express) -- tramite Stripe
  • Bonifico bancario (solo Enterprise)

I crediti non utilizzati si trasferiscono?​

Sì. I crediti non utilizzati si trasferiscono al periodo di fatturazione successivo. Non scadono mai mentre il tuo account è attivo.

Agenti vocali IA​

Cos'è un agente vocale IA?​

Un agente vocale IA è un assistente virtuale alimentato dall'IA che gestisce conversazioni telefoniche. Risponde alle chiamate, comprende le esigenze dei chiamanti, fornisce informazioni dalla tua knowledge base e può eseguire azioni come prenotare appuntamenti o trasferire chiamate.

Quanti agenti posso creare?​

  • Piano Free: 1 agente
  • Piani a pagamento (Starter, Pro, Business, Enterprise): Agenti illimitati

Un agente può gestire più numeri di telefono?​

Sì. Puoi assegnare più numeri di telefono a un singolo agente se devono tutti comportarsi nello stesso modo.

Posso avere agenti diversi per scopi diversi?​

Sì. Molte aziende usano agenti separati per:

  • Richieste commerciali
  • Assistenza clienti
  • Prenotazione appuntamenti
  • Reception fuori orario

Posso duplicare un agente?​

Sì. Usa la funzione di duplicazione per clonare un agente esistente con tutte le sue impostazioni, prompt e configurazione. È utile per creare variazioni o testare modifiche.

Come posso testare il mio agente prima di andare in produzione?​

  1. Usa il pulsante "Parla con l'agente" nella dashboard
  2. Consenti l'accesso al microfono nel tuo browser
  3. Parla naturalmente e testa vari scenari
  4. Rivedi la trascrizione dopo ogni chiamata di test

I chiamanti possono capire che stanno parlando con un'IA?​

Gli agenti vocali IA moderni suonano molto naturali, ma raccomandiamo di essere trasparenti con i chiamanti. Molte aziende includono una breve menzione nel saluto: "Salve, ha raggiunto il nostro assistente virtuale..."

Quali impostazioni di chiamata posso configurare?​

Ogni agente ha impostazioni di chiamata configurabili:

  • Trigger promemoria -- Tempo prima che l'agente invii un promemoria quando il chiamante è in silenzio (predefinito: 30 secondi)
  • Max promemoria -- Numero massimo di promemoria prima che l'agente termini la chiamata (predefinito: 3)
  • Termina chiamata dopo silenzio -- Termina automaticamente la chiamata dopo un silenzio prolungato (predefinito: 10 secondi, deve essere abilitato esplicitamente)
  • Analisi del sentiment -- Analizza il sentiment del chiamante durante la chiamata (off per impostazione predefinita)
  • Riepilogo chiamata -- Genera un riepilogo dopo la chiamata (off per impostazione predefinita)
  • Registrazione -- Registra la chiamata (off per impostazione predefinita, verifica le leggi locali sul consenso)
  • Lingua -- Imposta la lingua principale dell'agente
  • Opt-out conservazione dati sensibili -- Opzione di privacy per dati sensibili

Cosa sono i campi di recupero dati?​

I campi di recupero dati permettono al tuo agente di estrarre informazioni strutturate dalle conversazioni. Tipi supportati:

  • Testo -- Testo in formato libero (es. nome del chiamante, email)
  • Numero -- Valori numerici (es. budget, quantità)
  • Booleano -- Valori sì/no (es. "interessato a demo?")
  • Selettore -- Scelta da opzioni predefinite (es. prodotto preferito)

I dati estratti sono disponibili nei registri chiamate e possono essere inviati a sistemi esterni tramite azioni post-chiamata.

Knowledge Base​

Cos'è una knowledge base?​

Una knowledge base è una raccolta di informazioni che il tuo agente usa per rispondere alle domande. Contiene i dettagli della tua attività, FAQ, informazioni sui prodotti, politiche e qualsiasi altra cosa di cui i chiamanti potrebbero chiedere.

Quali formati di file posso caricare?​

Formati supportati:

  • PDF (.pdf)
  • Documenti Word (.docx, .doc)
  • File Excel (.xlsx, .xls)
  • File di testo (.txt)
  • Markdown (.md)
  • HTML (.html)
  • CSV (.csv)
  • RTF (.rtf)
  • JSON (.json)

Quanto può essere grande la mia knowledge base?​

  • File individuali: fino a 10 MB ciascuno
  • Fino a 10 file per knowledge base

Quanto spesso devo aggiornare la mia knowledge base?​

Aggiorna la tua knowledge base ogni volta che:

  • I prezzi cambiano
  • Gli orari di lavoro cambiano
  • Vengono aggiunti nuovi prodotti/servizi
  • Le politiche vengono aggiornate
  • Noti che l'agente fornisce informazioni obsolete

Posso importare knowledge base in blocco?​

Sì. Usa la funzionalità di importazione ZIP per caricare più file di knowledge base contemporaneamente. Vedi Importa Knowledge Base per i dettagli.

Perché il mio agente non sta usando la knowledge base?​

Verifica questi problemi comuni:

  1. Knowledge base non connessa all'agente (Impostazioni agente > Knowledge Base)
  2. Informazioni non strutturate chiaramente
  3. Il contenuto non corrisponde a come i clienti pongono le domande
  4. Il caricamento del file è fallito o è ancora in elaborazione

Numeri di telefono e chiamate​

Ho bisogno di un mio numero di telefono?​

Hai tre opzioni:

  1. Acquista un numero -- Acquista direttamente tramite la piattaforma
  2. Importa un numero esistente -- Collega numeri di telefono che già possiedi
  3. Collega SIP -- Usa il tuo provider SIP trunk esistente

Posso usare SIP trunk?​

Sì. L'integrazione SIP trunk è disponibile su tutti i piani incluso Free. Collega il tuo PBX o sistema di telefonia esistente tramite SIP.

Le chiamate vengono registrate?​

La registrazione è opzionale e configurabile per agente (impostazione recording_enabled, off per impostazione predefinita). Se abilitata:

  • Le registrazioni sono memorizzate in modo sicuro
  • Puoi accedervi nei Registri chiamate
  • Verifica le leggi locali sul consenso alla registrazione delle chiamate

Cosa succede se l'agente non può aiutare?​

Puoi configurare regole di escalation:

  • Trasferire a un operatore umano (tool Inoltro chiamata)
  • Prendere un messaggio per richiamata
  • Fornire informazioni di contatto alternative
  • Pianificare un appuntamento

Widget per il sito web​

Quali tipi di widget sono disponibili?​

Sono disponibili quattro tipi di widget:

  • Widget chiamata fluttuante (hanc-ai-floating-call) -- Un pulsante fluttuante sulla pagina
  • Widget chiamata pill (hanc-ai-pill-call) -- Un pulsante compatto a forma di pillola
  • Widget chiamata inline (hanc-ai-inline-call) -- Incorporato direttamente nel layout della tua pagina
  • Widget di callback (hanc-ai-callback) -- Un modulo che raccoglie il numero di telefono del visitatore; il tuo agente lo richiama. Diverso dagli altri — effettua una vera chiamata telefonica in uscita invece di avviare una chiamata vocale dal browser. Vedi la sezione Widget di callback qui sotto.

Quali temi colore sono disponibili?​

Il widget supporta 12 temi colore configurabili dalla dashboard:

Default, Viola, Blu, Ciano, Smeraldo, Ambra, Mandarino, Rosa, Brace, Nero, Bianco e Mandarino Neon.

Imposta il tema tramite l'attributo theme sull'elemento widget o tramite le impostazioni widget dell'agente nella dashboard.

Quali eventi emette il widget?​

Il widget emette eventi che puoi ascoltare per l'integrazione:

  • status-changed -- Si attiva quando lo stato di connessione interno LiveKit cambia. Stati: idle, connecting, connected, agent-connected, disconnecting, disconnected, error
  • call-start -- Si attiva quando inizia una chiamata
  • call-end -- Si attiva quando termina una chiamata
  • state-change -- Si attiva quando lo stato del widget cambia. Stati: idle, connecting, active, ending, error
  • error -- Si attiva in caso di errori
  • audio-track -- Si attiva quando viene ricevuto un audio track remoto
  • local-audio-track -- Si attiva quando viene creato l'audio track locale

Quali sono i requisiti tecnici per il widget?​

Il widget richiede:

  • WebGL 2.0 (per l'animazione orb)
  • Web Audio API
  • WebRTC (per la comunicazione vocale in tempo reale)

Widget di callback​

Perché ho bisogno di un piano a pagamento per il Widget di callback?​

Il Widget di callback effettua vere chiamate telefoniche in uscita — ogni callback consuma minuti in uscita del tuo piano. Il piano Free non include le chiamate in uscita, quindi non può eseguire callback. Tutti gli altri tipi di widget (Fluttuante, Pill, Inline) funzionano nel browser e rimangono gratuiti.

Quali paesi supporta il selettore di paese?​

Il selettore copre l'Europa (UE + DACH + Regno Unito), il Nord America (USA + Canada) e un insieme curato di altri paesi ampiamente supportati. Ogni paese mostra una bandiera, un nome e un placeholder di esempio in formato nativo nell'input del telefono. Se un paese di cui hai bisogno non è elencato, invia un'email a support@hanc.ai — la copertura viene ampliata in base alla domanda.

Cosa succede se un visitatore invia, ricarica la pagina e invia di nuovo lo stesso numero?​

Il widget rileva che esiste già un callback attivo per quel numero per questo agente e si ricollega silenziosamente ad esso. Nessuna chiamata duplicata. Il visitatore vede il suo stato esistente riprendere da dove l'ha lasciato.

Perché il widget dice "Ricarica la pagina per effettuare un altro callback"?​

Il widget si blocca dopo un invio riuscito. Questo previene invii duplicati accidentali mentre una chiamata è in arrivo. Se il visitatore vuole effettuare un secondo callback (numero diverso, secondo tentativo dopo una chiamata persa, ecc.), ricarica la pagina e il modulo è di nuovo nuovo. Il pulsante "Annulla" esplicito sulla schermata in coda rilascia il blocco senza un ricaricamento.

Perché il mio callback mostra "Coda piena"?​

Un singolo agente gestisce fino a 10 callback contemporaneamente. Se la coda è al limite, i nuovi invii attendono fino a quando si libera un posto — il widget mostra un messaggio amichevole "ti contatteremo a breve". Il throughput si riprende man mano che le chiamate in corso terminano.

Come posso cambiare la lingua dell'interfaccia del widget?​

Due modi:

  • Predefinito per agente — Apri la scheda Widget dell'agente → sezione Widget di callback → Lingua del widget. Scegli tra 14 lingue supportate.
  • Override per pagina — Aggiungi locale="de" (o qualsiasi codice supportato) sul tag <hanc-ai-callback>. L'override vince sul predefinito dell'agente.

La lingua del widget influisce solo su ciò che il visitatore legge sulla pagina — la conversazione vocale effettiva avviene nella lingua in cui l'agente è configurato per parlare.

Posso far richiamare l'agente in una lingua diversa dall'interfaccia del widget?​

Sì. La lingua dell'interfaccia del widget e la lingua del parlato dell'agente sono indipendenti. Un widget in lingua francese su una landing page multilingue può essere abbinato a un agente di lingua inglese, o viceversa.

Cosa fa l'impostazione Durata massima chiamata ai callback?​

Se imposti una Durata massima chiamata sull'agente che è inferiore al limite di sicurezza del callback (10 minuti), la tua impostazione più breve vince. Se ne imposti una più lunga di 10 minuti, si applica comunque il limite di 10 minuti del callback. La maggior parte degli scenari di callback beneficia di un limite di 3-5 minuti per mantenere prevedibili i costi.

Azioni e strumenti​

Quali strumenti possono usare gli agenti durante le chiamate?​

StrumentoScopoPiani
Inoltro chiamataTrasferimento a un umanoTutti i piani
Google Calendar / OutlookVerifica disponibilità e prenotazione appuntamentiTutti i piani
API Tool RAGRecupera dati live dalle APITutti i piani
HubSpot CRMLeggi/scrivi contatti e deal HubSpot dalla chiamataTutti i piani
Trasferimento agentePassa la chiamata a un altro agente vocale IA del tuo accountTutti i piani
Server MCPEsponi strumenti dai tuoi server MCP registrati — vedi Server MCPTutti i piani

Quali azioni possono eseguire gli agenti dopo le chiamate?​

AzioneScopo
Invio emailNotifica email con dati della chiamata
Invio SMSMessaggio di testo con dati della chiamata
Invio WhatsAppMessaggio WhatsApp con dati della chiamata
Chiamata APIInvia dati a sistemi esterni (CRM, webhook)

L'agente può prenotare appuntamenti?​

Sì. Connetti il tuo Google Calendar e abilita lo strumento Google Calendar. L'agente verificherà la tua disponibilità e prenoterà appuntamenti direttamente durante la chiamata. Disponibile su tutti i piani.

Le impostazioni Google Calendar includono:

  • Durate slot: 15, 30, 45, 60, 75, 90, 105 o 120 minuti
  • Orari di lavoro: Orari di inizio e fine configurabili (predefinito 09:00-18:00)
  • Giorni lavorativi: Configurabili (predefinito lunedì-venerdì)
  • Fuso orario: Configurabile per calendario

L'agente può inviare messaggi WhatsApp?​

Sì. Aggiungi un'azione "Invio WhatsApp" al tuo agente. Configura il template del messaggio, i numeri dei destinatari e le condizioni di trigger. I messaggi WhatsApp possono includere variabili di recupero estratte dalla conversazione.

Prompt e configurazione​

Cos'è un prompt?​

Un prompt è l'insieme di istruzioni che dicono al tuo agente come comportarsi. Definisce la personalità, quali informazioni fornire, come gestire le situazioni e quali azioni intraprendere.

Quanto dovrebbe essere lungo il mio prompt?​

  • Minimo: 10 caratteri (minimo di sistema)
  • Massimo: 15.000 caratteri (massimo di sistema)
  • Consigliato: 500-1.000 parole per un comportamento completo

La qualità conta più della lunghezza. Sii specifico e chiaro.

Cos'è la "temperatura" nelle impostazioni dell'agente?​

La temperatura controlla quanto creative o prevedibili sono le risposte dell'agente:

  • Bassa (0,1-0,3): Risposte più consistenti e deterministiche
  • Media (0,4-0,6): Bilanciata (consigliata per la maggior parte degli usi)
  • Alta (0,7-1,0): Risposte più variate e creative

Per uso business, le temperature più basse sono di solito migliori.

Posso cambiare la voce dell'agente?​

Sì. Puoi selezionare da varie voci:

  • Maschili o femminili
  • Età e stili diversi
  • Vari accenti
  • Velocità di parlato diverse

Abbina la voce alla personalità del tuo brand.

Integrazioni​

Quali integrazioni sono disponibili?​

IntegrazioneStatoPiani
Numeri di telefonoDisponibileTutti
SIP TrunkDisponibileTutti
Google CalendarDisponibileTutti
Chiavi APIDisponibileTutti

Quante chiavi API posso creare?​

Puoi creare fino a 3 chiavi API per utente.

Risoluzione dei problemi​

Il mio agente non risponde alle chiamate​

Verifica questi passaggi:

  1. L'agente è impostato sullo stato "Attivo"
  2. Il numero di telefono è assegnato all'agente
  3. La connessione telefonica (o SIP trunk) è attiva
  4. Il primo messaggio è configurato
  5. Il tuo saldo crediti ha fondi

L'agente fornisce informazioni errate​

Soluzioni:

  1. Verifica che la knowledge base contenga informazioni corrette
  2. Verifica che la KB sia connessa all'agente
  3. Aggiungi istruzioni esplicite nel prompt per usare solo la KB
  4. Abbassa l'impostazione della temperatura (0,3-0,5)

La qualità delle chiamate è scarsa​

Prova queste correzioni:

  1. Controlla la tua connessione internet (5+ Mbps consigliati)
  2. Controlla la pagina di stato della piattaforma
  3. Prova un'opzione vocale diversa
  4. Per i test nel browser, usa una connessione cablata

Non riesco ad accedere al mio account​

Passaggi per risolvere:

  1. Verifica l'indirizzo email corretto
  2. Prova "Password dimenticata" per resettare
  3. Cancella cache e cookie del browser
  4. Prova la modalità incognito/privata
  5. Contatta il supporto se i problemi persistono

Sicurezza e privacy​

I miei dati sono al sicuro?​

Sì. La piattaforma utilizza:

  • Crittografia AES-256 a riposo
  • Crittografia TLS 1.3 in transito
  • Infrastruttura cloud sicura (data center UE)
  • Audit di sicurezza regolari
  • Autenticazione Firebase con verifica telefonica

Chi può accedere alle mie registrazioni delle chiamate?​

Solo gli utenti con i permessi appropriati nella tua organizzazione possono accedere alle registrazioni. Controlli l'accesso tramite le impostazioni di gestione del team e i permessi basati sui ruoli (Proprietario, Admin, Membro).

La piattaforma è conforme al GDPR?​

Sì. La piattaforma è conforme ai requisiti GDPR:

  • Accordi di trattamento dati disponibili
  • Diritto di cancellazione supportato
  • Esportazione dati disponibile
  • Controlli di privacy per le registrazioni
  • Opzione opt-out per la conservazione di dati sensibili

Posso eliminare i miei dati?​

Sì. Puoi:

  • Eliminare singole registrazioni di chiamate
  • Cancellare il contenuto della knowledge base
  • Eliminare agenti
  • Richiedere l'eliminazione completa dell'account

Ricevere aiuto​

Come contatto il supporto?​

  • Email: support@hanc.ai
  • Risposta standard: Entro 24 ore
  • Risposta Pro/Business: Entro 4 ore

Dove posso trovare tutorial?​

  • Questa documentazione
  • Guide di setup e template -- guide scaricabili
  • Video tutorial (quando disponibili)
  • Tooltip e guide in-app

Posso richiedere nuove funzionalità?​

Sì! Invia richieste di funzionalità a support@hanc.ai. Consideriamo attivamente il feedback degli utenti per lo sviluppo del prodotto.

Esiste una community o un forum?​

Controlla il sito web di Hanc.AI per risorse e aggiornamenti della community.

Riferimento rapido​

Impostazioni consigliate per casi d'uso comuni​

Caso d'usoTemperaturaLunghezza rispostaStile vocale
Assistenza clienti0,3-0,4BreveCalmo, disponibile
Vendite0,5-0,6MediaEnergico, cordiale
Appuntamenti0,3-0,4BreveProfessionale
Reception0,3-0,5Molto breveAccogliente

Checklist: Prima di andare in produzione​

  • Il prompt dell'agente è completo e testato
  • La knowledge base è caricata e connessa
  • Il primo messaggio suona naturale
  • Le regole di escalation sono configurate
  • Il numero di telefono è assegnato
  • Le chiamate di test sono state completate con successo
  • I membri del team hanno l'accesso appropriato

Argomenti correlati​