Integrazione e distribuzione

L'Agent non vive solo nella dashboard di Hotely: deve essere distribuito sui canali dove i tuoi ospiti ti incontrano. Il sito web della struttura, le pagine social, le brochure stampate, le firme email, i menu del ristorante, le camere dell'hotel. Ogni punto di contatto fisico o digitale può diventare un canale di accesso all'Agent.

Hotely offre quattro modi principali di integrazione, ciascuno ottimizzato per uno scenario specifico. Tutti funzionano con qualsiasi tipo di sito e non richiedono competenze tecniche.

I quattro canali di integrazione

A questi si aggiungono i canali avanzati che meritano sezioni dedicate:

• Voce telefonica — l'Agent risponde al telefono (Segreteria telefonica)
• WhatsApp Business — l'Agent risponde su WhatsApp (WhatsApp)
• Email integrazione — l'Agent gestisce le email (Email)

Widget JavaScript sul sito

Il widget JavaScript è la modalità più comune. Si installa con una sola riga di codice che incolli nel template del sito. Funziona con:

• WordPress (con o senza plugin)
• Wix
• Squarespace
• Shopify
• Webflow
• Joomla
• Drupal
• Siti custom in HTML/JavaScript
• Siti generati da Website Builder di Hotely (integrazione automatica)

Una volta installato, il widget appare come una bolla circolare in basso a destra di ogni pagina del sito. Cliccandola si apre la finestra chat con il welcome screen o direttamente la conversazione.

Per la guida dettagliata sull'installazione, configurazione e troubleshooting vedi Widget JavaScript.

Link condivisibile

Ogni Agent ha un URL pubblico dedicato dove vive autonomamente, senza bisogno di un sito che lo ospiti. L'URL è del formato:

• tuo-slug.hotely.ai — versione standard
• hotely.ai/tuo-slug — versione alternativa
• Tuo dominio personalizzato — se configurato

Il link condivisibile è utile per:

• Email — inserire il link nelle firme email o nelle comunicazioni ai clienti
• Social media — link in bio Instagram, post Facebook, profili LinkedIn
• Schede contatto — Google Business Profile, TripAdvisor, profilo Booking
• Stampa cartacea — biglietti da visita, brochure, menu cartacei
• SMS e WhatsApp — link inviato direttamente al cliente
• QR code — qualsiasi superficie fisica con un QR che porta al link

L'URL apre una pagina chat a tutto schermo, ottimizzata sia per mobile sia per desktop. È la stessa esperienza del widget ma a piena pagina.

Dominio personalizzato

Per le strutture che vogliono coerenza di brand totale, puoi configurare un dominio personalizzato (es. chat.hotelbellavista.it). Il dominio si configura una volta e l'URL diventa quello che condividi ai clienti.

iFrame

L'iFrame permette di incorporare la chat direttamente nella pagina del sito come elemento integrato — non come bolla esterna ma come componente della pagina.

Casi tipici di uso:

• Pagina "Contatti" — sostituire o affiancare il form di contatto con la chat
• Pagina "Aiuto" / "FAQ" — l'Agent risponde direttamente alle domande
• Pagina "Prenotazioni" — la chat assiste nel processo di prenotazione
• Landing page dedicate — campagne mirate con chat sempre aperta
• Sezioni del sito mobile — la chat è sempre visibile

Tecnicamente è una riga HTML (<iframe>) con l'URL dell'Agent. Si configura dimensione (altezza, larghezza) e responsive.

QR code per spazi fisici

I QR code sono il canale per portare i clienti dalla realtà fisica alla chat digitale. Hotely genera automaticamente QR code per:

• Agent principale — un QR per la chat generale
• Singola camera — un QR per ogni camera della struttura
• Singolo tavolo — un QR per ogni tavolo del ristorante
• Ombrellone / cabane — per resort balneari
• Postazione spa — per attività wellness
• Punto vendita / banco — per ristoranti con asporto

Quando un cliente inquadra il QR, atterra direttamente nella chat con il contesto già caricato — sa già che è alla camera 305, al tavolo 12, all'ombrellone 47.

Per la guida dettagliata vedi QR code.

Integrazioni terze parti

Oltre ai canali di distribuzione, Hotely supporta integrazioni con sistemi esterni per arricchire l'esperienza:

Le integrazioni si configurano dalla scheda Integrazioni dell'Agent. Per ciascuna serve tipicamente:

• Account attivo sulla piattaforma esterna
• Token o credenziali di accesso (forniti dalla piattaforma)
• Configurazione di mapping campi (es. quali dati sincronizzare)

Pubblicare l'Agent: ordine consigliato

Il flusso di pubblicazione tipico per una nuova struttura:

1. Configura il widget sul sito principale — è il canale con più traffico tipico
2. Verifica con conversazioni di prova — apri il sito in incognito e prova
3. Aggiungi il link nella firma email — ogni email che invii diventa un canale
4. Crea i QR code per camere/tavoli (se applicabile) — stampa e applica
5. Configura la voce telefonica (se serve) — per intercettare le chiamate
6. Connetti WhatsApp Business (se serve) — per il canale messaging
7. Crea pagine dedicate con iFrame (es. "Aiuto") — esperienza di assistenza dedicata

Non tutti i canali devono essere attivati subito. Il widget e il link sono i due fondamentali — gli altri si aggiungono progressivamente quando ne vedi il bisogno.

Verifica e test della pubblicazione

Dopo aver pubblicato l'Agent, è essenziale verificare l'effettivo funzionamento:

Test sul sito

• Apri il sito in finestra di navigazione anonima (per non usare cookie di test)
• Verifica che la bolla appaia in basso a destra
• Clicca e verifica che si apra il welcome screen corretto
• Fai una conversazione di prova con domande tipiche
• Verifica su mobile reale, non solo emulazione desktop

Test del link

• Apri il link condivisibile in browser anonimo
• Verifica che la pagina si carichi correttamente
• Prova su mobile e desktop
• Verifica la velocità di caricamento

Test dei QR code

• Stampa un QR di prova (es. tavolo 1)
• Inquadralo con uno smartphone
• Verifica che apra la chat con il contesto giusto
• Prova con diversi smartphone (Android, iOS)

Test multilingua

• Cambia la lingua del browser
• Apri la chat e verifica che parli nella lingua del browser

Aggiornamenti senza ripubblicazione

Tutte le configurazioni dell'Agent (contenuti, design, comportamento) si aggiornano dalla dashboard. Le modifiche entrano in vigore istantaneamente — non devi ripubblicare il widget o toccare il sito.

Questo significa che:

• Puoi aggiornare il menu di un ristorante e tutti i visitatori vedono subito il menu nuovo
• Puoi cambiare colori del welcome screen e tutti vedono la nuova versione
• Puoi aggiungere nuovi articoli alla knowledge base e l'Agent ne usa subito le informazioni

Il codice del widget è solo un "punto di ingresso": il vero contenuto vive in Hotely.

Sicurezza e prestazioni

Il widget Hotely è progettato per non rallentare il sito:

• Caricamento asincrono — non blocca il rendering della pagina
• File JavaScript minificato e cachato (poche kilobyte)
• CDN globale per bassa latenza ovunque
• Caricamento on-demand — la chat completa si carica solo al primo clic
• Lazy loading delle immagini interne

Il widget non interferisce con il SEO del sito né con gli analytics esistenti.

Casi reali

B&B con sito WordPress

Setup: una riga di codice copiata nel footer del tema WordPress. Tempo di installazione: 2 minuti. Widget attivo su tutte le pagine del sito. Visite di prova confermano funzionamento. Il proprietario aggiunge il link in firma email lo stesso giorno.

Ristorante con sito Wix

Setup: widget integrato tramite l'app store Wix (compatibilità nativa). Aggiunta dei QR code stampati per i 18 tavoli. Tempo totale: 30 minuti dall'installazione al primo ordine al tavolo.

Hotel 30 camere con sito custom

Setup: widget sul sito principale, QR code stampati per le 30 camere e applicati con adesivi resistenti, link condivisibile inserito in tutte le email automatiche del Booking Engine. Tempo totale: 2 ore (incluso stampa QR).

Resort balneare con WordPress + Website Builder Hotely

Setup: Agent integrato nel Website Builder con un solo click (zero codice). Sezione iFrame per pagina "Aiuto e contatti". QR code per ombrelloni stampati con grafica brandizzata. Numero totale di canali attivi: 5.

Catena di ristoranti con multipli siti

Setup: ogni ristorante ha il proprio Agent installato come widget sul rispettivo sito locale. La gestione è centralizzata dalla dashboard madre, ma ogni Agent ha il proprio QR code e link condivisibile. Coerenza di brand mantenuta tramite design template comune.

Prossimi passi

Per approfondire ciascun canale:

• Widget JavaScript — installazione sul sito
• QR code — distribuzione fisica
• Email integrazione — chat via email
• Segreteria telefonica — canale voce
• WhatsApp — canale messaging