Guida completa

Come usare Whaiz

Tutto quello che ti serve per collegare il tuo WhatsApp, configurare il bot e sfruttare ogni funzionalità. Passo dopo passo, senza tecnicismi.

Lettura ~10 minuti · 13 sezioni

Introduzione

Cos'è Whaiz

Whaiz collega un'intelligenza artificiale al tuo numero WhatsApp personale. Non è il bot ufficiale di WhatsApp Business: usa il tuo account reale, quindi le conversazioni sono naturali e indistinguibili da quelle scritte da te. E non finisce qui: con l'API integri WhatsApp nel tuo gestionale (ERP), sito o script — in qualsiasi linguaggio — per automatizzare l'invio di qualunque messaggio.

Personalità su misura

Per ogni chat decidi chi è il bot, come scrive e cosa può dire.

Controllo totale

Il bot si ferma appena scrivi tu. Nessun messaggio parte senza il tuo via.

Paghi solo l'uso

Nessun abbonamento: ricarichi quando vuoi e consumi solo l'AI che usi.

Integri qualsiasi software

Con l'API REST colleghi WhatsApp al tuo gestionale, sito o script in qualsiasi linguaggio e automatizzi l'invio di qualunque messaggio.

Dashboard Whaiz — panoramica account con messaggi, bot attivi e costi
La dashboard: a colpo d'occhio lo stato WhatsApp, i bot attivi, i messaggi e i costi.
In sintesi: colleghi WhatsApp con un QR code, configuri il bot per ogni contatto o gruppo, e Whaiz inizia a rispondere al posto tuo seguendo le tue regole. Le prossime sezioni spiegano ogni passaggio.
Primi passi

Collega il tuo WhatsApp

Il collegamento funziona come WhatsApp Web: scansioni un QR code una sola volta e il tuo numero diventa operativo. Ci vuole meno di un minuto.

1

Apri la sezione WhatsApp

Nel menu laterale clicca WhatsApp, poi Aggiungi account. Puoi collegare più numeri, ognuno indipendente.
2

Genera il QR code

Premi Connetti: comparirà un QR code valido 60 secondi (si rigenera automaticamente se scade).
3

Scansiona dal telefono

Sul telefono apri WhatsApp → ImpostazioniDispositivi collegatiCollega un dispositivo, e inquadra il QR sullo schermo.
4

Attendi la sincronizzazione

Whaiz importa automaticamente contatti, gruppi e la cronologia recente delle chat. Puoi scegliere quanti giorni di storico importare.
Pagina WhatsApp connessa — sincronizzazione contatti e conversazioni
Account WhatsApp connesso: stato, sincronizzazione contatti e importazione conversazioni
Come per WhatsApp Web, il telefono deve restare acceso e connesso a internet: Whaiz è un dispositivo collegato, non sostituisce il telefono.
Il cuore di Whaiz

Configura il Bot AI

Per ogni contatto o gruppo crei una 'persona': chi è il bot, come scrive, cosa sa di voi e cosa non deve mai fare. È così che le risposte sembrano davvero scritte da te.

1

Apri Bot AI e scegli la chat

Dal menu vai su Bot AI, seleziona l'account, poi scegli un contatto o un gruppo dall'elenco.
2

Scegli il modello di AI

Veloce ed economico (€0,001/msg), Bilanciata e meno economica (€0,003/msg) o Più intelligente e costosa (€0,006/msg).
3

Compila la persona

Riempi i campi qui sotto. Più sei specifico, più le risposte saranno fedeli al tuo stile.
4

Attiva il bot

Salva e attiva l'interruttore. Da quel momento il bot risponde nella chat scelta seguendo le tue indicazioni.
Pagina Bot AI — elenco degli account WhatsApp da espandere per gruppi e contatti
La pagina Bot AI elenca i tuoi account WhatsApp: clicca su un account per espanderlo e gestire — separatamente — i suoi gruppi e contatti, ognuno con il proprio interruttore.
Configurazione dettagliata di un contatto — tipo di AI, identità, stile e tono
La configurazione di un contatto: scegli il tipo di AI e componi la persona — chi è il bot, come scrive, cosa sa e cosa non deve fare.
Modifica offline (template .md): con i pulsanti Esporta .md e Importa .md scarichi la persona come file di testo, la rifinisci con calma sul computer e la ricarichi. Comodo per preparare personaggi elaborati o riusarli su più chat.
Profili business pronti: per chi parte da zero ci sono 10 profili di settore (albergo, ristorante, dentista, officina, parrucchiere…) con persona, dati e protocollo di accoglienza già impostati. Li scegli per numero e poi li personalizzi a piacere.
Tono e relazione

Adatta la persona

Oltre al testo libero, alcuni interruttori rapidi guidano il bot sul registro giusto da usare con quella persona.

Relazione

Amico, famiglia, partner, collega, cliente, fornitore o sconosciuto: cambia il tono di base.

Dare del tu / lei

Forza il registro formale o informale, oppure lascia decidere all'AI.

Lunghezza risposta

Risposte brevi, medie o lunghe a seconda di come scrivi di solito.

Emoji

Nessuna, poche, oppure 'come la persona' per rispecchiare il suo stile.

Rispondi nella lingua del messaggio

Se attivo, il bot risponde sempre nella lingua di chi scrive.

Esempi del tuo stile

Una frase per riga: il bot impara da come parli tu davvero.

Gli esempi del tuo stile e l'impostazione emoji «come la persona» sono i due fattori che più rendono le risposte umane. Vale la pena curarli.
Comportamento

Quando (e se) rispondere

Whaiz non risponde a raffica come un robot. Queste impostazioni decidono i tempi, le pause e i limiti, per un comportamento naturale.

Orario di attività

Es. 8-18: il bot risponde solo in quella fascia. Vuoto = sempre attivo.

Pausa se rispondi tu (Human handover)

Appena scrivi tu nella chat, il bot tace per N secondi (default 60). Riprendi il controllo quando vuoi.

Attesa fine messaggi (Anti-burst)

Prima di rispondere aspetta qualche secondo: se la persona sta ancora scrivendo, attende che finisca e risponde una volta sola.

Max risposte di fila

Anti-spam: dopo N risposte senza una replica della persona, il bot si ferma.

Se non sa rispondere

Può improvvisare, dire che richiamerai, oppure restare in silenzio.

Avvisi automatici

Quando il bot non può rispondere (fuori orario, niente credito, limite raggiunto o contatto non autorizzato) invia un breve messaggio predefinito, una volta al giorno per chat, senza consumare AI.

Catch-all per numeri sconosciuti

Per i numeri business puoi far rispondere il bot anche a contatti senza configurazione dedicata, con un'introduzione GDPR e limiti giornalieri (30-50 al giorno).

Human handover in azione
Mi mandi l'indirizzo?
Certo! Te lo giro subito 👍
✋ Hai scritto tu — il bot si mette in pausa per 60s
Eccolo: Via Roma 12. A dopo!
Funzione esclusiva

Il bot nei gruppi

Nei gruppi Whaiz è chirurgico: risponde solo quando serve e ti dà un controllo per singolo partecipante che nessun altro strumento offre.

1

Risponde solo se citato

Nei gruppi il bot interviene esclusivamente quando viene menzionato con @. Niente intromissioni nelle conversazioni normali.
2

Controllo per-partecipante (Padrone)

Per ogni membro del gruppo decidi cosa può fare: un partecipante può avere accesso agli strumenti avanzati (la modalità «Padrone»), un altro no.
3

Parola d'innesco del proprietario

Imposti una parola segreta (es. *schiavo*): quando tu scrivi nel gruppo iniziando con quella parola, il bot esegue il tuo comando con tutti gli strumenti attivi.
Configurazione di un gruppo — tipo di AI, identità e stile del bot
La configurazione di un gruppo: tipo di AI e persona del bot, proprio come per un contatto. Più sotto puoi anche decidere, per ogni partecipante, se e come far rispondere il bot.

Menzione con @

Il bot non vede mai numeri tecnici: riconosce le persone per nome dalla rubrica.

Modalità Padrone

Solo i partecipanti fidati possono attivare ricerca web, PDF, immagini e analisi.

Superpoteri dentro WhatsApp

Strumenti avanzati

Quando un contatto o un partecipante è in modalità Padrone, il bot può fare molto più che chiacchierare: esegue strumenti reali e ti restituisce il risultato in chat.

Ricerca web

Informazioni aggiornate dal web in tempo reale.

Genera PDF

Crea e invia documenti PDF formattati.

Analisi chat

Riassume e analizza l'intera cronologia di una conversazione, persona per persona.

Immagini AI

Genera immagini da una descrizione, oppure modifica o ricrea una foto che gli invii.

Video AI

Crea brevi video da un testo o anima una foto statica.

Vocali e clone voce

Capisce i vocali che riceve e può rispondere a voce, anche clonando un timbro vocale.

Il bot legge anche le foto e i PDF che gli invii. Per usare uno strumento basta chiederglielo a parole: capisce l'intenzione e sceglie da solo cosa eseguire.
Automazioni

Task programmati

Pianifica messaggi che partono da soli a un orario o con una frequenza scelta. Utile per buongiorno ricorrenti, promemoria, auguri o report periodici.

Messaggio fisso

Testo predefinito, con variabili dinamiche che vengono sostituite all'invio.

{{data}}{{ora}}{{giorno}}{{mese}}{{anno}}

Generato da AI

Dai un'istruzione e l'AI compone un messaggio nuovo ogni volta, con tutto il contesto della chat.

Pagina Task programmati
La pagina Task: crea messaggi automatici fissi o generati dall'AI con frequenza personalizzabile.
1

Crea il task

Scegli nome, account WhatsApp e tipo (fisso o AI).
2

Seleziona i destinatari

Uno o più contatti o gruppi.
3

Imposta la frequenza

Una volta, ogni giorno, ogni settimana o un orario personalizzato.
Monitoraggio

Statistiche in tempo reale

La dashboard ti mostra messaggi, risposte del bot e costi, aggiornati ogni pochi secondi. Vedi a colpo d'occhio cosa sta facendo Whaiz.

Pagina Statistiche — card riepilogative
In cima alle statistiche: risposte AI, spesa totale, saldo e costo medio per risposta. Più sotto trovi i grafici timeline e il costo per chat.

Grafici timeline

Risposte AI e costi giorno per giorno.

Vista per chat

Quali conversazioni consumano di più.

Export CSV

Scarichi tutto per analisi esterne.

Pagamenti

Token e costi

Whaiz è pay-as-you-go: niente abbonamenti. Acquisti token, e ogni risposta del bot ne consuma una piccola parte in base al modello AI usato.

Pagina Token — saldo, pacchetti di ricarica e storico transazioni
La pagina Token: saldo attuale, pacchetti di ricarica e storico dettagliato delle transazioni.

Pacchetti flessibili

Basic €10, Pro €25 o Business €50. Ricarichi quando vuoi, senza abbonamenti.

Storico trasparente

Ogni risposta è tracciata con data, chat e costo esatto. Sai sempre dove vanno i tuoi token.

Il caching adattivo riutilizza automaticamente le parti ripetute delle conversazioni attive, riducendo i costi AI fino all'80% senza alcuna perdita di qualità.
Per sviluppatori

Whaiz API — invia da qualsiasi software

Oltre al bot AI, Whaiz offre un'API REST per inviare messaggi WhatsApp dal tuo gestionale, sito o script — in PHP, JavaScript, Python, cURL e altri linguaggi, con una sola chiamata.

1

Attiva l'abbonamento

Dal menu API scegli un piano: €15/mese per 1 numero, +€5/mese per ogni numero extra. Annuale con 1 mese gratis.
2

Crea una chiave API

Genera una chiave: la vedi una sola volta, copiala e tienila al sicuro.
3

Copia lo snippet del tuo linguaggio

Scegli numero, tipo di messaggio e linguaggio: il codice è già pronto con il tuo token. Pulsante Copia.
4

Invia dal tuo codice

Esegui la chiamata: il messaggio parte dal tuo numero WhatsApp. Trovi anche lo storico invii.
curl -X POST \
  "https://api.whaiz.info/v1/messages/text" \
  -H "Content-Type: application/json" \
  -d '{"token":"wha_live_...","to":"39333...","body":"Ciao!"}'

6 tipi di messaggio

Testo, immagine, documento, posizione, contatto e audio.

11 linguaggi pronti

cURL, HTML, PHP, JavaScript, Python, C#, Java, Go, C++, VB.NET e VBA (Office).

Anti-ban integrato

Ritardo configurabile tra i messaggi (minimo 5s) per proteggere il numero.

Storico invii

Ogni invio via API è tracciato con tipo, destinatario, stato e orario.

Non incollare la chiave API in pagine pubbliche (es. HTML lato browser): sarebbe visibile a chiunque apra il sorgente. Per i siti pubblici esegui la chiamata lato server (PHP, Node, Python).
Account

Profilo e sicurezza

Dalla sezione Profilo gestisci i tuoi dati, cambi password e attivi la verifica in due passaggi per proteggere l'accesso.

1

Dati personali

Aggiorni nome, nazione e data di nascita quando vuoi.
2

Cambia password

Imposti una nuova password inserendo quella attuale (non disponibile per gli account Google).
3

Verifica in due passaggi (2FA)

Abiliti il 2FA con un clic: da quel momento, a ogni accesso ricevi un codice via email da inserire dopo la password.
Pagina Profilo — dati personali, password e verifica in due passaggi
La pagina Profilo: dati personali, cambio password, verifica in due passaggi (2FA) e zona pericolosa.
Gli account creati con Google accedono sempre tramite Google e non hanno una password: per loro il cambio password non è disponibile.
Dubbi comuni

Domande frequenti

Posso usare il mio numero di sempre?

Sì. Whaiz si collega al tuo WhatsApp esistente come dispositivo aggiuntivo, esattamente come WhatsApp Web. Non serve un nuovo numero.

Devo tenere il telefono acceso?

Sì. Essendo un dispositivo collegato, il telefono deve restare acceso e connesso a internet perché il bot funzioni.

Cosa succede se rispondo io a una chat?

Il bot se ne accorge e si mette in pausa (Human handover) per il tempo che hai impostato. Riprendi il controllo in qualsiasi momento, senza spegnere nulla.

Il bot risponde a tutti automaticamente?

No. Risponde solo nelle chat dove hai attivato e configurato una persona. Nei gruppi interviene esclusivamente se citato con @.

Posso collegare più account WhatsApp?

Sì, puoi aggiungere più numeri dalla sezione WhatsApp, ognuno con le proprie persone e impostazioni indipendenti.

Posso preparare le configurazioni offline?

Sì. Da ogni contatto o gruppo puoi esportare la persona come file .md, modificarla con calma sul computer e reimportarla. Pratico per personaggi elaborati o da riusare su più chat.

Le mie conversazioni sono al sicuro?

Whaiz usa la cronologia delle chat solo per generare risposte pertinenti al posto tuo. L'accesso al pannello è protetto e puoi attivare la verifica in due passaggi (2FA) per il tuo account.

Quanto costa?

Si parte da €10 in modalità pay-as-you-go: paghi solo l'AI che consumi, senza abbonamenti mensili. Il caching adattivo riduce ulteriormente i costi.

Pronto a iniziare?

Collega il tuo WhatsApp e configura il primo bot in meno di 5 minuti.