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

# Step 6 · Verifica finale e smoke test dell'onboarding

> Checklist e smoke test per dichiarare l'onboarding completato: ogni punto va verificato con evidenza reale dai log, non solo dall'interfaccia.

Non dichiarare l'onboarding completato finché ogni punto di questa checklist non è stato verificato con evidenza reale dai log. L'interfaccia può mostrare tutto verde mentre qualcosa non funziona correttamente, solo i log dimostrano che ogni componente ha eseguito con successo. Prenditi il tempo necessario per questo step: un onboarding dichiarato "fatto" troppo presto genera problemi agli ospiti reali.

<Warning>
  Non dichiarare "fatto" se non hai visto i log. L'apparenza inganna.
</Warning>

## Checklist di verifica

Verifica ogni punto nell'ordine indicato. Segna una voce come completata solo dopo aver aperto i log e confermato l'esito positivo.

* [ ] **Accesso Admin Mattone al workspace Conduit**, `francesco@mattone.co` compare nella lista membri del workspace con ruolo **Admin** (va aggiunto **a mano** dalla dashboard: non esiste API). Se manca, il team perde l'accesso UI a quel workspace: verificalo **prima** di considerare il workspace "pronto"
* [ ] **Kross verde**, il test di connessione via `mcp.mattone.co` restituisce verde e Conduit riesce a recuperare almeno una prenotazione reale per lo studente
* [ ] **KB Conduit per-listing**, testa una domanda da ospite su un appartamento specifico (es. *"Come arrivo all'appartamento?"*) e verifica che la risposta usi solo le informazioni di quell'appartamento; zero leak da altri appartamenti
* [ ] **Ogni tool ha la sua skill**, apri la configurazione Conduit dello studente e verifica che ogni tool montato (Kross, Shelly/SwitchBot, Stripe) abbia la skill corrispondente abbinata
* [ ] **Smart-lock: apertura reale testata, log letto**, *(solo se applicabile)* un'apertura reale è stata eseguita durante l'onboarding e il log mostra `success` con `listing_id` corretto e timestamp atteso
* [ ] **Stripe: link di test generato**, Conduit ha generato almeno un link di pagamento di test che aperto nel browser mostra la pagina Stripe corretta
* [ ] **Telefonia/WABA: messaggio di prova ricevuto**, un messaggio di test inviato al numero/WABA dello studente ha ricevuto risposta da Conduit; il log mostra la conversazione

## Regola

Per ogni punto della checklist, la procedura è sempre la stessa: esegui l'azione, poi **apri i log e leggili**. Non fidarti solo dell'esito visivo nell'interfaccia. I log mostrano:

* L'ID esatto della risorsa coinvolta (appartamento, prenotazione, device)
* Il timestamp dell'evento
* L'esito dettagliato (`success` / `error` + codice)
* Eventuali warning che non bloccano l'esecuzione ma indicano problemi latenti

Se un log mostra warning, annotali e valuta se richiedono azione prima di procedere.

<Tip>
  Se uno dei punti della checklist fallisce, vai direttamente alla pagina di troubleshooting dell'integrazione corrispondente prima di tentare un fix manuale o di escalare. Ogni integrazione ha la sua guida diagnostica dedicata: [Kross](/integrazioni/kross/troubleshooting), [Conduit](/integrazioni/conduit/troubleshooting), [Shelly](/integrazioni/shelly/troubleshooting), [SwitchBot](/integrazioni/switchbot/troubleshooting). Per un approccio sistematico valido per qualsiasi problema, consulta [Metodo di troubleshooting](/troubleshooting/metodo).
</Tip>

## Quando l'onboarding è completato

L'onboarding è ufficialmente completato quando:

1. Tutti i punti della checklist qui sopra sono spuntati
2. Hai i log come evidenza per ognuno
3. Hai comunicato allo studente che il sistema è attivo e gli hai fornito il contatto per il supporto operativo

Documenta la data di completamento e salva un riferimento ai log di verifica nel profilo dello studente sulla piattaforma.

<Tip>
  **▷ Prompt Claude Code: Verifica finale**  ·  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 i repo coinvolti, `~/Projects/api-kross-mattone`
(provisioning/skill), `~/Projects/mattone-platform` (connessioni/Vault) e il
gateway `~/Projects/mattone-mcp-gateway`, e LEGGI la checklist in mattone-docs
/onboarding/6-verifica-finale; usa gli MCP (Conduit, Supabase) per le prove
reali. Poi procedi:

Esegui la verifica finale dell'onboarding per lo studente [NOME], seguendo la
checklist di mattone-docs /onboarding/6-verifica-finale. Per OGNI voce dimmi
l'esito con la PROVA (quale log/output): Kross auth verde, KB per-listing senza
leak (apri una prenotazione reale), ogni tool con la sua skill attaccata, tool
ON su chat+voice, smart-lock apertura reale, Stripe link di test, voice 1 solo
agente lingua specifica, escalation a umano vero, WhatsApp Registered. Chiudi
con un test end-to-end reale su un ospite presente in Kross. Non dire "fatto"
senza log. Elenca cosa resta aperto.
```

<CardGroup cols={2}>
  <Card title="Metodo troubleshooting" icon="arrow-up-right-from-square" href="/troubleshooting/metodo">Se qualcosa non è verde</Card>
  <Card title="Panoramica onboarding" icon="arrow-up-right-from-square" href="/onboarding/panoramica">Rivedi l'ordine dei passi</Card>
</CardGroup>