> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mattone.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Collegare WABA: numero WhatsApp Business e Conduit

> Come attivare un numero WhatsApp Business Account per Conduit: prerequisiti, processo di provisioning via Meta Business Manager e verifica finale.

Collegare il WABA richiede un numero di telefono non ancora registrato su WhatsApp e l'accesso a Meta Business Manager, il processo dura circa 1 settimana. **Chi fa cosa:** è lo **studente** che **richiede il numero dal portale Conduit** (specificando il **prefisso della sua città**); il **team Mattone** lo **supporta per la parte WABA/Meta** (registrazione con Meta e collegamento al Business Manager) tramite Conduit support. Lo studente partecipa anche nella fase di verifica aziendale su Meta.

## Prerequisiti

Prima di aprire la richiesta di provisioning, verifica che lo studente abbia tutto il necessario:

* **Numero di telefono** non registrato su WhatsApp normale (account privato o Business), oppure da portare via processo di migrazione (più lungo)
* **Accesso a Meta Business Manager**: se lo studente non ha un account, deve crearne uno su [business.facebook.com](https://business.facebook.com)
* **Documento di identità aziendale** per la verifica Meta (visura camerale o documento equivalente)
* **Circa 1 settimana** di tempo disponibile per l'approvazione, non avviare il processo se il go-live è imminente

## Processo

<Steps>
  <Step title="Lo studente richiede il numero dal portale Conduit (prefisso città)">
    È **lo studente** che, dal **portale Conduit**, **richiede il numero** italiano dedicato, specificando il **prefisso della propria città**. Prepara anche i prerequisiti: numero di telefono libero, accesso a Meta Business Manager e documenti aziendali. Fatta la richiesta, avvisa il **team Mattone** per la parte WABA/Meta.
  </Step>

  <Step title="Il team Mattone sottomette e segue la pratica con Conduit support">
    Il **team Mattone** prende in carico la parte delicata: **sottomette la richiesta del numero a Conduit support** (indicando il **prefisso città** dato dallo studente) e ne segue la pratica. Alla sottomissione arriva una conferma con un **Case Number**; i tempi sono di **\~5 giorni lavorativi**. Il numero viene **provisionato via Twilio** dentro il workspace Conduit (è il "numero backend" con forwarding verso il numero italiano guest-facing); i workspace dello stesso studente/azienda vanno **allineati sotto lo stesso subaccount** per acquistare e associare il numero. Lo studente **non contatta Conduit direttamente**.
  </Step>

  <Step title="Conduit support crea il WABA">
    Il team Conduit support crea il WABA e lo collega al workspace Conduit dello studente. Questa operazione avviene lato Conduit e non richiede azioni da parte dello studente.
  </Step>

  <Step title="Meta invia la richiesta di verifica">
    Meta invia una richiesta di verifica aziendale al Meta Business Manager dello studente. Lo studente riceve una notifica nell'account Manager.
  </Step>

  <Step title="Lo studente approva la verifica in Meta Business Manager">
    Lo studente accede a [business.facebook.com](https://business.facebook.com), trova la richiesta di verifica e completa il processo caricando i documenti aziendali richiesti. Il team Mattone può assistere se necessario.
  </Step>

  <Step title="WABA attivo, test di invio">
    Una volta approvato da Meta, il WABA è attivo. Invia un messaggio di test al numero per verificare che la ricezione funzioni correttamente. Controlla che il numero appaia nelle impostazioni Conduit del workspace.
  </Step>
</Steps>

<Warning>
  Non usare un numero già attivo su WhatsApp normale (account privato), il processo di migrazione da WhatsApp normale a WhatsApp Business API è complesso, richiede tempo aggiuntivo e può causare un periodo di downtime durante il quale il numero non riceve messaggi.
</Warning>

## Verifica

Dopo l'attivazione, controlla che tutto sia corretto:

* Il WABA appare come **attivo** nelle impostazioni Conduit del workspace dello studente
* Un **messaggio di test** inviato al numero viene ricevuto correttamente

<Note>
  Dopo l'attivazione, il numero appare nelle impostazioni Conduit del workspace e le skill di escalation e reminder si attivano automaticamente, non è necessaria alcuna configurazione aggiuntiva lato Mattone per i flussi standard.
</Note>

<Tip>
  **▷ Prompt Claude Code: Prepara il collegamento WABA**  ·  incolla in Claude Code:
</Tip>

```text theme={null}
Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato.
Per prima cosa apri il repo `~/Projects/api-kross-mattone` (telefonia/WABA,
provisioning) e LEGGI la pagina mattone-docs /integrazioni/waba/collegamento; lo
stato numero si verifica in Conduit (MCP Conduit) e il supporto WABA/Meta lo dà
il team Mattone. Poi procedi:

Aiutami a preparare il collegamento WABA per lo studente [NOME] seguendo
mattone-docs /integrazioni/waba/collegamento. Ricordami CHI FA COSA: lo studente
richiede il numero dal portale Conduit (prefisso città); il team Mattone supporta
la registrazione WABA con Meta e il collegamento al Business Manager. Fammi la
checklist dei prerequisiti (numero non già su WhatsApp, accesso Meta Business
Manager, documenti aziendali) e prepara i testi dei template WhatsApp da far
approvare. Dopo
la registrazione, verifica lo stato "Registered" e ricordami che se non è
collegato inbound/outbound falliscono in silenzio (una spunta sola).
```

<CardGroup cols={2}>
  <Card title="Telefonia & WABA (setup)" icon="arrow-up-right-from-square" href="/integrazioni/conduit/telefonia-waba">Numero + voice agent + escalation</Card>
  <Card title="Meta Business" icon="arrow-up-right-from-square" href="https://business.facebook.com">Registrazione numero WhatsApp Business</Card>
</CardGroup>