Skip to main content
Per collegare l’account KrossBooking di uno studente alla piattaforma Mattone, hai bisogno di tre credenziali che lo studente recupera direttamente dal proprio portale Kross. Segui questi passaggi nell’ordine indicato: saltare o invertire uno step è la causa più frequente di errori di connessione.

​
Prerequisiti

Prima di iniziare, assicurati che:
  • L’anagrafica dello studente su Notion sia completa e approvata
  • Lo studente abbia accesso al proprio portale KrossBooking con permessi di amministratore
  • Lo studente ti abbia fornito, su canale sicuro, le seguenti informazioni dalla sezione API del portale Kross:
    • hotel_id, identificativo numerico della struttura
    • username, nome utente API (distinto dal login web)
    • password, password API associata all’utente

​
Step

1

Lo studente recupera le credenziali API da Kross

Lo studente accede al proprio portale KrossBooking, naviga nella sezione API (o Impostazioni → Integrazioni) e copia i tre valori: hotel_id, username e password. Se la sezione API non è visibile, lo studente deve contattare il supporto Kross per abilitarla.
2

Inserisci le credenziali nell'Admin di Mattone

Accedi all’Admin della piattaforma Mattone. Vai in Connessioni → Collega Kross, inserisci i tre valori ricevuti dallo studente e salva. Il sistema cifra automaticamente le credenziali e le archivia nel Vault, non vengono mai memorizzate in chiaro.
3

Il sistema verifica la connessione via gateway

Dopo il salvataggio, la piattaforma esegue automaticamente un test di connessione passando per mcp.mattone.co. Attendi che il risultato appaia nell’interfaccia: il processo richiede normalmente meno di 10 secondi.
4

Verde: le 3 credenziali sono salvate (cred_secret_id)

Stato verde = la connessione è attiva e le 3 credenziali sono state scritte cifrate (cred_secret_id) nel Vault. Non devi creare nessuna chiave manuale: la chiave generica partner è già nostra e il gateway la usa in automatico.
5

🚀 Provision: monta gli strumenti dell'assistente

Premi Provision per lo studente: la piattaforma monta gli strumenti dell’assistente per Kross (le “custom tool”) con le loro istruzioni (skill) nello spazio Conduit dello studente. Da qui l’assistente sa parlare con Kross.
6

Fatto: l'assistente recupera le 3 credenziali da solo

Quando l’assistente usa uno strumento, il nostro ponte mcp.mattone.co recupera le 3 credenziali dal Vault mentre lavora (chiave generica + proxy con IP autorizzato) e chiama Kross. Nessun passaggio manuale ulteriore. Verifica con una domanda reale (es. una prenotazione) che tornino dati veri.
Se il test è rosso, la causa quasi sempre sono le 3 credenziali (sbagliate, o hotel_id che non corrisponde). Rigenerale dal portale Kross e ri-salva. Dettaglio: Troubleshooting.

​
Procedura partner ripetibile (template)

Questa è la strada funzionante end-to-end per collegare un nuovo partner Kross, provata su HostManager360 (agente live che legge 13 ospiti reali). Replicala per il prossimo partner:
1

Mattia contatta Kross per la partnership

L’AM avvia la partnership con Kross e recupera l’accesso al portale partner del cliente (dove compaiono le 3 credenziali).
2

Recupera le 3 credenziali

Dal portale partner → sezione API: hotel_id, username (apiNNNNN), password API del cliente.
3

Collega Kross

Admin → Collega Kross → incolla le 3 credenziali → verde (scrive cred_secret_id nel Vault).
4

Provision

🚀 monta tool + skill sul workspace Conduit dello studente.
5

Personalizza le skill policy

Sostituisci i dati Cosmica (numeri reperibili, fee, link portale/email) con quelli dello studente nelle skill policy.
6

KB Notion & telefonia, se servono

Se lo studente ha il registro Notion → genera la KB per-listing (bridge). Se vuole voce/WhatsApp → configura telefonia/WABA.
7

Test end-to-end reale

Ospite realmente presente in Kross → l’agente trova la prenotazione e dà i dati corretti.
Le credenziali Kross (hotel_id, username, password) devono essere inviate esclusivamente su canale sicuro, mai in una chat di gruppo, email, o documento condiviso. Una volta ricevute, salvale immediatamente nel Vault ed elimina qualsiasi copia temporanea. L’esposizione di queste credenziali può compromettere l’intera operatività della struttura dello studente.

​
Verifica della connessione

Una connessione riuscita si riconosce da questi segnali:
  • Lo stato nella scheda studente mostra “Kross: connesso” con indicatore verde
  • Conduit è in grado di recuperare almeno una prenotazione dalla struttura (puoi verificarlo dalla sezione Debug → Ultime prenotazioni nell’Admin)
  • Non sono presenti errori 401 nei log di sistema relativi a quel hotel_id
Se tutti e tre i segnali sono presenti, l’integrazione è operativa e puoi procedere con gli step successivi dell’onboarding.
▷ Prompt Claude Code: Collega Kross per uno studente · incolla in Claude Code:

Collega Kross (piattaforma)

Inserisci le 3 credenziali (cifrate nel Vault)

Portale KrossBooking → API

Sezione API → credenziali del cliente