Horeca Inbox

Il problema: le richieste dirette restano ferme mentre le OTA rispondono subito

Un ristorante o un hotel riceve richieste da canali diversi: un messaggio WhatsApp la sera, un'email per un catering, un modulo compilato sul sito. Chi le gestisce è spesso lo stesso titolare, in servizio. Ogni ora di attesa è una prenotazione che rischia di passare da un portale, con la sua commissione, o di non arrivare affatto.

• Tre canali da controllare, nessuna vista unica sulle richieste
• Risposte che arrivano ore dopo, quando il cliente ha già scelto altrove
• Richieste vaghe che richiedono comunque un giro di domande prima del preventivo
• Le prenotazioni dirette valgono margine pieno, quelle da portale no

La soluzione: tre ingressi, un motore solo, risposta sul canale di origine

Ogni canale ha un solo compito: prendere quello che arriva e scriverlo in una tabella unica. Il motore legge la richiesta, la classifica e individua i dati mancanti in base alla configurazione dell'attività, poi risponde sul canale da cui è arrivata. Non promette disponibilità né prezzi: prende in carico e chiede quello che serve, così non dice mai il falso.

• Ingressi separati per WhatsApp (webhook Meta con verifica della firma), email (lettura IMAP) e modulo web
• Motore basato su Claude con output strutturato validato da Zod: categoria, campi presenti e campi mancanti
• Risposta generata sul caso specifico, non un template statico
• Notifica push al titolare via ntfy a ogni nuova richiesta
• Categorie e campi configurabili per attività: un nuovo settore è configurazione, non codice nuovo
• Ciclo di elaborazione con tentativi e isolamento degli errori: un messaggio che fallisce non blocca gli altri
• Suite di test automatici con Vitest su motore, canali, scheduler e uscita

Competenze dimostrate

• Integrazione di canali eterogenei (webhook, IMAP, form) dietro un unico formato dati
• Uso di un LLM con output strutturato e validato, non testo libero
• Progettazione prudente del comportamento: nessuna promessa che il sistema non può mantenere
• Architettura Nuxt/Nitro come hub unico, senza orchestratori esterni nel percorso critico
• Gestione di errori e tentativi su code di messaggi reali
• Lettura del problema dal lato di chi gestisce un locale, non solo dal lato tecnico

Come questo approccio può aiutare un team

Il motore non sa da quale canale arriva la richiesta né di che settore è l'attività: categorie e campi da raccogliere stanno in configurazione. Lo stesso sistema si adatta a qualunque attività che riceve richieste dirette da più canali.

• Agenzie immobiliari che ricevono richieste di visita da portali, email e WhatsApp
• Studi professionali con richieste di appuntamento da più canali
• Strutture ricettive che vogliono ridurre la dipendenza dalle OTA
• Agenzie che gestiscono la comunicazione di più locali e vogliono un sistema replicabile