| Termine | Significato |
|---|---|
| PMS | Il gestionale delle prenotazioni. Gli studenti usano KrossBooking; i clienti Dubai usano Hostaway. È la fonte di verità per soggiorni, ospiti e disponibilità. |
| Conduit | L’assistente AI che risponde agli ospiti via WhatsApp (o altri canali). Ogni studente ha il proprio workspace Conduit dedicato. |
| Workspace | Lo spazio Conduit di uno studente: contiene la Knowledge Base, l’agente configurato e i tool attivi. Un workspace = uno studente. |
| KB (Knowledge Base) | I documenti che l’AI legge per rispondere agli ospiti. È sempre organizzata per appartamento: ogni listing ha la propria KB per evitare che informazioni di una proprietà “fuoriescano” verso ospiti di un’altra. |
| listing_id | L’ID univoco di un singolo appartamento. Lega la KB al posto giusto e impedisce il leak di informazioni tra proprietà diverse dello stesso studente. |
| Custom tool | Un’azione che l’agente AI può eseguire su richiesta dell’ospite: aprire una porta, generare un link di pagamento, verificare la disponibilità. Deve sempre essere accompagnato dalla sua skill. |
| Skill | Le istruzioni che dicono all’agente quando e come usare un tool. Senza skill il tool viene ignorato dall’agente o innesca un comportamento nativo inaffidabile. |
| Guardrail | Una regola “non fare mai X” imposta sull’agente. Limita i comportamenti indesiderati indipendentemente da ciò che chiede l’ospite. |
| Hub Mini | La scatoletta SwitchBot che collega fisicamente la serratura al cloud tramite WiFi. Senza Hub Mini online la porta non risponde ai comandi remoti. |
| WABA | WhatsApp Business Account, il numero ufficiale da cui l’agente Conduit scrive agli ospiti. Un numero dedicato per studente. |
| MCP | Il ponte (Model Context Protocol) con cui Conduit chiama i tool Mattone. Consente all’agente di invocare azioni esterne in modo strutturato. |
| MCP Gateway | Quello a cui si collegano gli agenti Conduit degli studenti per arrivare a KrossBooking, Shelly e Stripe (mcp.mattone.co): oggi tramite i custom tool, a breve anche come collegamento MCP diretto. |
| MCP Delivery | Quello che il team di delivery collega al proprio Claude per lavorare sulla Mattone Platform: studenti, voci, richieste ai fornitori. Vedi MCP Delivery. |
| Voce | Una richiesta su uno studente registrata sulla piattaforma, con chi la risolve e com’è finita. La apre il setter, la risolve il team: vedi La coda Voci. |
| Vault | Il magazzino cifrato dove sono conservate tutte le credenziali dei clienti. Le chiavi API non vanno mai nei repo né nelle chat: sempre e solo nel Vault. |
| Repo | Abbreviazione di repository: una cartella di codice e documenti su GitHub dove il team tiene e aggiorna le cose, es. mattone-docs (questi docs), la piattaforma, l’MCP Gateway. Le modifiche vanno online con un git push. |
| Le 3 credenziali Kross | I 3 dati per leggere i dati Kross di un cliente: hotel_id (quale struttura/account), username (api…, l’utente tecnico), password (la sua password). Vanno sempre insieme alla api_key (la chiave che autorizza a parlare con Kross: nostra generica per i partner, propria per gli “own”). |
| Provision | Il bottone/azione della Piattaforma che monta gli strumenti dell’assistente (+ le loro istruzioni/skill) nello spazio Conduit di uno studente. |
| Restricted Key | Chiave Stripe a permessi minimi: può creare prodotti/prezzi/link di pagamento, ma non fare rimborsi né leggere i dati dei clienti. Si usa questa, mai la Secret Key. |
| PIT | La chiave della “location” (account CRM) di uno studente su GoHighLevel (GHL). Serve a leggere lead, valori e spesa. |
| OAuth | Un collegamento con accesso autorizzato: lo studente approva l’accesso una volta (login sul servizio) e non si incolla nessuna chiave. Usato per Notion e PriceLabs. |
| Token Conduit coach | L’accesso Conduit che vede tutti gli spazi degli studenti (gestione a scala). Il valore vive solo nel Vault, mai nei docs. |
| Studente | Il property manager cliente di Mattone: la persona (o azienda) che gestisce gli appartamenti e per cui viene configurata l’intera piattaforma. |
Salva questa pagina nei segnalibri del browser. È il riferimento più veloce quando incontri un termine sconosciuto durante un onboarding o una sessione di debug.