Come creare un WABA e collegare il tuo numero WhatsApp a DeepAgent

Cos'è un WABA

Il WABA è il "contenitore" ufficiale di Meta che gestisce il tuo numero di telefono per l'uso su WhatsApp Business Platform. È diverso dall'app WhatsApp Business normale che scarichi sul telefono: qui parliamo della piattaforma professionale (API), quella che permette a strumenti come DeepAgent di inviare e ricevere messaggi in automatico. Senza un WABA attivo e un numero verificato, DeepAgent non può collegare gli agenti a WhatsApp.

Cosa ti serve prima di iniziare

• Un account Meta personale, con accesso a un business portfolio (o la possibilità di crearne uno)

• Un numero di telefono che non sia già attivo su un'altra app WhatsApp personale o Business, altrimenti dovrai prima rimuoverlo da lì

• La possibilità di ricevere un codice via SMS o chiamata su quel numero

• Se vuoi anche il badge verde ufficiale in futuro, sappi che è un passaggio separato e non obbligatorio per iniziare

Link ufficiali da usare

• Meta Business Suite (dove crei il WABA): https://business.facebook.com/

• Meta for Developers – WhatsApp Business Platform (documentazione tecnica completa): https://developers.facebook.com/docs/whatsapp/

• Developer Hub WhatsApp Business (per iniziare a costruire e integrare): https://business.whatsapp.com/developers/developer-hub

• Guida ufficiale "come iniziare" di WhatsApp: https://faq.whatsapp.com/5773272372736965

• Verifica del numero di telefono: https://www.facebook.com/business/help/908314225274315/

• Aggiungere il WABA al business portfolio: https://www.facebook.com/business/help/713785646327651

• Richiesta badge Official Business Account (opzionale, non obbligatorio all'inizio): https://www.facebook.com/business/help/604726921052590

Passo 1 — Accedi a Meta Business Suite

1. Vai su https://business.facebook.com/

2. Fai login con il tuo account Meta personale

3. Se non hai ancora un business portfolio, Meta ti guiderà nella creazione durante il primo accesso

4. Una volta dentro, apri Impostazioni (in basso a sinistra)

Se non riesci a vedere alcune sezioni descritte nei prossimi passi, il motivo più comune è che il tuo utente non ha ancora i permessi di amministratore completo sul business portfolio.

Passo 2 — Crea il tuo WhatsApp Business Account (WABA)

1. Dentro Impostazioni, cerca la sezione Account e poi Account WhatsApp (in inglese "WhatsApp accounts")

2. Clicca su Aggiungi e scegli Crea un nuovo account WhatsApp Business

3. Compila i dati richiesti:

   • Nome dell'account WhatsApp Business

   • Categoria dell'attività

   • Sito web (se disponibile)

   • Fuso orario dell'azienda

4. Conferma e accetta i termini di servizio di Meta

A questo punto il tuo WABA esiste, ma è ancora "vuoto": non ha nessun numero collegato.

Passo 3 — Collega e verifica il numero di telefono

Questo è il passaggio più delicato, perché il numero deve essere libero da altri utilizzi WhatsApp.

1. Nella pagina del tuo WABA, clicca su Aggiungi numero di telefono

2. Inserisci il prefisso internazionale (es. +39 per l'Italia) e il numero completo

3. Scegli come ricevere il codice: SMS o Chiamata vocale

4. Inserisci il codice di verifica che ricevi

5. Al termine, ti verrà chiesto di impostare un PIN a due fattori per proteggere il numero: annotalo, perché ti servirà in futuro per operazioni di manutenzione

6. Conferma per completare la registrazione del numero

Attenzione: se il numero è già registrato su WhatsApp normale o Business (app sul telefono), devi prima eliminare quell'account WhatsApp dal telefono (Impostazioni → Account → Elimina account, non basta disinstallare l'app) e aspettare qualche minuto prima di registrarlo sul WABA.

Passo 4 — Controlla lo stato del WABA

Dopo la verifica:

• Il numero deve apparire come Connesso o Verificato nella sezione Account WhatsApp

• In alcuni casi Meta effettua controlli aggiuntivi di sicurezza che possono richiedere fino a 24 ore

• Se tutto è a posto, il WABA è pronto per essere collegato a strumenti esterni come DeepAgent

Se qualcosa non torna, il primo posto da controllare è sempre la sezione WhatsApp accounts di Meta Business Suite.

Passo 5 — Collega il WABA a DeepAgent

1. Apri DeepAgent e vai nel menu Integrazioni

2. Cerca la card WhatsApp tra le integrazioni disponibili

3. Clicca su Aggiungi collegamento

4. Si apre la finestra di autenticazione ufficiale Meta, chiamata Embedded Signup: è un pop-up sicuro fornito direttamente da Meta, non da DeepAgent

5. Accedi con il profilo Meta che hai usato per creare il business portfolio e il WABA nei passi precedenti

6. Meta ti mostrerà due opzioni: collegare un business esistente oppure crearne uno nuovo. Seleziona il tuo business esistente, quello dove hai già creato il WABA

7. Scegli il WABA che hai già creato (o, se preferisci, lascia che Meta ne crei uno nuovo automaticamente in questo stesso flusso)

8. Seleziona il numero di telefono già verificato, oppure completa la verifica del numero direttamente da questo flusso se non l'hai già fatto

9. Meta chiederà di autorizzare i permessi richiesti da DeepAgent (gestione messaggi, gestione template, accesso al numero)

10. Conferma i permessi: a questo punto Meta chiude il pop-up e restituisce a DeepAgent l'accesso al tuo WABA

11. In DeepAgent vedrai il collegamento comparire come Attivo nella sezione Integrazioni → WhatsApp

Nota importante sull'autenticazione

Durante il login, Meta usa lo stesso account con cui hai creato il business portfolio in Meta Business Suite: se hai più profili Meta, assicurati di autenticarti con quello giusto, altrimenti il flusso non troverà il tuo WABA tra le opzioni disponibili.

Domande frequenti

Posso usare un numero fisso invece di un cellulare? Sì, molti numeri fissi funzionano se possono ricevere la verifica via chiamata vocale invece di SMS.

Devo avere una pagina Facebook per creare il WABA? No, ma devi avere un business portfolio Meta attivo, che puoi creare gratuitamente durante il primo accesso a Business Suite.

Quanto tempo richiede la verifica? Di solito pochi minuti, ma in alcuni casi Meta può richiedere fino a 24 ore per completare i controlli di sicurezza.

Serve il badge verde ufficiale per iniziare? No, il badge (Official Business Account) è una richiesta separata e successiva, non necessaria per il primo collegamento.

Errori comuni

Non vedo il mio WABA nella lista durante il collegamento a DeepAgent Verifica di aver fatto login con lo stesso account Meta usato per crearlo, e controlla di avere i permessi di amministratore sul business portfolio.

Il pop-up si chiude senza completare Spesso è un blocco popup del browser; disattivalo per il dominio di DeepAgent e riprova.

I permessi non vengono richiesti Prova a ripetere il collegamento da zero cliccando di nuovo su Aggiungi collegamento, il flusso Embedded Signup si riavvia sempre da capo.

Non vedo la sezione WhatsApp in Meta Business Suite Probabilmente non hai i permessi admin corretti nel business portfolio.

Il numero è già usato altrove Se il numero è legato a un altro account WhatsApp, potresti doverlo rimuovere o usare un altro numero.

Riepilogo rapido con link

Checklist finale

• [ ] Hai un account Meta attivo

• [ ] Hai accesso admin al business portfolio

• [ ] Hai creato il WABA

• [ ] Hai collegato il numero

• [ ] Hai completato la verifica via SMS o chiamata

• [ ] Hai cliccato su Integrazioni → WhatsApp → Aggiungi collegamento in DeepAgent

• [ ] Hai completato l'autenticazione Meta e autorizzato i permessi