Come Creare un Agente di IA su WhatsApp in 10 Minuti

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

Creare un agente IA 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 si ottiene 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 superarli.

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 — non confonderla con quella personale).
2. Numero di telefono dedicato. Può essere fisso, virtuale o cellulare — ma non deve 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 per il piano gratuito. Non serve partita IVA (anche se la 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. Atterri sulla dashboard con un tour di 3 passi.

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

---

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

Qui OpenClaw si distingue dalla maggior parte delle piattaforme. Invece di costruire diagrammi 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 il cliente vede. 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 fissare una valutazione gratuita con un consulente.
• ✅ Rispondere a domande sui nostri corsi, applicare un codice sconto e inviare il link di pagamento.
• ❌ Vendere. (troppo generico)
• ❌ Essere amichevole, efficiente, professionale e vendere. (l'obiettivo diventa una lista di aggettivi — pessimo)

Personalità e restrizioni

Qui fornisci il "manuale del brand" in testo libero. Esempio che usiamo come base:

Tono: casual brasiliano, vicino ma professionale. Si possono usare emoji con parsimonia (1 per messaggio).

Sempre: presentarsi al primo turno. Usare il nome del cliente quando lo si conosce. Confermare 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 — inoltrare a un operatore umano.

Quando si blocca: chiedere gentilmente alla persona di attendere e chiamare un operatore umano tramite /chamar_humano.

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

---

Passo 3 — Collegare 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 utilizzerai un numero che non è ancora associato a 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 Facebook deve essere admin del Business Manager. Se nessuno ti ha dato l'accesso, non riesci a superare questa schermata.

3.3 Selezionare / creare WhatsApp Business Account

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

3.4 Verificare il numero

Meta invia un codice SMS o chiamata al numero che stai per collegare. Inserisci 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 quel numero sul cellulare PRIMA di avviare la connessione.

3.5 Configurare il webhook

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

---

Passo 4 — Collegare UNA integrazione (2 min)

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

Il tuo business	Prima integrazione
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'attività.
3. Scegli quale calendario l'agente può consultare / in cui creare eventi.
4. Definisci la fascia oraria (es: lun-ven 9h-18h, sab 9h-13h).
5. Salva.

Fatto. L'agente ora consulta gli orari disponibili 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?"
• "siete aperti il sabato?"
• "voglio prenotare"
• "ho bisogno di parlare con un operatore"

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

Correggi ciò che non ha funzionato bene: se l'agente ha sbagliato tono o ha inventato qualcosa, torna nel campo personalità e aggiungi la regola mancante. L'agente rilegge la descrizione a ogni nuovo messaggio — le modifiche valgono dalla conversazione successiva.

---

I 4 errori più comuni nei primi 10 minuti

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

---

E dopo i 10 minuti?

L'agente attivo è solo il punto di partenza. Il vero lavoro per massimizzare i risultati sta nel:

• Analizzare le conversazioni reali e affinare la personalità.
• Aggiungere skill personalizzate per operazioni specifiche del tuo business (consultazione magazzino, verifica pagamento, ecc.).
• Configurare l'handoff intelligente per quando l'agente deve chiamare un operatore umano.
• Monitorare le metriche di risoluzione vs escalation.

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