> ## Documentation Index > Fetch the complete documentation index at: https://docs.mattone.co/llms.txt > Use this file to discover all available pages before exploring further. # Playbook: vendita di extra e upsell via Conduit e Stripe > Gestisci la vendita di servizi extra tramite Conduit: dalla ricerca del prezzo in KB alla generazione del link Stripe e alla conferma dell'ospite. Quando un ospite richiede un servizio aggiuntivo, un trasferimento in aeroporto, una pulizia extra, la colazione, il parcheggio o qualsiasi altro extra previsto dallo studente, Conduit cerca il prezzo nella KB del listino, genera un link di pagamento Stripe con l'importo corretto e lo invia direttamente in chat. Questo playbook copre l'intero flusso automatico, spiega come intervenire quando qualcosa non funziona e fornisce un catalogo di riferimento dei servizi extra più comuni. ## Quando si attiva Il flusso si attiva ogni volta che un ospite chiede, tramite WhatsApp o chat, un servizio soggetto a pagamento separato: * Durante il soggiorno (es. "posso avere una pulizia extra domani?") * Prima dell'arrivo (es. "è possibile prenotare il trasferimento dall'aeroporto?") * In fase di check-in (es. "c'è il parcheggio disponibile?") Conduit riconosce la richiesta anche in linguaggio colloquiale e la abbina al servizio corrispondente nel catalogo della KB. ## Cosa fa il sistema (in ordine) Il flusso automatico si svolge in cinque passaggi: 1. **Ricezione della richiesta**: L'ospite chiede un extra via chat; Conduit classifica la richiesta e identifica il servizio. 2. **Ricerca prezzo in KB**: Conduit interroga la KB del listino dello studente, filtrando per `listing_id`, per trovare il prezzo del servizio richiesto. 3. **Generazione link Stripe**: Conduit chiama il tool `stripe-payment-link` passando il nome del servizio e l'importo recuperato dalla KB, ottenendo un link univoco. 4. **Invio all'ospite**: Conduit invia il link direttamente in chat con un messaggio esplicativo (es. "Ecco il link per procedere al pagamento della pulizia extra: \[link]"). 5. **Conferma post-pagamento**: Se il webhook Stripe è configurato, alla ricezione del pagamento Conduit invia all'ospite un messaggio di conferma e, se previsto dal workflow, notifica il fornitore del servizio. Il webhook Stripe non è configurato di default su ogni installazione. Se l'ospite paga ma non riceve conferma, è molto probabile che il webhook manchi. Vedi la sezione "Quando interviene il team" per i dettagli. ## Quando interviene il team La KB del listino è mancante o non è scopata correttamente al `listing_id` di quell'appartamento. Accedi alla sezione KB dello studente, verifica che esista un documento listino e che contenga il servizio richiesto. Se il documento c'è ma il prezzo non viene trovato, controlla che il tag `listing_id` del documento corrisponda a quello della prenotazione. Il tool `stripe-payment-link` è assente o la skill non è attiva per quell'agente. Vai nella configurazione dell'agente Conduit, verifica che il tool sia nell'elenco degli strumenti abilitati e che la skill corrispondente sia in stato attivo. Controlla anche che le credenziali Stripe dello studente (API key) siano collegate correttamente. Il valore nella KB del listino non è aggiornato. Apri il documento listino nella KB dello studente, correggi il prezzo del servizio e salva. Chiedi all'ospite di ignorare il link precedente e genera un nuovo link dalla dashboard o chiedi a Conduit di ripetere l'operazione. Il webhook Stripe non è configurato o non è raggiungibile. Verifica nella dashboard Stripe che l'endpoint webhook sia impostato per quell'account e che sia attivo. Se il webhook non è mai stato configurato, seguire la procedura di setup webhook nella documentazione di integrazione Stripe. ## Catalogo extra tipici La tabella seguente riporta i servizi extra più comuni nelle strutture gestite su Mattone, con prezzi indicativi e note operative. Aggiorna il listino in KB con i valori reali dello studente. | Extra | Prezzo indicativo | Note | | ------------------------------- | ----------------- | -------------------------------------------------------------------------- | | Trasferimento aeroporto (A/R) | €35–€60 a tratta | Dipende dalla distanza e dal fornitore; richiede coordinamento con terzi | | Pulizia extra | €40–€80 | Variabile in base alla metratura; notifica il team pulizie via workflow | | Colazione in appartamento | €15–€25 a persona | Richiede fornitore locale abilitato; non sempre disponibile | | Late check-out (fino a 2h) | €20–€40 | Subordinato alla disponibilità verificata con `check-availability` | | Early check-in (fino a 2h) | €20–€40 | Come sopra; verificare sempre disponibilità | | Parcheggio privato | €10–€20 al giorno | Solo se la struttura dispone di posto auto; aggiungere alla KB per listing | | Kit di benvenuto personalizzato | €25–€50 | Composizione variabile; accordarsi con lo studente in fase di onboarding | La KB del listino **deve essere scopata per `listing_id`**: una KB globale (non filtrata per appartamento) causa a Conduit di restituire prezzi errati, appartenenti ad altri listing dello stesso studente. Verifica sempre che ogni documento listino abbia il tag `listing_id` corretto prima di attivare il flusso upsell su un nuovo appartamento. Se uno studente gestisce più appartamenti con prezzi diversi, crea un documento listino separato per ciascun `listing_id` invece di un unico documento generico. Questo garantisce che Conduit mostri sempre il prezzo corretto per l'appartamento in cui si trova l'ospite. **▷ Prompt Claude Code: Configura extra/upsell** · incolla in Claude Code: ```text theme={null} Contesto: in questa sessione di Claude Code NON hai il repo/codice caricato. Per prima cosa apri il repo `~/Projects/api-kross-mattone` (conduit-custom-tool: check-availability, tool stripe, catalog.json + skill payment-link-generator) e LEGGI la pagina mattone-docs /casistiche/extra-upsell; per KB/guardrail/test usa l'MCP Conduit. Poi procedi: Aiutami a configurare la vendita di extra/upsell per [studente/Cosmica] seguendo mattone-docs /casistiche/extra-upsell. Compila il Listino nella KB del listing col template (voce, categoria A/B, prezzo, valuta, slot-dependent, condizioni). Verifica: voci categoria A -> check-availability montato; guardrail eccezione-listino aggiornato in-place; skill payment-link-generator montata. Poi testa 3 casi: (a) extra a listino -> link con causale corretta; (b) early/late con slot occupato -> escala; (c) voce non a listino -> escala, non inventa. ``` Attivazione tool + test Autorizzare la quotazione