Skip to main content
Usa questa guida per diagnosticare i problemi dell’integrazione Notion. I casi più frequenti sono la connessione OAuth revocata o scaduta e il disallineamento del listing_id tra il DB Notion e KrossBooking, due situazioni che bloccano la sincronizzazione in modo silenzioso, senza errori evidenti.

​
Tabella di diagnosi

​
Approfondimenti per caso

Se lo studente ha revocato l’accesso da Notion o il token è scaduto, la connessione risulterà rossa o arancione in piattaforma. Segui questi passaggi:
  1. Vai su Connessioni → Notion nella piattaforma Mattone.
  2. Clicca su Scollega per rimuovere il token precedente.
  3. Clicca su Collega e ripeti il flusso OAuth completo.
  4. Durante l’autorizzazione, assicurati che lo studente selezioni il DB Apartments.
  5. Verifica che lo stato torni verde e che il DB sia visibile.
Un listing_id sbagliato non produce errori evidenti, il bridge sincronizza comunque, ma con lo scope errato. I sintomi sono: Conduit risponde con le informazioni dell’appartamento A quando dovrebbe rispondere su B, oppure le cartelle KB appaiono vuote.Per verificare:
  1. Apri KrossBooking → Strutture e nota l’ID nell’URL di ogni appartamento.
  2. Confronta ogni ID con il listing_id nel DB Notion.
  3. Correggi eventuali discrepanze direttamente nel DB Notion.
  4. Forza una sincronizzazione manuale dalla piattaforma Mattone.
Se il sync è ritardato di più di 10 minuti dopo una modifica in Notion, il webhook potrebbe non essere attivo:
  1. Vai su Piattaforma Mattone → Impostazioni → Webhook Notion.
  2. Verifica che l’URL webhook sia registrato e che lo stato sia Attivo.
  3. Se lo stato è Inattivo, clicca su Ri-registra webhook.
  4. Testa la sincronizzazione apportando una modifica in Notion e verificando l’aggiornamento in Conduit entro 2–3 minuti.
Per un check rapido dello stato del bridge senza dover fare test su Conduit, vai su Piattaforma Mattone → Connessioni → Notion: trovi la data e l’ora dell’ultima sincronizzazione riuscita, l’eventuale messaggio di errore e il pulsante per forzare un sync manuale.
▷ Prompt Claude Code: Debug Notion / bridge · incolla in Claude Code:

Bridge → Conduit KB

Come funziona il bridge

DB Apartments

Allineamento nomi al PMS