| 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. |
| Gateway | mcp.mattone.co, il punto di ingresso unico che smista le chiamate degli agenti studenti verso i servizi corretti (KrossBooking, Shelly, Stripe, ecc.). |
| 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, il 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 (CONDUIT_COACH_TOKEN), 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.