Come Creare un Agente di IA su WhatsApp in 10 Minuti

Come Creare un Agente di IA su WhatsApp in 10 Minuti (Passo a Passo)

Creare un agente di IA su WhatsApp era un progetto che richiedeva tre mesi: approvare l'API di Meta, codare l'integrazione, ospitare il server, testare. Con OpenClaw, la stessa consegna si esegue in 10 minuti dal registro alla prima conversazione reale. Questo post è il passo a passo onesto — con i 4 attriti che troverai e come superarli.

TL;DR: Registro → 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 niente di più):

1. Account WhatsApp Business (l'app gratuito di Meta — non confondere con gli altri).
2. Numero di telefono dedicato. Può essere fisso, virtuale o cellulare — ma non può essere in uso su WhatsApp personale.
3. 10 minuti senza interruzione. Il flusso si blocca se esci nel mezzo dell'autenticazione.

Non serve carta di credito nel piano gratuito. Non serve codice fiscale (anche se lo consigliamo). Non serve sapere cosa è un webhook.

---

Passo 1 — Creare l'account (1 min)

Accedi a openclaw.com.br, clicca su Creare account gratuito e compila:

• Indirizzo e-mail
• Password
• Nome del tuo business

Il sistema crea il tuo workspace in secondi. Ti porti nella dashboard con un tour di 3 passi.

Attrito comune: E-mail di conferma a volte finisce nella cartella "Promozioni" o "Spam" di Gmail. Se dopo 1 minuto non arriva, controlla queste cartelle.

---

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

Ecco dove OpenClaw si differenzia dalle altre piattaforme. Invece di creare un flusso con blocchi trascinabili, descrivi l'agente in testo e la piattaforma crea la logica.

Apri Agenti → + Nuovo agente. Vedrai tre campi:

Nome

Il nome che il cliente vede. Ad esempio: Sofia, Atendente OpenClaw, Assistente della Clinica Solare.

Obiettivo

Una frase breve di ciò che l'agente deve fare. Esempi che funzionano:

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

Personalità e restrizioni

Ecco dove dai il "manuale di marca" in testo continuo. Ad esempio, utilizziamo come baseline:

Nota: Non ho tradotto il codice o le URL come richiesto.

Tom: un cliente informale italiano, vicino ma professionale. Puoi usare gli emoji con parsimonia (1 per messaggio).

Sempre: presentati nel primo turno. Utilizza il primo nome del cliente quando lo sai. Conferma l'appuntamento due volte.

Mai: prometti sconti che non sono nel catalogo. Parla della concorrenza. Inventi l'orario o il prezzo. Rispondi a domande di salute, diritto o finanza — invia al umano.

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

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

---

Passo 3 — Collegare il WhatsApp Business (3 min)

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

3.1 Iniziare la connessione

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

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

3.2 Autenticarsi con la Meta

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

Attrito comune #1: La tua conta personale di Facebook deve essere amministratore del Business Manager. Se nessuno ti ha dato accesso, non puoi superare questa schermata.

3.3 Selezionare / creare account WhatsApp Business

All'interno dell'autenticazione della Meta, scegli quale WABA (WhatsApp Business Account) vuoi usare. Se non esiste ancora, la Meta crea al momento tramite l'interfaccia integrata.

3.4 Verificare il numero

La Meta invia codice SMS o chiamata al numero che vuoi collegare. Digita il codice nell'interfaccia dell'OpenClaw.

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

3.5 Configurare webhook

L'OpenClaw configura il webhook automaticamente. Non devi fare nulla. Quando la schermata mostra Numero collegato ✅, sei pronto.

---

Passo 4 — Collegare UNA integrazione (2 min)

Puoi saltare questo passo e iniziare a conversare — ma il 95% degli agenti che rimangono in aria utilizzano almeno 1 integrazione. Consigliamo di iniziare con quella che genera valore più velocemente nel tuo caso:

Nota: Non ho tradotto le URL, il codice o gli HTML tags come richiesto.

REGOLE CRITICHE:

• Preservare TUTTO il formattaggio markdown ESATTAMENTE (intestazioni ##, liste -, grassetto, corsivo, link, blocchi di codice, ecc.)
• NON tradurre URL, codice o tag HTML
• NON aggiungere premessa o commenti
• Output SOLO il markdown tradotto, nulla di più

Tabella di integrazione:

Il tuo business	Integrazione prima
Clinica, studio, atelier	Google Calendar
Infoprodotto, corso	Stripe o Mercato Pago
Servizio B2B (consultoria, agenzia)	HubSpot o RD Station
Negozio fisico / consegna	Tabelle Google

Esempio — Google Calendar:

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

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

---

Passo 5 — Prima conversazione reale (1 min)

Prendi il tuo altro cellulare (o chiedi a qualcuno), invia un messaggio al numero che hai collegato. Testa scenari che sai che avverranno:

• "ciao"
• "quanto costa?"
• "atende sabato?"
• "vorrei prenotare"
• "ho bisogno di parlare con un umano"

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

Adeguati a ciò che non è andato bene: se l'agente ha fatto un errore di riconoscimento o ha inventato qualcosa, torna nel campo di personalità e aggiungi la regola mancante. L'agente rilegge la descrizione a ogni nuova messaggistica — modifiche valgono per la prossima conversazione.

---

I 4 errori più comuni nei primi 10 minuti

1. Obiettivo troppo generico. L'agente con un obiettivo vago dà una risposta vaga. Riscrivi con il risultato concreto che si aspetta.
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. L'agente senza calendario nell'esempio della clinica diventa decorativo — il cliente esce dalla conversazione senza aver prenotato nulla.
4. Credere di essere pronto al primo test. I primi 20-30 turni reali rivelano schemi che non si sono previsti. Riserva una settimana per iterare prima di disattivare l'agente umano.

---

E dopo i 10 minuti?

L'agente in azione è solo l'inizio. Il lavoro reale per massimizzare il risultato è:

• Analizzare conversazioni reali e rifinire la personalità.
• Aggiungere skill personalizzate per operazioni specifiche del tuo business (consulta dello stock, verifica del pagamento, ecc).
• Configurare handoff intelligente per quando l'agente deve chiamare un umano.
• Seguire metriche di risoluzione vs scalabilità.

Cobrimo ogni singolo punto in post separati — ma prima è necessario capire cosa accade all'interno dell'agente a ogni turno di conversazione per calibrare le aspettative.