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 — e con un pubblico preciso:
  • Onboarding studente (team delivery): la procedura guidata passo dopo passo per portare online un nuovo property manager, dall’anagrafica alla verifica finale
  • Casistiche (team delivery): playbook per le situazioni ricorrenti: studente che cambia PMS, porta che non risponde, agente che ignora un tool
  • Delivery a volumi (team delivery, quando gli studenti attivi sono tanti): da dove nasce un ticket, chi risponde a cosa per tema, come si risponde e si chiude, la coda Voci, le metriche. È la sezione operativa del giorno per giorno, non la procedura di un singolo studente.
  • Manutenzione (team delivery, dopo l’attivazione): cosa fare quando qualcosa si rompe su uno studente già attivo — presa in carico, nostro o suo, chiusura e diario.
  • Marketing Clienti (team marketing/delivery): onboarding marketing, sito vetrina, template ads, setup dell’agenzia su GHL.
  • Integrazioni (developer di riferimento + team delivery per il collegamento): come funziona ogni pezzo della piattaforma (KrossBooking, Conduit, SwitchBot, Stripe, GHL) e come si collega agli altri
  • Troubleshooting (chiunque sia bloccato): il metodo di debug in 5 mosse e i codici di errore per ogni integrazione, con la soluzione associata
  • Riferimenti (developer di riferimento, o chiunque cerchi “dove sta scritto X”): repo API — inclusa la mappa di tutti i repo Mattone, quale usare per cosa — 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.