Skip to main content
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.
Non dichiarare “fatto” se non hai visto i log. L’apparenza inganna.

​
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.
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, Conduit, Shelly, SwitchBot. Per un approccio sistematico valido per qualsiasi problema, consulta Metodo di troubleshooting.

​
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.
▷ Prompt Claude Code: Verifica finale · incolla in Claude Code:

Metodo troubleshooting

Se qualcosa non è verde

Panoramica onboarding

Rivedi l’ordine dei passi