Skip to main content
Quando un ospite chiede di posticipare il check-out o anticipare il check-in, Conduit verifica in automatico se lo slot è libero e, in caso affermativo, recupera la tariffa dal listino in KB e genera un link di pagamento Stripe da inviare direttamente in chat. Questo playbook spiega quando il flusso si completa senza intervento umano e quando invece il team deve intervenire per sbloccare la situazione.

​
Quando si attiva

Il flusso si attiva ogni volta che un ospite invia via WhatsApp o chat una richiesta come:
  • Late check-out: vuole lasciare l’appartamento più tardi del previsto (es. alle 13:00 invece delle 11:00)
  • Early check-in: vuole entrare prima dell’orario standard (es. alle 12:00 invece delle 15:00)
Conduit intercetta queste richieste grazie alle sue skill di comprensione del linguaggio naturale: non è necessario che l’ospite usi termini tecnici, anche una frase come “posso restare un po’ di più?” viene riconosciuta correttamente.

​
Cosa fa il sistema (in ordine)

Il flusso automatico si sviluppa in quattro passaggi sequenziali:
  1. Verifica disponibilità: Conduit chiama il tool check-availability per controllare se tra il check-out dell’ospite attuale e il prossimo check-in c’è una finestra libera sufficiente (es. almeno 2 ore per il late check-out).
  2. Recupero tariffa: Se lo slot è libero, Conduit consulta la KB del listino dello studente (filtrata per listing_id) per trovare la tariffa applicabile al servizio richiesto.
  3. Generazione link Stripe: Conduit usa il tool stripe-payment-link per creare un link di pagamento con l’importo corretto e lo invia all’ospite direttamente in chat.
  4. Notifica al team pulizie: Alla conferma del pagamento (o in alcuni flussi subito dopo la generazione del link), Conduit attiva il workflow configurato e invia un messaggio al canale Slack del team pulizie tramite SEND_SLACK_MESSAGE, avvisandoli del nuovo orario.
Il passaggio 4, la notifica al team pulizie, è condizionato alla corretta configurazione del workflow. Se il workflow non è attivo o il canale Slack non è impostato, il pagamento viene incassato ma il team non viene avvisato. Controlla sempre questa parte durante l’onboarding di un nuovo studente.

​
Quando interviene il team

Se il flusso automatico si inceppa, segui questi passaggi nell’ordine in cui si presentano:
1

Conduit dice 'non posso verificare la disponibilità'

Il tool check-availability potrebbe essere assente o privo della skill associata. Vai nella configurazione di Conduit per quell’agente, verifica che il tool sia presente nell’elenco degli strumenti abilitati e che la skill corrispondente sia attiva. Controlla anche che il listing_id usato dal tool sia quello corretto per quell’appartamento.
2

Conduit fornisce una tariffa errata

La KB del listino potrebbe essere obsoleta o non correttamente scopata al listing_id del listing. Accedi alla KB dello studente, verifica che il documento del listino sia aggiornato con le tariffe correnti e che sia taggato con il listing_id giusto, una KB globale senza scope rischia di restituire prezzi di un altro appartamento.
3

L'ospite ha pagato ma il team pulizie non è stato notificato

Il workflow di notifica potrebbe essere disattivo o mal configurato. Verifica che il workflow “late check-out / early check-in notification” sia in stato attivo, che il canale Slack di destinazione esista e che il bot Mattone abbia i permessi per scriverci. Se necessario, invia manualmente la notifica al team pulizie e poi correggi la configurazione per evitare che si ripeta.

​
Verifiche rapide

Prima di escalare un problema a un tecnico, esegui questa checklist:

Tool check-availability

Il tool è presente nell’agente e ha una skill attiva? Il listing_id è corretto?

KB listino aggiornata

La KB contiene il listino aggiornato? È scopata per listing_id e non globale?

Workflow notifica attivo

Il workflow late check-out è attivo? Il canale Slack è configurato e raggiungibile?
Se lo slot è oggettivamente libero (nessun check-in o check-out nelle ore adiacenti in KrossBooking) ma Conduit risponde che non è disponibile, il problema è quasi sempre nella skill check-availability: potrebbe essere disabilitata oppure usare un listing_id diverso da quello della prenotazione. Aprila, controlla il parametro listing_id e verifica che la skill sia nello stato “attivo”.
▷ Prompt Claude Code: Late/Early check-in autonomo · incolla in Claude Code:

Conduit, Workflow

Schema e step del flusso

Guardrail (eccezione-listino)

Come autorizzare la vendita