# Mattone Docs

## Docs

- [Mattone Docs: knowledge base operativa del team delivery](https://docs.mattone.co/index.md): La knowledge base operativa di Mattone: onboarding studenti, integrazioni, troubleshooting e best practice per gestire ogni property manager.
- [Mattone Docs: a chi è rivolto e come usarlo al meglio](https://docs.mattone.co/inizia-qui/a-chi-serve.md): Scopri a chi è rivolto Mattone Docs, i tre profili del team, come sono organizzate le sezioni e la regola d'oro da seguire sempre.
- [Come lavoriamo: la Piattaforma e Claude Code + i repo](https://docs.mattone.co/inizia-qui/come-lavoriamo.md): Due strumenti, due lavori: cosa si fa nell'app Mattone (clic) e cosa con Claude Code + i repo (costruire/aggiustare), e come restano allineati.
- [Glossario Mattone: tutti i termini chiave della piattaforma](https://docs.mattone.co/inizia-qui/glossario.md): Tutti i termini tecnici e operativi usati in Mattone Docs: dal PMS al Vault, dal listing_id al guardrail, spiegati in modo chiaro.
- [Best practice operative per le integrazioni Mattone](https://docs.mattone.co/inizia-qui/best-practices.md): Le 7 regole d'oro che si applicano a ogni integrazione Mattone: seguirle previene l'80% dei problemi e riduce il tempo di debug sul campo.
- [Metodo di troubleshooting per le integrazioni Mattone](https://docs.mattone.co/troubleshooting/metodo.md): Il metodo in 5 mosse per diagnosticare qualsiasi problema di integrazione Mattone: dalla riproduzione alla documentazione della soluzione.
- [Onboarding studente Mattone: la procedura completa](https://docs.mattone.co/onboarding/panoramica.md): Guida completa ai sei step obbligatori per attivare un nuovo studente su Mattone: dall'anagrafica Notion fino alla verifica finale con smoke test.
- [Step 1 · Anagrafica e registro appartamenti su Notion](https://docs.mattone.co/onboarding/1-anagrafica-notion.md): Crea e allinea il database Apartments su Notion: fonte canonica per KB, listino e contratti. Deve essere completo prima di ogni altro step.
- [Step 2 · Collegare KrossBooking come PMS dello studente](https://docs.mattone.co/onboarding/2-pms-kross.md): Connetti KrossBooking alla piattaforma Mattone per dare a Conduit accesso a prenotazioni, dati ospite e stato check-in dello studente in tempo reale.
- [Step 3 · Configurare l'agente Conduit per lo studente](https://docs.mattone.co/onboarding/3-conduit.md): Imposta l'agente AI Conduit: KB per-listing da Notion, custom tool con skill abbinate, workflow automatici e canale telefonico/WABA per lo studente.
- [Step 4 · Smart check-in: apertura porta remota da link](https://docs.mattone.co/onboarding/4-smart-checkin.md): Configura l'apertura remota via link per appartamenti con smart lock Shelly o SwitchBot. Salta lo step se lo studente non ha serrature smart.
- [Step 5 · Pagamenti extra via Stripe: setup e Conduit](https://docs.mattone.co/onboarding/5-pagamenti-stripe.md): Configura Stripe con una Restricted Key a permessi minimi per permettere a Conduit di generare link di pagamento per extra e upsell direttamente in chat.
- [Step 6 · Verifica finale e smoke test dell'onboarding](https://docs.mattone.co/onboarding/6-verifica-finale.md): Checklist e smoke test per dichiarare l'onboarding completato: ogni punto va verificato con evidenza reale dai log, non solo dall'interfaccia.
- [Stato e continuazione dell'onboarding studente](https://docs.mattone.co/onboarding/stato-e-continuazione.md): Come capire a che punto è l'onboarding di uno studente e come riprenderlo da dove è arrivato: l'handoff tra membri del team senza perdere pezzi.
- [Playbook: late check-out e early check-in a pagamento](https://docs.mattone.co/casistiche/late-early-checkin.md): Gestisci richieste di late check-out e early check-in: verifica automatica della disponibilità, generazione del link Stripe e notifica al team pulizie.
- [Playbook: vendita di extra e upsell via Conduit e Stripe](https://docs.mattone.co/casistiche/extra-upsell.md): Gestisci la vendita di servizi extra tramite Conduit: dalla ricerca del prezzo in KB alla generazione del link Stripe e alla conferma dell'ospite.
- [Playbook: escalation telefonica e WhatsApp verso operatore](https://docs.mattone.co/casistiche/escalation-telefono.md): Scopri quando e come Conduit trasferisce un ospite a un operatore umano, via telefono o WABA, e come il team gestisce la presa in carico.
- [Playbook: ospite che non completa il check-in online](https://docs.mattone.co/casistiche/checkin-non-completato.md): Gestisci gli ospiti che non completano il portale di check-in online: reminder automatici, blocco del link porta e intervento manuale del team.
- [Flusso completo studente Mattone](https://docs.mattone.co/delivery/flusso-completo.md): Dall'iscrizione al Conduit live: vista d'insieme per il team delivery.
- [Monitorare il lavoro degli studenti](https://docs.mattone.co/delivery/monitorare-studenti.md): Cosa guardare, dove, con quali segnali di allarme.
- [Supportare gli studenti](https://docs.mattone.co/delivery/supportare-studenti.md): Playbook di supporto: come rispondere e risolvere a volumi.
- [Tirare giù numeri & metriche](https://docs.mattone.co/delivery/metriche-numeri.md): Quali dati/report e come ottenerli, per studente e per flotta.
- [Problemi ricorrenti da Conduit](https://docs.mattone.co/delivery/problemi-ricorrenti-conduit.md): Catalogo problema → fix + le best practice che automatizziamo.
- [Personalizzazione per studente](https://docs.mattone.co/delivery/personalizzazione-studente.md): Cosa si adatta per ogni studente (config, non codice): skill policy, KB per-listing, dominio/branding, numeri e contatti.
- [Mancato pagamento: banner, sospensione e riattivazione](https://docs.mattone.co/delivery/mancato-pagamento.md): Cosa succede quando uno studente non paga il canone del servizio AI Ospiti (Conduit): la scala di solleciti, la sospensione al giorno 7, l'holding dell'agente e la riattivazione automatica al pagamento.
- [Token Conduit coach: cosa possiamo fare cross-studente](https://docs.mattone.co/delivery/token-conduit-coach.md): Un accesso Conduit 'coach' vede tutti gli spazi degli studenti: è la leva per gestire tanti studenti con poche persone. Cosa ci fai e dove prenderlo (mai il valore).
- [Prompt per Claude Code](https://docs.mattone.co/riferimenti/prompt-claude-code.md): Prompt pronti da copiare-incollare in Claude Code per onboarding, troubleshooting e dubbi di processo.
- [Strumenti del team per comunicare con gli studenti](https://docs.mattone.co/riferimenti/strumenti-team-studenti.md): WhatsApp MCP, Slack MCP e Resend: cosa fanno, come collegarli a Claude Code e come avvisare lo studente di cosa gli manca (con messaggio di esempio). Zero segreti.
- [Indice repo API: dove sta il codice di ogni integrazione](https://docs.mattone.co/riferimenti/repo-api.md): Trova rapidamente il repository giusto per ogni integrazione Mattone: KrossBooking, Conduit, smart lock, pagamenti e piattaforma core.
- [Catalogo dei tool MCP e custom tool Conduit per stato](https://docs.mattone.co/riferimenti/mcp-catalog.md): Elenco completo dei tool MCP e custom tool Conduit con stato attivo/inattivo; verifica la disponibilità prima di ogni onboarding studente.
- [Gestione credenziali: Vault, rotazione e sicurezza](https://docs.mattone.co/riferimenti/credenziali.md): Regola zero-segreti di Mattone: dove si conservano le credenziali di ogni integrazione, come si ruotano e cosa fare se una chiave viene esposta.
- [Env & accessi del team](https://docs.mattone.co/riferimenti/env-accessi-team.md): Indice dei nomi di variabili d'ambiente e segreti usati dalla piattaforma: a cosa serve ciascuno e dove prenderlo. ZERO valori reali.
- [Indice delle skill: Claude Code e Conduit](https://docs.mattone.co/riferimenti/skill-index.md): Le due famiglie di skill di Mattone: le skill Claude Code che usa il team e le skill Conduit (agent skill) abbinate ai custom tool dell'agente ospite. Cosa sono, dove si installano e come si distinguono.
- [Come aggiornare e mantenere la documentazione Mattone](https://docs.mattone.co/riferimenti/manutenzione-docs.md): Guida pratica per il team Mattone: dove inserire nuovi contenuti, come pubblicare una modifica e le regole di stile per tenere la documentazione coerente.
- [KrossBooking: PMS e prenotazioni per studenti Mattone](https://docs.mattone.co/integrazioni/kross/panoramica.md): Scopri come KrossBooking si integra con Mattone: lettura prenotazioni, dati ospiti e stato check-in in tempo reale tramite gateway.
- [Accessi & credenziali KrossBooking](https://docs.mattone.co/integrazioni/kross/accessi.md): Dove si prendono gli accessi Kross (portale partner, sandbox, le 3 credenziali del cliente, IP whitelist) e cosa fa ciascuna (mai valori reali).
- [Collegare KrossBooking: API credentials e test connessione](https://docs.mattone.co/integrazioni/kross/collegamento.md): Guida passo-passo per ottenere le credenziali Kross di uno studente, salvarle nel Vault e verificare che la connessione sia attiva.
- [KrossBooking API: autenticazione ed endpoint disponibili](https://docs.mattone.co/integrazioni/kross/endpoint-scope.md): Autenticazione bearer e tutti gli endpoint KrossBooking usati da Mattone: disponibilità, prenotazioni, portali check-in e accesso.
- [KrossBooking: rate limit, trappole e comportamenti non ovvi](https://docs.mattone.co/integrazioni/kross/rate-limit-trappole.md): Limiti di frequenza per struttura sull'API Kross e cinque comportamenti non ovvi che producono errori silenziosi nell'integrazione Mattone.
- [Troubleshooting KrossBooking: sintomi, cause e soluzioni](https://docs.mattone.co/integrazioni/kross/troubleshooting.md): Tabella sintomo → causa → soluzione per diagnosticare e risolvere i problemi più comuni dell'integrazione KrossBooking su Mattone.
- [GoHighLevel: CRM, marketing e automazione per Mattone](https://docs.mattone.co/integrazioni/ghl/panoramica.md): Come Mattone usa GHL per tracciare lead, calcolare ROAS e CAC per studente e gestire la fatturazione dei sub-account dal terzo mese.
- [GHL PIT: token per location e configurazione accesso](https://docs.mattone.co/integrazioni/ghl/pit-location.md): Come generare il Private Integration Token GHL per una location studente, quali scope concedere e come salvarlo in modo sicuro su Mattone.
- [GHL lead e valore opportunità: ROAS, CAC e campagne](https://docs.mattone.co/integrazioni/ghl/lead-valore.md): Quali campi GHL legge Mattone per ogni studente, come vengono usati per calcolare ROAS e CAC e con quale frequenza i dati si aggiornano.
- [Rebilling GHL: sub-account e fatturazione dal terzo mese](https://docs.mattone.co/integrazioni/ghl/rebilling.md): Come funziona il rebilling GHL per i sub-account degli studenti Mattone, quando si attiva e cosa fare se il processo non parte correttamente.
- [Troubleshooting GHL: PIT, dati mancanti e scope errati](https://docs.mattone.co/integrazioni/ghl/troubleshooting.md): Tabella sintomo → causa → soluzione per i problemi più frequenti dell'integrazione GHL: PIT scaduto, dati lead mancanti e scope insufficienti.
- [Operations: panoramica](https://docs.mattone.co/integrazioni/operations/panoramica.md): Il tool operativo: pulizie, revenue, EBITDA per appartamento.
- [Operations: collegamento gestionale](https://docs.mattone.co/integrazioni/operations/collegamento.md): Collegare il PMS a Operations e seedare l'anagrafica.
- [Reconciliation: riconciliazione bancaria (Revolut)](https://docs.mattone.co/integrazioni/operations/reconciliation.md): Il tool che confronta i movimenti bancari con le prenotazioni/payout: quando serve, come si collega a Revolut Business, e stato (in miglioramento).
- [Conduit: l'agente AI per la gestione ospiti Mattone](https://docs.mattone.co/integrazioni/conduit/panoramica.md): Architettura del workspace Conduit per studenti Mattone: KB per-listing, custom tool, workflow, guardrail e canali telefonici/WABA in un'unica vista.
- [Conduit: pacchetto completo end-to-end](https://docs.mattone.co/integrazioni/conduit/pacchetto-completo.md): KB + custom tool + workflow + guardrail + telefonia insieme.
- [Conduit KB: knowledge base per-listing e senza leak](https://docs.mattone.co/integrazioni/conduit/kb.md): Configura la KB Conduit per-listing: scoping corretto con entity_ids, tipi di nodo e bridge Notion per evitare leak di dati tra appartamenti.
- [Conduit Custom Tools: azioni AI e regola tool+skill](https://docs.mattone.co/integrazioni/conduit/custom-tools.md): Catalogo e configurazione dei custom tool Conduit: Kross, Smart Lock e Stripe. Come verificare che tool e skill abbinata funzionino insieme correttamente.
- [Conduit Workflow: automazioni deterministiche per gli ospiti](https://docs.mattone.co/integrazioni/conduit/workflow.md): Come funzionano i workflowsV2 di Conduit: struttura trigger-step-variabili, workflow tipici per late check-in/out, upsell e reminder, e come crearli.
- [Conduit Guardrail: vincoli negativi hard sull'agente](https://docs.mattone.co/integrazioni/conduit/guardrail.md): Come configurare i guardrail Conduit: vincoli hard che l'agente rispetta sempre, esempi di regole tipiche e come verificare che funzionino correttamente.
- [Troubleshooting Conduit: leak KB, tool ignorati e bug noti](https://docs.mattone.co/integrazioni/conduit/troubleshooting.md): Tabella sintomo-causa-soluzione per i problemi Conduit più comuni: leak di Knowledge Base, tool non attivati, workflow fermi e bug noti con workaround.
- [Conduit Telefonia e WABA: numero e WhatsApp ufficiale](https://docs.mattone.co/integrazioni/conduit/telefonia-waba.md): Attiva telefonia VoiceAI e WhatsApp Business su Conduit: tracce disponibili, tempistiche di ~1 settimana, prerequisiti WABA e warm transfer allo studente.
- [WABA: WhatsApp Business collegato all'agente Conduit](https://docs.mattone.co/integrazioni/waba/panoramica.md): Panoramica dell'integrazione WABA in Mattone: numero WhatsApp Business collegato a Conduit per messaggi automatici, reminder check-in e notifiche ospite.
- [Collegare WABA: numero WhatsApp Business e Conduit](https://docs.mattone.co/integrazioni/waba/collegamento.md): Come attivare un numero WhatsApp Business Account per Conduit: prerequisiti, processo di provisioning via Meta Business Manager e verifica finale.
- [Troubleshooting WABA: verifica Meta e messaggi bloccati](https://docs.mattone.co/integrazioni/waba/troubleshooting.md): Diagnosi e risoluzione dei problemi WABA più comuni: verifica Meta bloccata, template non approvati, webhook non configurato e WABA sospeso.
- [Notion: registro appartamenti e anagrafica canonica](https://docs.mattone.co/integrazioni/notion/panoramica.md): Notion è la fonte canonica dell'anagrafica appartamenti: da qui si generano la KB di Conduit, il listino e i contratti per ogni studente.
- [Collegare Notion via OAuth alla piattaforma Mattone](https://docs.mattone.co/integrazioni/notion/collegamento.md): Guida passo-passo per autorizzare il workspace Notion dello studente e permettere alla piattaforma di leggere il DB Apartments e sincronizzare la KB.
- [Notion DB Apartments: struttura e allineamento al template](https://docs.mattone.co/integrazioni/notion/db-apartments.md): Campi obbligatori del database Apartments in Notion, come allinearlo al template Mattone e come verificare che il bridge sincronizzi correttamente.
- [Bridge Notion → Conduit KB: sincronizzazione per-listing](https://docs.mattone.co/integrazioni/notion/bridge-conduit.md): Come il bridge trasforma i record del DB Apartments in nodi KB isolati per ogni listing in Conduit e come verificare che la sincronizzazione funzioni.
- [Notion: Anagrafica canonica e upgrade](https://docs.mattone.co/integrazioni/notion/anagrafica-registro.md): Registro appartamenti + bridge + template audit (upgrade non ancora tutti online).
- [Troubleshooting Notion: sync rotto e template disallineato](https://docs.mattone.co/integrazioni/notion/troubleshooting.md): Tabella sintomo-causa-soluzione per diagnosticare i problemi più comuni dell'integrazione Notion: OAuth revocato, listing_id errati e webhook inattivi.
- [PriceLabs: gestione del pricing dinamico degli alloggi](https://docs.mattone.co/integrazioni/pricelabs/panoramica.md): Panoramica dell'integrazione PriceLabs: come collega il tuo account, come ottimizza le tariffe automaticamente e i due modelli di gestione disponibili.
- [Collegare PriceLabs: Client ID e OAuth MCP](https://docs.mattone.co/integrazioni/pricelabs/collegamento.md): Come collegare PriceLabs a Mattone via MCP (Client ID + OAuth), così la piattaforma legge gli insight di pricing dello studente.
- [Revenue management con PriceLabs: self vs delegato](https://docs.mattone.co/integrazioni/pricelabs/revenue-management.md): I due modelli di gestione tariffaria (self-managed e delegato) e i concetti fondamentali di PriceLabs per ottimizzare i ricavi degli appartamenti.
- [Stripe: pagamenti dello studente](https://docs.mattone.co/integrazioni/stripe/panoramica.md): Restricted key a permessi minimi, collegamento nel Vault, e doppio uso: extra in chat Conduit + checkout del sito direct booking.
- [Sito Direct Booking: come si crea](https://docs.mattone.co/integrazioni/direct-booking/panoramica.md): Come si costruisce il sito di prenotazione diretta di uno studente: fork del template canonico, stack, PMS, pagamenti, deploy, dominio.
- [Shelly: relay per apertura citofono e porta da remoto](https://docs.mattone.co/integrazioni/shelly/panoramica.md): Panoramica dell'integrazione Shelly in Mattone: come funziona il relay per il self check-in remoto e quando usarlo rispetto ad altri dispositivi.
- [Collegare un device Shelly alla piattaforma Mattone](https://docs.mattone.co/integrazioni/shelly/collegamento.md): Come registrare un device Shelly nella piattaforma Mattone usando il token Shelly Cloud per abilitare l'apertura remota della porta.
- [Troubleshooting Shelly: relay offline e apertura fallita](https://docs.mattone.co/integrazioni/shelly/troubleshooting.md): Diagnosi e risoluzione dei problemi più comuni nell'integrazione Shelly: device offline, token scaduto, canale relay errato e apertura mancata.
- [SwitchBot Smart Lock: apertura remota con Hub Mini](https://docs.mattone.co/integrazioni/switchbot/panoramica.md): Panoramica dell'integrazione SwitchBot Smart Lock in Mattone: prerequisiti, differenze con Shelly e come abilitare l'apertura remota tramite Hub Mini.
- [Collegare SwitchBot Smart Lock: token, Device ID e test](https://docs.mattone.co/integrazioni/switchbot/collegamento.md): Come collegare SwitchBot Smart Lock a Mattone: recupero del token owner, Device ID, verifica Hub Mini e test di apertura remota con lettura dei log.
- [Troubleshooting SwitchBot: errore 161 e device offline](https://docs.mattone.co/integrazioni/switchbot/troubleshooting.md): Come risolvere l'errore 161 di SwitchBot e altri problemi comuni: Hub Mini offline, account member, Cloud Service disabilitato e serratura fuori portata.

## Optional

- [Piattaforma Mattone](https://app.mattone.co)