Widget di richiamata
Il Widget di richiamata è un piccolo modulo incorporabile che permette ai visitatori del tuo sito web di lasciare il loro numero di telefono e ricevere una richiamata dal tuo agente IA — di solito entro pochi secondi. Invece di chiedere ai visitatori di comporre il numero, la conversazione arriva da loro.
Questo è il quinto tipo di widget, insieme ai widget Floating, Pill, Pill Floating e Inline — ma funziona in modo molto diverso. Gli altri widget avviano una conversazione vocale nel browser. Il Widget di richiamata mette in coda una vera chiamata telefonica effettuata dal tuo agente attraverso il tuo numero in uscita.
Quando usarlo
| Scenario | Perché il Widget di richiamata si adatta |
|---|---|
| Landing page per la generazione di lead | Il visitatore si impegna con un numero di telefono, l'agente lo qualifica nel minuto successivo |
| Pagine prodotto ad alta intenzione | "Parla con uno specialista" senza far comporre il numero al visitatore |
| Siti mobile-first | Un tocco sul pill, nessuna richiesta di autorizzazione, nessuna cuffia necessaria |
| Copertura fuori orario | Il visitatore lascia un numero fuori orario, l'agente chiama quando la coda si apre |
| Meno attrito rispetto ai moduli | I visitatori inviano un singolo campo e ottengono una risposta immediata |
Idoneità
Il Widget di richiamata richiede tre cose sul tuo account prima di poter essere abilitato:
| Requisito | Perché |
|---|---|
| Piano a pagamento (Starter o superiore) | I minuti in uscita consumati durante la richiamata sono addebitati al minuto |
| Numero di telefono in uscita verificato assegnato all'agente | L'agente ha bisogno di un numero reale da cui chiamare |
| Email verificata sul tuo workspace | Conferma la proprietà prima che le chiamate in uscita vengano sbloccate |
Se manca uno di questi, la sezione del widget di richiamata nella scheda Widgets dell'agente mostra un avviso che ti dice esattamente cosa correggere. Il widget resta disabilitato finché tutti e tre non sono presenti.
Il Widget di richiamata non è disponibile sul piano Free perché effettua chiamate telefoniche in uscita. Tutti gli altri tipi di widget (Floating, Pill, Inline) restano gratuiti.
Configurazione
1. Abilita la richiamata sull'agente
- Apri il tuo agente e vai alla scheda Widgets.
- Scorri fino alla sezione Callback widget.
- Attiva "Enable callback widget".
- Configura:
- Retry attempts — quante volte l'agente riprova se il visitatore non risponde (1–5, predefinito 3).
- Retry interval — minuti tra i tentativi (1–30, predefinito 5).
- Widget language — la lingua in cui il modulo, i messaggi di stato e il selettore del paese si rivolgono al tuo visitatore (14 lingue disponibili — vedi sotto).
- Theme — schema di colori per il pill fluttuante e la finestra di dialogo (usa la stessa palette di temi degli altri widget).
- Salva.
Un'anteprima live del widget appare accanto alle impostazioni così puoi vedere subito le tue modifiche — non è necessario fare il deploy per testare l'aspetto.
2. Copia lo snippet di embed
Nella stessa sezione, copia lo snippet HTML:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
Incollalo una volta nel tuo sito web, tipicamente subito prima di </body>. Il widget appare come un pill fluttuante nell'angolo della pagina.
Il tag @latest significa che il tuo sito adotta automaticamente le nuove versioni del widget quando vengono rilasciate. Blocca su una versione specifica (es. hanc-webrtc-widgets@1.4.0) se vuoi il pieno controllo sugli aggiornamenti.
Cosa vede il visitatore
Il widget accompagna i visitatori attraverso quattro stati:
| Stato | Cosa vede il visitatore |
|---|---|
| Form | Pill fluttuante nell'angolo. Clicca per aprire. Selettore del paese a sinistra, campo del telefono a destra, pulsante di invio. |
| Queued | "Sei in coda — circa N secondi prima che ti chiamiamo." Si aggiorna in tempo reale. |
| Dialing | "Ti stiamo chiamando ora." Resta finché la chiamata non si connette o fallisce. |
| Completed / Failed | Una breve conferma o un errore cortese con un suggerimento "ricarica la pagina per effettuare un'altra richiamata". |
Il modulo valida automaticamente il numero di telefono rispetto al formato nazionale del paese scelto e rifiuta di inviare a meno che il numero non sia plausibile.
Copertura per paese
Il selettore del paese copre l'Europa (UE + DACH + Regno Unito), il Nord America (Stati Uniti + Canada) e un insieme curato di paesi aggiuntivi ampiamente supportati. Ogni paese mostra la sua bandiera, il nome e un segnaposto di esempio nel formato nativo così il visitatore sa cosa digitare.
Se un paese usato dai tuoi visitatori non è elencato, contatta support@hanc.ai — la copertura viene ampliata regolarmente.
Attributi HTML
Il widget accetta questi attributi sul tag <hanc-ai-callback>:
| Attributo | Obbligatorio | Descrizione |
|---|---|---|
agent-id | Sì | L'identificativo univoco del tuo agente |
locale | No | Sovrascrivi la lingua dell'interfaccia del widget per questa pagina (es. locale="de"). Utile se il tuo sito è multilingua e la lingua della pagina non corrisponde a quella predefinita dell'agente. |
theme | No | Sovrascrivi il tema di colore per questa pagina |
position | No | Dove si ancora il pill fluttuante (bottom-right, bottom-left, top-right, top-left) |
Tutto ciò che ometti ricade su quanto hai configurato sull'agente nella dashboard.
Esempio: pagina tedesca su un sito multilingua
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
Il testo del pill, le etichette della finestra di dialogo, il selettore del paese e i messaggi di stato passano tutti al tedesco. L'agente stesso parla comunque nella lingua per cui è configurato — locale influisce solo su ciò che il visitatore legge sulla pagina.
Lingua del widget
L'interfaccia del widget include 14 lingue integrate:
| Codice | Lingua |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
L'agente sceglie la sua lingua da tre fonti, in ordine di priorità:
- L'attributo
locale="…"sull'embed (priorità più alta) - La Widget language impostata nella scheda Widgets dell'agente
- Inglese (predefinito)
La lingua del widget influisce solo sul testo a schermo che il visitatore legge — etichette, selettore del paese, messaggi di stato. La conversazione vocale effettiva avviene nella lingua per cui il tuo agente è configurato a parlare.
Comportamento dei tentativi
Se il visitatore non risponde al primo tentativo, l'agente attende l'intervallo configurato e richiama — fino al numero di tentativi configurato.
- Tentativi: 1–5 (predefinito 3)
- Intervallo: 1–30 minuti (predefinito 5)
Il widget mostra al visitatore lo stato di ciascun tentativo. Dopo che tutti i tentativi falliscono, il widget passa allo stato "non siamo riusciti a raggiungerti" con un messaggio cortese.
Tre tentativi a intervalli di cinque minuti funziona bene per la maggior parte delle pagine di generazione di lead — abbastanza veloce da avere il visitatore ancora in navigazione, abbastanza discreto da non sembrare insistente. Aumentalo se il tuo pubblico tende a ignorare i numeri sconosciuti.
Una richiamata per caricamento di pagina
Una volta che un visitatore invia il suo numero, il widget si blocca per il resto della durata di quella pagina:
- Chiudere la finestra di dialogo comprime il pill ma non reimposta il modulo.
- Riaprire mostra lo stato corrente (in coda / in chiamata / completato / fallito), non un modulo nuovo.
- Per effettuare una seconda richiamata, il visitatore deve ricaricare la pagina.
Questo evita invii duplicati accidentali mentre una chiamata è già in arrivo. Se il visitatore annulla esplicitamente la sua richiamata in coda dalla finestra di dialogo (il pulsante "Cancel" nella schermata in coda), il blocco viene rilasciato e può inviare di nuovo immediatamente.
Cosa succede se ricarica a metà richiamata?
Se un visitatore ricarica la pagina mentre l'agente sta ancora riprovando il suo numero, il widget rileva che esiste già una richiamata attiva per lo stesso numero e si riconnette silenziosamente ad essa — nessuna chiamata duplicata, nessuna seconda voce in coda. Il visitatore vede semplicemente il suo stato esistente riprendere da dove era rimasto.
Concorrenza e throughput
Un singolo agente può avere fino a 10 richiamate in corso contemporaneamente. Gli invii oltre quel limite attendono in coda e vengono chiamati man mano che la capacità si libera.
La coda si svuota continuamente — la maggior parte dei visitatori viene chiamata entro pochi secondi dall'invio se non sei vicino al limite di concorrenza.
Protezione da spam e abusi
Il Widget di richiamata effettua vere chiamate telefoniche, quindi ha misure di protezione integrate che impediscono al traffico indesiderato di far lievitare la tua fattura. Funzionano automaticamente — non c'è nulla da configurare.
| Misura di protezione | Cosa sperimenta il visitatore |
|---|---|
| Controllo "Non sono un robot" | Quando la protezione dagli abusi è abilitata sulla piattaforma, il visitatore completa un rapido Google reCAPTCHA prima che la richiamata venga messa in coda. I visitatori genuini lo superano in un secondo; i bot vengono fermati. |
| Validazione del numero | Il modulo rifiuta di inviare un numero che non è una corrispondenza plausibile per il paese scelto, così errori di battitura e numeri fasulli non vengono mai chiamati. |
| Numeri premium e fuori copertura | Le linee premium, alcune gamme VoIP e i numeri al di fuori della copertura supportata non vengono richiamati telefonicamente. Se il browser del visitatore lo supporta, il widget offre invece una chiamata vocale in-browser; altrimenti vede un cortese messaggio "non possiamo chiamare questo numero". Questo impedisce l'uso abusivo del widget per comporre costosi numeri premium. |
| Limite di invii ripetuti | Lo stesso numero può essere messo in coda solo un numero limitato di volte all'ora per un agente. I visitatori che superano il limite vedono un cortese messaggio "ti contatteremo a breve" invece della schermata in coda. |
Queste protezioni esistono perché un modulo di richiamata pubblico è un obiettivo ovvio per gli abusi — qualcuno potrebbe altrimenti puntarlo su numeri premium o martellarlo con bot per bruciare i tuoi minuti in uscita. Le misure di protezione funzionano silenziosamente in background; i visitatori normali non le notano mai.
Anteprima live nella dashboard
La scheda Widgets mostra un'anteprima live del widget di richiamata accanto alle impostazioni. Qualsiasi modifica tu apporti — tema, lingua, numeri di tentativi — aggiorna l'anteprima istantaneamente. Non devi fare il deploy del tuo sito per vedere come apparirà il widget.
L'anteprima usa un manifest fittizio con l'elenco completo dei paesi e l'idoneità demo, così il widget viene renderizzato anche sui piani in cui le richiamate in uscita non sono ancora disponibili.
Tracciamento incorporato
Il widget emette gli stessi eventi call-start e call-end degli altri widget. Mettiti in ascolto di essi in JavaScript se vuoi attivare i tuoi analytics:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// Visitor's callback was just connected — track as conversion
});
widget.addEventListener('call-end', () => {
// Callback finished — track duration, outcome, etc.
});
Disponibilità nei piani
| Piano | Widget di richiamata |
|---|---|
| Free | Non disponibile (richiede chiamate in uscita) |
| Starter / Pro / Business / Enterprise | Disponibile |
Tutti i piani a pagamento ottengono lo stesso set di funzionalità del widget. Il costo per chiamata segue la tua normale tariffa in uscita — vedi Fatturazione.
Correlati
- Widget per sito web — Tipi di widget Floating, Pill, Pill Floating e Inline per conversazioni in-browser
- Settings — Impostazioni delle chiamate a livello di agente, incluso Max Call Duration che limita anche le richiamate
- Numeri di telefono — Collega il numero in uscita da cui il tuo widget di richiamata comporrà
- FAQ — Domande comuni e casi limite