> ## 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.

# Troubleshooting WABA: verifica Meta e messaggi bloccati

> Diagnosi e risoluzione dei problemi WABA più comuni: verifica Meta bloccata, template non approvati, webhook non configurato e WABA sospeso.

Usa questa guida per diagnosticare i problemi dell'integrazione WABA, la maggior parte dei casi riguarda una verifica Meta non completata o un numero di telefono configurato in modo errato. Per i problemi legati alle policy Meta o alla sospensione dell'account, contatta sempre il team Mattone, che gestisce direttamente l'accesso al Business Manager.

## Tabella sintomi, cause e soluzioni

| Sintomo                                     | Causa probabile                                             | Soluzione                                                                                                                                                      |
| ------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Numero non collegato a Conduit              | Provisioning WABA non completato o fallito                  | Contatta il team Mattone per riaprire il ticket con Conduit support e verificare lo stato del provisioning                                                     |
| Verifica Meta bloccata o in attesa          | Business Manager non verificato o documenti insufficienti   | Completa la verifica aziendale in Meta Business Manager caricando i documenti richiesti; contatta il team Mattone se la verifica è bloccata da più di 3 giorni |
| Messaggi non recapitati all'ospite          | Template WhatsApp non approvato da Meta                     | Verifica lo stato del template in Meta Business Manager → **Message Templates**; un template rifiutato deve essere modificato e ri-sottomesso                  |
| URL non accettato da WhatsApp nei messaggi  | URL non presente nella whitelist Meta                       | Aggiungi il dominio alla lista approvata in Meta Business Manager; i link accorciati o i redirect non riconosciuti vengono bloccati da WhatsApp                |
| WABA sospeso                                | Violazione delle policy Meta (spam, contenuto non conforme) | Contatta Conduit support tramite il team Mattone fornendo il Business Manager ID; non tentare di creare un nuovo WABA, peggiora la situazione                  |
| Messaggio in entrata non gestito da Conduit | Webhook WABA non configurato o URL errato                   | Verifica il webhook URL nelle impostazioni del workspace Conduit; il webhook deve puntare all'endpoint corretto e rispondere con 200 OK                        |

<Note>
  Per problemi relativi alla verifica Meta, alla policy WhatsApp o alla sospensione del WABA, contatta il **team Mattone**, la gestione Meta richiede accesso diretto al Business Manager account e non può essere risolta autonomamente dal singolo operatore di onboarding senza quell'accesso.
</Note>

<Tip>
  **▷ Prompt Claude Code: Debug 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) e
LEGGI le pagine mattone-docs /troubleshooting/metodo e /integrazioni/waba/troubleshooting;
lo stato numero si verifica in Conduit (MCP Conduit) e il supporto WABA/Meta lo
dà il team Mattone. Poi procedi:

Applica il metodo di mattone-docs /troubleshooting/metodo a questo problema
WABA: [DESCRIVI IL SINTOMO, es. "il numero non risponde" / "errore url sito
in registrazione FB->Conduit"]. Verifica lo stato reale in Conduit -> Settings
-> WhatsApp -> Numbers: è "Registered" (verde)? Ricorda che se non è collegato
inbound/outbound falliscono in silenzio (una spunta sola). Isola: numero non
registrato, url sito non accettato (prova www. senza https), OTP su numero
fisso arriva via CHIAMATA non SMS. Il supporto WABA/Meta lo dà il team Mattone:
prepara la checklist di cosa serve.
```

<CardGroup cols={2}>
  <Card title="Collegamento WABA" icon="arrow-up-right-from-square" href="/integrazioni/waba/collegamento">Step e verifica "Registered"</Card>
  <Card title="Telefonia & WABA" icon="arrow-up-right-from-square" href="/integrazioni/conduit/telefonia-waba">Numero + voice + escalation</Card>
</CardGroup>