Skip to main content
Il bridge trasforma automaticamente i record del DB Apartments in Notion in cartelle KB per-listing all’interno di Conduit, garantendo che la conoscenza dell’AI su ogni appartamento sia sempre aggiornata e correttamente isolata dagli altri listing. Non è necessario aprire Conduit per modificare manualmente gli articoli: ogni aggiornamento in Notion si propaga alla KB nel giro di pochi minuti.

​
Come funziona il bridge

Il processo di sincronizzazione si svolge in quattro fasi automatiche:
  1. Lettura del DB Notion: La piattaforma Mattone legge il DB Apartments tramite l’API Notion (autenticata via OAuth). Vengono presi in considerazione solo gli appartamenti con il campo Attivo spuntato.
  2. Creazione o aggiornamento della cartella KB: Per ogni appartamento, il bridge crea (o aggiorna) una cartella KB in Conduit con la proprietà entity_ids: [listing_id]. Questa proprietà è il meccanismo di scope che associa la cartella a uno specifico listing nel PMS.
  3. Popolamento degli articoli KB: Il bridge genera automaticamente gli articoli all’interno della cartella: istruzioni di accesso, credenziali WiFi, regole della casa, listino. Il contenuto viene estratto dai campi del record Notion.
  4. Scope per-listing: L’isolamento è applicato a livello di cartella, non di singolo articolo. Ogni ospite che interagisce con Conduit riceve solo le informazioni relative al proprio listing, senza rischio di contaminazione tra appartamenti diversi.

​
Quando si aggiorna

Il bridge si aggiorna in due modi:
  • Su evento webhook: Ogni volta che un record del DB Apartments viene modificato in Notion, Notion invia un webhook alla piattaforma Mattone che avvia immediatamente la sincronizzazione. Le modifiche si propagano alla KB entro 2–5 minuti.
  • Sincronizzazione periodica: Il bridge esegue comunque una sincronizzazione completa con cadenza regolare, come rete di sicurezza nel caso in cui un webhook non venga ricevuto.

​
Come verificarlo

Dopo una modifica in Notion, usa questa procedura per confermare che il bridge abbia sincronizzato correttamente i dati.
1

Apporta una modifica riconoscibile a un appartamento in Notion

Apri il DB Apartments e cambia un valore facile da verificare in seguito, per esempio aggiorna la password WiFi nelle Note accesso di un appartamento specifico.
2

Attendi 2–3 minuti

Il bridge rileva la modifica via webhook e aggiorna la KB di Conduit. Se il webhook non è attivo, potrebbe volerci fino alla prossima sincronizzazione periodica (vedi Troubleshooting).
3

Interroga Conduit sul WiFi di quell'appartamento

Apri Conduit e poni una domanda sul WiFi dell’appartamento modificato, simulando la conversazione di un ospite. Per esempio: “Qual è la password del WiFi?”
4

Verifica che la risposta rifletta il nuovo valore

Conduit deve rispondere con la password aggiornata, non con quella precedente. Se riporta il vecchio valore, la sincronizzazione non è avvenuta, vai alla sezione Troubleshooting.
5

Esegui l'anti-leak check su un appartamento diverso

Ripeti la stessa domanda simulando un ospite di un appartamento diverso. Conduit deve rispondere con i dati del secondo appartamento, non con quelli del primo. Questo verifica che lo scope per-listing funzioni correttamente e che non ci sia contaminazione tra listing.
Se il listing_id nel DB Notion non corrisponde a quello in KrossBooking, il bridge crea cartelle KB con uno scope errato: le informazioni non vengono consegnate all’ospite giusto, oppure le cartelle rimangono disconnesse da qualsiasi prenotazione. Verifica sempre l’allineamento del listing_id prima di dichiarare il setup completato.
Caso test del bridge = HostManager360. È il primo partner Kross live (agente che legge 13 ospiti reali) e il caso su cui si valida il bridge Notion↔Conduit end-to-end per un cliente reale, oltre a Cosmica. Da qui si estrae il pattern ripetibile per gli altri partner.
Il bridge è un componente interno della piattaforma Mattone, non è necessario configurarlo manualmente. In caso di sincronizzazione rotta o anomalie, consulta la pagina Troubleshooting Notion per la diagnosi e la risoluzione.