Skip to main content
Conduit è il cervello AI che risponde agli ospiti per conto dello studente. Ogni studente ha il proprio workspace isolato composto da KB, agente e tool. La configurazione va eseguita in un ordine preciso: prima la base di conoscenza, poi i tool con le relative skill, poi i workflow, e infine il canale telefonico/WABA. Saltare o invertire questi passaggi causa comportamenti imprevisti nell’agente.
GATE DI ATTIVAZIONE, due condizioni OBBLIGATORIE prima di attivare il workspace Conduit. A chi fa l’onboarding: non attivare il workspace/agente Conduit di uno studente se non ha entrambe:
  1. Contratto “Servizio AI Ospiti” FIRMATO: l’Addendum “Servizio AI Ospiti” (Mattone.co LLC ↔ studente) che regola canone €9/Listing/mese, Costi a Consumo, durata minima 12 mesi e autorizzazione all’addebito. Verifica firma + Data attivazione (sezione “Dettagli Attivazione” del contratto).
  2. Carta a file nella piattaforma: lo studente deve aver aggiunto il metodo di pagamento (carta) nell’area billing della piattaforma. Senza carta, l’addebito ricorrente non può partire.
Se manca anche solo UNA delle due → NON attivare. Nessuna eccezione. L’attivazione fa decorrere il canone dalla Data di attivazione.Dove si legge lo stato: contract_signed = true e presenza della carta (metodo di pagamento) nella piattaforma / area billing dello studente. Lo stato “contratto firmato” va registrato nella piattaforma (app.mattone.co), non solo qui: quando confermi la firma, flaggalo (o carica il PDF firmato) nella scheda dello studente, la piattaforma è la fonte unica, lo studente stesso vede il suo contratto nella sua area e l’attivazione del billing resta legata a quel flag.
PRIMA DI TUTTO, accesso Admin Mattone (obbligatorio, facile da dimenticare). Appena creato il workspace Conduit di uno studente, aggiungi francesco@mattone.co come Admin (dashboard Conduit → membri/team → invita come Admin). È l’unico modo per garantire che il team Mattone abbia sempre accesso a quel workspace.⚠️ Non esiste un’API per aggiungere membri: va fatto a mano nella dashboard. Se te ne dimentichi, il team perde l’accesso (dalla UI) a quel workspace. Verifica che l’Admin Mattone sia nella lista membri prima di considerare il workspace pronto.(È in corso una richiesta a Conduit per aggiungere francesco@mattone.co come Admin in automatico a ogni nuovo workspace, a livello di organizzazione; finché non è attiva, resta questo step manuale.)
KB globale = leak tra appartamenti. Ogni KB deve avere lo scope sulla directory per-listing, non creare mai una KB condivisa tra più appartamenti dello stesso studente.

​
Ordine corretto

1

Costruisci la KB con il bridge Notion → Conduit (OBBLIGATORIO)

Questo è un passo obbligatorio del setup Conduit, non opzionale: senza KB, l’agente non ha le informazioni degli appartamenti (WiFi, indirizzo, accesso, regole, listino) e non può rispondere agli ospiti.Ordine:
  1. Il registro appartamenti su Notion è collegato e completo (Step 1 dell’onboarding).
  2. Il bridge Notion → Conduit genera la KB per-appartamento dentro il workspace Conduit: una cartella per ogni appartamento, con gli entity_id scopati sul listing_id corrispondente.
  3. Da lì l’agente risponde con i dati giusti, quelli di quell’appartamento e basta.
Lo scope per-listing garantisce che Conduit risponda all’ospite del Loft Navigli A solo con le informazioni del Loft Navigli A. Non creare mai una KB globale: causa leak tra appartamenti (accessi sbagliati, listino errato, regole di un altro immobile).→ Come funziona il bridge: Notion → Bridge Conduit · Regole KB: KB per-listing
2

Custom tool con skill abbinate

Per ogni tool che vuoi attivare (Kross, Shelly, Stripe), devi configurare sempre anche la skill di prompting corrispondente. Senza la skill, l’agente non sa quando e come usare il tool e lo ignora completamente.Monta i tool nell’ordine in cui li hai configurati negli step precedenti:
  • Kross tool → skill kross-reservation-reader (richiede Step 2 completato)
  • Shelly tool o SwitchBot tool → skill smart-lock-opener (richiede Step 4 completato)
  • Stripe tool → skill payment-link-generator (richiede Step 5 completato)
Se uno step non è ancora completato, monta i tool corrispondenti solo dopo aver terminato quello step.→ Guida dettagliata: Custom tool e skill
3

Workflow

Configura i workflow per le automazioni deterministiche: late check-in/out, messaggi di benvenuto programmati, promemoria per la restituzione delle chiavi e qualsiasi altra sequenza che non richiede ragionamento dell’agente ma solo esecuzione di regole fisse.I workflow si attivano su trigger (es. X ore prima del check-in) e possono usare i tool già montati nello step precedente.→ Guida dettagliata: Workflow Conduit
4

Telefonia + WABA

Questo è un percorso separato che richiede intervento del supporto Conduit. Il tempo medio di attivazione è circa 1 settimana dalla richiesta. Pianificalo in anticipo: apri il ticket Conduit presto, appena completata la KB e i tool.Chi fa cosa (crystal clear):
  • Lo studente → richiede il numero dal portale Conduit, indicando il prefisso della propria città (numero italiano dedicato).
  • Il team Mattone → supporta la parte WABA/Meta: registrazione WhatsApp Business API con Meta e collegamento al Business Manager Facebook (meglio nuovo), tramite Conduit support.
  • Warm transfer al telefono dello studente per le chiamate che l’agente non gestisce.
Lo standard, già a doc: il numero italiano è quello guest-facing (WhatsApp, chiamate, annunci OTA); l’agente VoiceAI può girare su un numero di backend Conduit con forwarding dal numero italiano, è normale, l’ospite vede sempre il numero italiano.
Cosa dire allo studente, numero IT + WhatsApp ufficiale (WABA)Serve circa 1 settimana, quindi partiamo subito. Passa allo studente questi passi, plain:
  1. Non comprare una SIM e non usare il numero WhatsApp fai-da-te che ti propone Facebook.
  2. Sei tu a richiedere il numero dal portale Conduit, indicando il prefisso della tua città (serve un numero italiano dedicato al servizio): se non sai dove cliccare, te lo mostriamo.
  3. Ottenuto il numero, la registrazione per WhatsApp Business (WABA) con Meta la seguiamo noi insieme a te (team Mattone), non da solo.
  4. Poi lo colleghiamo a un Business Manager Facebook (meglio nuovo): se ti serve, ti guidiamo a crearlo.
  5. Tienilo presente: lo stesso numero italiano varrà per WhatsApp, chiamate e come riferimento sugli annunci OTA.
Da dire chiaro: “Il numero lo richiedi tu dal portale Conduit; la registrazione ufficiale con Meta la facciamo insieme. È il tuo numero ufficiale verso gli ospiti: ci vuole circa una settimana, per questo partiamo subito.”Prerequisiti da chiedere allo studente in anticipo: un numero non già usato su WhatsApp (personale o business), accesso a Facebook Business Manager come amministratore, e un documento aziendale (es. visura) per la verifica Meta.
Apri il ticket al supporto Conduit appena hai completato la KB e i tool, in questo modo quando il canale è pronto, il workspace è già configurato correttamente.→ Guida dettagliata: Telefonia e WABA
Per la documentazione completa dell’integrazione Conduit, architettura del workspace, limiti, gestione degli errori e best practice, consulta Conduit · Panoramica.
Step completato? Procedi con → Step 4 · Smart check-in
▷ Prompt Claude Code: Monta l’agente Conduit · incolla in Claude Code:

Provisioning (piattaforma)

Sezione AI / provisioning studente

Dashboard Conduit

Workspace dell’agente (KB, tool, skill, voice)