Come Creare un Agente IA su WhatsApp in 10 Minuti

Come Creare un Agente AI su WhatsApp in 10 Minuti (Passo dopo Passo)

Creare un agente AI su WhatsApp era un progetto da tre mesi: approvare l'API di Meta, programmare l'integrazione, ospitare il server, testare. Con OpenClaw, lo stesso risultato funziona in 10 minuti dalla registrazione alla prima conversazione reale. Questo post è la guida passo dopo passo onesta — con i 4 ostacoli che incontrerai e come superare ognuno.

TL;DR: Registrazione → descrivere l'agente in testo → connettere WhatsApp Business → configurare 1 integrazione → prima conversazione. ~10 min. Nessuna riga di codice.

---

Cosa ti serve prima di iniziare

Tre cose (e nient'altro):

1. Account WhatsApp Business (l'app gratuita di Meta — da non confondere con quella personale).
2. Numero di telefono dedicato. Può essere fisso, virtuale o cellulare — ma non può essere in uso su WhatsApp personale.
3. 10 minuti senza interruzioni. Il flusso si blocca se esci durante l'autenticazione.

Non serve carta di credito nel piano gratuito. Non serve partita IVA (anche se lo consigliamo). Non serve sapere cos'è un webhook.

---

Passo 1 — Creare l'account (1 min)

Vai su openclaw.com.br, clicca su Crea account gratis e compila:

• E-mail
• Password
• Nome della tua attività

Il sistema crea il tuo workspace in pochi secondi. Arrivi alla dashboard con un tour di 3 passi.

Ostacolo comune: L'e-mail di conferma a volte finisce nello spam di Gmail. Se dopo 1 min non è arrivata, controlla la cartella "Promozioni" o "Spam".

---

Passo 2 — Descrivere l'agente in linguaggio naturale (3 min)

Qui OpenClaw si differenzia dalla maggior parte delle piattaforme. Invece di montare un diagramma di flusso trascinando blocchi, descrivi l'agente in testo e la piattaforma costruisce la logica.

Apri Agenti → + Nuovo agente. Vedrai tre campi:

Nome

Il nome che vede il cliente. Es: Sofia, Assistente OpenClaw, Assistente della Clinica Solar.

Obiettivo

Una frase breve su cosa deve fare l'agente. Esempi che funzionano:

• ✅ Qualificare nuovi lead e programmare valutazione gratuita con un consulente.
• ✅ Rispondere a domande sui nostri corsi, applicare coupon sconto e inviare link di pagamento.
• ❌ Vendere. (troppo generico)
• ❌ Essere amichevole, efficiente, professionale e vendere. (l'obiettivo diventa lista di aggettivi — male)

Personalità e restrizioni

Qui dai il "manuale del brand" in testo corrente. Esempio che usiamo come baseline:

Tom: casual brasiliano, vicino ma professionale. Può usare emoji con parsimonia (1 per messaggio).

Sempre: presentati al primo turno. Usa il nome del cliente quando lo conosci. Conferma l'appuntamento due volte.

Mai: promettere sconti che non sono nel catalogo. Parlare della concorrenza. Inventare orari o prezzi. Rispondere a domande di salute/legali/finanziarie — inoltra a un umano.

Quando si blocca: chiedi educatamente alla persona di attendere e chiama un umano tramite /chamar_humano.

Salvato. In 2 secondi hai un agente funzionale — ancora senza integrazioni.

---

Passo 3 — Connettere WhatsApp Business (3 min)

Questa è la parte che genera più attrito e dove la maggior parte delle piattaforme perde l'utente. OpenClaw accorcia il flusso ufficiale di Meta in una sequenza lineare.

3.1 Avviare la connessione

Nella dashboard, clicca su Integrazioni → WhatsApp → Connetti. Scegli:

• Numero nuovo: se userai un numero che non è ancora su nessun WhatsApp.
• Migrare da WhatsApp Business (app): se hai già l'app WhatsApp Business installata e vuoi trasferire il numero all'API. Attenzione: l'app smette di funzionare dopo la migrazione.

3.2 Autenticarsi con Meta

OpenClaw reindirizza al login di Meta (non Google, non Facebook personale — account Business Manager). Se non hai mai aperto Business Manager, Meta lo crea per te al momento.

Attrito comune #1: Il tuo account personale di Facebook deve essere admin del Business Manager. Se nessuno ti ha dato accesso, non puoi superare questa schermata.

3.3 Selezionare / creare WhatsApp Business Account

All'interno dell'autenticazione di Meta, scegli quale WABA (WhatsApp Business Account) userai. Se non esiste ancora, Meta lo crea al momento tramite l'interfaccia integrata.

3.4 Verificare il numero

Meta invia un codice SMS o chiamata al numero che stai per connettere. Digita il codice nell'interfaccia di OpenClaw.

Attrito comune #2: Se hai già usato questo numero su un WhatsApp (personale o business app), il codice non arriva. Soluzione: disinstallare WhatsApp da questo numero sul cellulare PRIMA di avviare la connessione.

3.5 Configurare webhook

OpenClaw configura il webhook automaticamente. Non devi fare nulla. Quando la schermata mostra Numero connesso ✅, è pronto.

---

Passo 4 — Collegare UNA integrazione (2 min)

Puoi saltare questo passo e iniziare subito a conversare — ma il 95% degli agenti che rimangono attivi usa almeno 1 integrazione. Consigliamo di iniziare da quella che genera valore più rapidamente nel tuo caso:

La tua attività	Integrazione prioritaria
Clinica, studio medico, studio	Google Calendar
Infoprodotto, corso	Stripe o Mercado Pago
Servizio B2B (consulenza, agenzia)	HubSpot o RD Station
Negozio fisico / delivery	Fogli Google

Esempio — Google Calendar:

1. Integrazioni → Google Calendar → Connetti.
2. Autorizza con l'account Google che ha il calendario dell'operazione.
3. Scegli quale calendario l'agente può consultare / creare evento.
4. Definisci finestra (es: lun-ven 9h-18h, sab 9h-13h).
5. Salva.

Fatto. L'agente ora consulta l'orario libero in tempo reale e crea eventi senza intervento umano.

---

Passo 5 — Prima conversazione reale (1 min)

Prendi il tuo altro cellulare (o chiedi a qualcuno), manda un messaggio al numero che hai connesso. Testa scenari che sai che accadranno:

• "ciao"
• "quanto costa?"
• "aperto sabato?"
• "voglio prenotare"
• "devo parlare con un umano"

Osserva le risposte. Torna nel pannello di OpenClaw → Conversazioni per vedere la trascrizione.

Aggiusta ciò che non è andato bene: se l'agente ha sbagliato tono o inventato qualcosa, torna nel campo personalità e aggiungi la regola mancante. L'agente rilegge la descrizione ad ogni nuovo messaggio — le modifiche valgono nella prossima conversazione.

---

I 4 errori più comuni nei primi 10 minuti

1. Obiettivo troppo generico. Agente con obiettivo vago dà risposta vaga. Riscrivi con il risultato concreto che ti aspetti.
2. Dimenticare le restrizioni negative. "Non inventare mai il prezzo" vale più di "sii professionale". Le regole negative guidano meglio.
3. Saltare l'integrazione e testare solo con testo. Agente senza calendario nell'esempio della clinica diventa decorativo — il cliente esce dalla conversazione senza aver prenotato nulla.
4. Pensare che sia pronto al primo test. I primi 20-30 turni reali rivelano pattern che non avevi previsto. Riserva 1 settimana per iterare prima di spegnere l'operatore umano.

---

E dopo i 10 minuti?

L'agente online è solo il punto di partenza. Il lavoro reale per massimizzare il risultato sta in:

• Analizzare conversazioni reali e raffinare la personalità.
• Aggiungere skills personalizzate per operazioni specifiche della tua attività (consultazione magazzino, verifica pagamento, ecc).
• Configurare handoff intelligente per quando l'agente deve chiamare un umano.
• Monitorare metriche di risoluzione vs escalation.

Copriamo ciascuno di questi in post separati — ma prima vale la pena capire cosa succede all'interno dell'agente ad ogni turno di conversazione per calibrare le aspettative.