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, costi a consumo, durata 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.
Due errori già successi in provisioning, entrambi nostri: un dato vero di un ospite usato come esempio in una description, e il token del cliente scritto in chiaro nel codice del tool. Prima di dichiarare il passo chiuso, leggi Due errori di provisioning da non ripetere.
→ 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

Canale email = messaggi Booking.com (OBBLIGATORIO se vende su Booking)

Booking.com non ha API messaggi: gli ospiti passano solo via email. Se la casella dell’Extranet Booking non è collegata al workspace, l’agente non vede nessun messaggio Booking — mentre le prenotazioni continuano ad arrivare dal PMS.È lo step che si rompe più spesso e in silenzio: il cliente le mail le riceve nella sua casella e risponde a mano, quindi nessuno si accorge di niente. Su Kross, Booking è tipicamente il 20-25% delle prenotazioni.
  1. Chiedi qual è l’indirizzo email vero registrato nell’Extranet Booking (non dedurlo dal dominio, non dare per buono quello già in Conduit).
  2. Se è Gmail o Google Workspace → Settings → Connected Channels → Email → Add Gmail account. È la strada da preferire: niente inoltri, niente DNS.
  3. Altrimenti → inoltro verso l’indirizzo ...@inbound.postmarkapp.com che trovi in Settings → Email → dominio → “3. Receiving emails”.
  4. Verifica sui dati, non sulla spunta: la casella “Inbound email forwarding is set up” è auto-dichiarata e non prova nulla. Devono esistere conversazioni unthreaded_email da booking.com e conversazioni booking_com con messaggi reali.
  5. Nell’Extranet Booking, sotto Struttura → Preferenze messaggi, verifica che sia attivo il flag “ricevi un’email per ogni messaggio inviato dagli ospiti”. Se è spento, Booking non manda nessuna email indipendentemente da quanto è ben collegato il canale in Conduit — è la causa più facile da dimenticare perché da fuori sembra un problema di collegamento.
→ Procedura completa, trappole e checklist: Canale email · messaggi Booking.com
5

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 → avvia la richiesta dandoci il prefisso della propria città (numero italiano dedicato); il team Mattone la sottomette a Conduit support e ne segue la pratica, come in Telefonia & WABA.
  • 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.
Due numeri, due ruoli:
  • backend = il numero del voice agent (americano). È fisso, non cambia mai, l’ospite non lo vede.
  • frontend = un solo numero italiano per chiamate e WhatsApp, quello che vede l’ospite (annunci OTA compresi).
  • Il frontend inoltra le chiamate al backend, da subito, anche prima che WhatsApp sia collegato. Se un giorno il frontend cambia, lato voce si cambia solo l’inoltro.
→ Numero backend e numero frontend → Come si configura il voice agent (trovare prenotazione e appartamento al telefono, 4 chiamate di prova): Voice agent: il setup canonico
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. Dacci il prefisso della tua città e conferma che vuoi partire: la richiesta del numero la sottomettiamo noi a Conduit (serve un numero italiano dedicato al servizio).
  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.Prima di chiudere lo step: niente si perde. Da un telefono del team, sul numero frontend:
  1. chiamata → risponde il voice agent, e chiedendo una persona squilla il referente;
  2. messaggio WhatsApp → risponde l’agente;
  3. una richiesta da passare a una persona → l’escalation arriva al canale giusto.
Se uno dei tre non va, il canale non è pronto. Dettaglio e cosa guardare: Verifica finale dei canali.→ 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)