Skip to main content
Mattone Docs è pensato per l’intero team Mattone: dai developer che mantengono le integrazioni agli account manager non tecnici che onboardano gli studenti ogni settimana. L’obiettivo è che chiunque nel team riesca a portare online un nuovo property manager e a risolvere i problemi di integrazione più comuni senza dipendere da uno sviluppatore senior per ogni passo.

​
I tre profili

Mattone Docs parla direttamente a tre figure che lavorano con la piattaforma in modi diversi. Team delivery / account manager non tecnico Gestisci l’onboarding degli studenti, configuri Conduit e coordini le attivazioni. Userai soprattutto la sezione Onboarding, i playbook Troubleshooting e il Glossario quando incontri un termine che non conosci. Non devi capire il codice, devi sapere dove guardare e cosa fare. Developer di riferimento Mantieni le integrazioni, scrivi i tool MCP e gestisci le credenziali nel Vault. Userai soprattutto le sezioni Integrazioni e Riferimenti (repo API, catalogo MCP, schema credenziali). Questa documentazione è la fonte di verità condivisa con il team non tecnico. Nuovo membro del team Stai imparando come funziona Mattone. Inizia da questa pagina, poi leggi il Glossario e la sezione Onboarding nell’ordine in cui è scritta. Ogni pagina apre con l’obiettivo dell’utente, segui quello e non ti perdi.

​
Come sono organizzati

Mattone Docs è diviso in sezioni tematiche, ognuna con uno scopo preciso:
  • Onboarding studente: la procedura guidata passo dopo passo per portare online un nuovo property manager, dall’anagrafica alla verifica finale
  • Integrazioni: come funziona ogni pezzo della piattaforma (KrossBooking, Conduit, SwitchBot, Stripe, GHL) e come si collega agli altri
  • Troubleshooting: il metodo di debug in 5 mosse e i codici di errore per ogni integrazione, con la soluzione associata
  • Casistiche: playbook per le situazioni ricorrenti: studente che cambia PMS, porta che non risponde, agente che ignora un tool
  • Riferimenti: repo API, catalogo MCP, schema delle credenziali nel Vault, contatti di escalation

​
Regola d’oro

Prima di collegare qualsiasi pezzo, un tool Conduit, una serratura, un PMS, apri la pagina Integrazioni corrispondente e segui i passi nell’ordine in cui sono scritti. L’ordine non è casuale: ogni passo crea la precondizione del successivo. Saltarlo è la causa numero uno di malfunzionamenti silenziosi.