Skip to main content
Collega KrossBooking così che Conduit possa leggere le prenotazioni, i dati degli ospiti e lo stato del check-in per tutti gli appartamenti dello studente. Senza questa connessione attiva e verde, l’agente AI non ha accesso alle informazioni sulle prenotazioni e non può svolgere il suo lavoro. Completa questo step solo dopo aver finito l’anagrafica Notion.
Le credenziali Kross non vanno mai condivise in chat, richiedile allo studente tramite canale sicuro e salvale immediatamente nel Vault. Non tenerle in chiaro in nessun altro posto.

​
Prerequisiti

  • Step 1 · Anagrafica & Notion completato: il DB Apartments è allineato e tutti i listing_id sono valorizzati
  • Dallo studente hai ricevuto tramite canale sicuro:
    • hotel_id: identificativo dell’hotel/struttura nel portale Kross
    • Username API: credenziale di accesso alle API (diversa dallo username del portale web)
    • Password API: ottenibile dal portale KrossBooking nella sezione API

​
Step (in ordine)

1

Inserisci le credenziali nella piattaforma Mattone

Dalla piattaforma Mattone, apri il pannello Admin → Collega Kross per lo studente in questione. Inserisci i tre valori ricevuti:
  • hotel_id
  • Username API
  • Password API
Premi Salva. Le credenziali vengono cifrate e archiviate nel Vault, non vengono mai mostrate in chiaro dopo il salvataggio.
2

Verifica il test di connessione

Dopo il salvataggio, il sistema esegue automaticamente un test di connessione attraverso il gateway mcp.mattone.co. Attendi il risultato:
  • Verde ✅, le 3 credenziali sono salvate cifrate (cred_secret_id) nel Vault. Non serve creare nessuna chiave manuale: la chiave generica partner è già nostra. Gli strumenti dell’assistente si montano nello Step 3 · Conduit col bottone Provision; da lì il nostro ponte mcp.mattone.co recupera le 3 credenziali quando l’assistente lavora. Procedi.
  • Rosso ❌, la connessione ha fallito. Vedi la sezione qui sotto.
3

In caso di esito rosso: diagnostica

Se il test restituisce rosso, non procedere allo step successivo. Controlla in quest’ordine:
  1. Le credenziali sono quelle API (non quelle del portale web)
  2. L’hotel_id è corretto, lo studente a volte confonde l’ID hotel con l’ID catena
  3. L’account API è abilitato nel portale Kross (alcuni account hanno le API disattivate di default)
Per una guida completa alla diagnostica, consulta Kross · Troubleshooting.

​
Verifica

Questo step è completo quando:
  • Il test di connessione via mcp.mattone.co restituisce verde
  • Da un pannello di test, Conduit riesce a recuperare almeno una prenotazione reale per lo studente (anche storica)
Per la documentazione completa dell’integrazione KrossBooking, endpoint disponibili, scope delle API, limiti di frequenza e casi limite, consulta Kross · Panoramica.
Step completato? Procedi con → Step 3 · Conduit
▷ Prompt Claude Code: Collega Kross · incolla in Claude Code:

Collega Kross (piattaforma)

Inserisci le 3 credenziali (cifrate nel Vault)

Portale KrossBooking → API

Da qui lo studente prende hotel_id / username / password