Onboarding Cliente

Tutto ciò che serve
per attivarvi.

Una checklist completa per essere operativi nel minor tempo possibile — di solito entro 24 ore.

Pagamento e Abbonamento

Prima di procedere con l'attivazione, il piano Armonyco deve essere attivo.

Prerequisito
Il pagamento via Stripe deve essere completato prima dell'onboarding
Una volta confermato il pagamento, i crediti operativi (ArmoCredits©) e tutte le funzionalità del piano vengono attivati automaticamente.
📄

Per emettere fattura è necessario comunicarci i dati fiscali completi. Se li avete già forniti durante il pagamento su Stripe, non è necessario ripeterli.

Dati Base

Informazioni principali per creare il vostro account sulla piattaforma Armonyco.

InformazioneDettagli
Nome completo del responsabile La persona di riferimento per l'account
Nome dell'azienda Come desiderate che appaia sulla piattaforma
Indirizzo e-mail Per accedere alla piattaforma e ricevere notifiche operative
Numero di telefono Per contatto diretto con il team Armonyco
Dati Fatturazione se non forniti su Stripe
CampoDettagli
Nome società Ragione sociale completa come risulta dal registro imprese
Sede legale Indirizzo completo: via, CAP, città, provincia
Partita IVA Codice IVA italiano (es. IT12345678901)
Codice SDI Codice destinatario per fattura elettronica (7 caratteri) oppure indirizzo PEC
🔑

Vi invieremo una password temporanea che potrete modificare al primo accesso. Non è necessario comunicarci alcuna password.

Credenziali PMS / Gestionale

Per collegare il vostro PMS e sincronizzare automaticamente le prenotazioni. Le proprietà invece vengono configurate manualmente nell'app — vedi sezione 5. Supportiamo KrossBooking, Guesty e altri sistemi compatibili.

CredenzialeDove trovarla
URL del gestionale Il vostro indirizzo di accesso (es. nomeazienda.krossbooking.com)
Institution ID (se KrossBooking) Pannello KB → Configurazioni → Dati della Struttura
Login Username di accesso al gestionale
Password Password di accesso al gestionale
🛡️

Le credenziali devono avere permessi di amministratore — il sistema utilizza l'accesso per sincronizzare dati, gestire le comunicazioni con gli ospiti e operare sulla piattaforma per vostro conto. Se usate un PMS diverso da KrossBooking, vi guideremo durante la call di configurazione.

Collegamento Gmail

Gmail è il canale email attraverso cui il vostro agente AI comunica direttamente con gli ospiti — per conferme, informazioni pre-arrivo e assistenza durante il soggiorno.

Come funziona
Autenticazione Google standard — nessuna configurazione tecnica
Il collegamento avviene tramite il normale login Google (email + password). Vi chiederemo di autorizzare l'accesso durante la call di configurazione — bastano 30 secondi dalla schermata di login Google.
Cosa vi serve
L'indirizzo Gmail che l'agente userà per comunicare con gli ospiti
Può essere un account Gmail aziendale (Google Workspace) o personale — purché accessibile con le vostre credenziali Google durante la call.
⚗️

Canale in beta. Gmail è attualmente il solo provider email supportato. Stiamo lavorando all'integrazione con altri client (Outlook, IMAP generici) nelle prossime versioni. Se non disponete di Gmail, il canale email sarà attivato non appena disponibile il vostro provider.

Attivazione Escalation via Telegram

Il vostro agente AI vi contatta su Telegram ogni volta che è necessario il vostro intervento. Bastano 2 minuti e 2 passaggi per ogni membro dello staff che deve ricevere notifiche.

Passo 1 di 2
Trovare il vostro Chat ID
L'agente ha bisogno del Chat ID personale per sapere dove recapitare le notifiche. Ogni membro dello staff che deve ricevere escalation deve completare questo passaggio.
  1. Apri Telegram
  2. Cerca il bot @userinfobot
  3. Clicca Avvia (o scrivi /start)
  4. Il bot risponde subito. Copia il numero accanto a Id — è il tuo Chat ID
  5. Mandaci questo numero — è tutto ciò che ci serve per attivarti
Esempio risposta @userinfobot
👤 Your info:
Id: 1234567890   ← il tuo Chat ID
First: Marco
Username: @marco
Passo 2 di 2
Attivare il bot del vostro agente
Il bot è già attivo — creato e gestito da Armonyco. Per iniziare a ricevere notifiche è sufficiente aprirlo una volta tramite il link che vi abbiamo fornito.
  1. Apri il link diretto al bot che vi ha inviato il team Armonyco
  2. Si apre automaticamente Telegram con la conversazione del bot
  3. Clicca Avvia (o scrivi /start)
  4. Fatto. Da questo momento l'agente può inviarvi notifiche in tempo reale
Cosa riceverete su Telegram
Tipo Quando
🚨 Escalation Situazioni che richiedono una decisione umana immediata
⚠️ Alert operativi Anomalie rilevate durante la gestione (pagamenti, check-in, ecc.)
📋 Comunicazioni Aggiornamenti importanti dalla gestione della proprietà
📊 Report automatici Riepiloghi periodici configurati per il vostro profilo
⚠️

Il bot è solo per notifiche in uscita — non risponde ai messaggi.
Se non completate il Passo 2, non riceverete nessuna notifica, anche se ci avete già inviato il Chat ID.
In caso di cambio telefono o account, ripetete entrambi i passaggi e inviateci il nuovo Chat ID.

Dati delle Proprietà

I dati delle vostre proprietà vengono inseriti direttamente nell'app Armonyco, nella sezione Controls → Properties. Nessun file da compilare — tutto avviene all'interno della piattaforma durante la call di configurazione.

Come funziona
Inserimento diretto nell'app — Controls → Properties
Accedete alla vostra dashboard Armonyco, navigate in Controls → Properties e compilate i campi per ogni proprietà. Niente fogli Excel da inviare, nessuna estrazione automatica dal gestionale — tutto avviene all'interno della piattaforma, campo per campo, durante la call di configurazione guidata.
Template Dati per Ogni Proprietà (clicca per espandere)
CampoFormatoEsempio
Identità
Nome breve (interno)testoAPT-01
Nome marketing (pubblico)testoBella Vista Suite 1
Numero stanzatesto101
Brand / ComplessotestoBella Vista Suites
Categoria unitàtestoappartamento
Ubicazione
CittàtestoMilano
QuartieretestoCentro Storico
IndirizzotestoVia Roma 10
Pianotesto2
CAPtesto20100
Stato / RegionetestoLombardia
Latitudinenumero41.9028
Longitudinenumero12.4964
Link Google MapsURLhttps://maps.google.com/...
Descrizione brevetestoSuite elegante nel centro città
Descrizione estesatesto liberoLa vostra suite si trova nel cuore della città...
Capacità e Composizione
Superficie (mq)numero65
Ascensoresì / noSI
Ospiti maxnumero4
Camere da lettonumero2
Lettinumero2
Letti extranumero1
Bagninumero1
Vasca idromassaggiosì / noNO
Cullasì / noNO
Note accessibilitàtesto
Check-in / Check-out
Orario check-inHH:MM15:00
Orario check-outHH:MM10:00
Late check-in (fascia)testodopo le 20:00
Late check-in (costo)€ / gratis€30
Late check-outtestosu richiesta, soggetto a disponibilità
Self check-insì / noSI
Metodo di accessotestosmart lock + codice
Codici Accesso (riservati)
Codice portone su stradacodice1234
Codice portone scalacodice5678
Codice accesso strutturacodice
Key stanzatesto/codicecodice smart lock 9012
Tasse, WiFi e Depositi
Tassa di soggiorno (p.p./notte)5 € p.p. a notte
Tipo pagamento tassacontanti / guest portalcontanti
WiFi disponibilesì / noSI
Nome rete WiFitestoBellaVista_Guest
Password WiFitestowelcome2024
Deposito cauzionale€ / non richiesto€200
Regole
Animalisì / noNO
Fumosì / noNO
Festesì / noNO
Quiet hoursfascia oraria22:00–08:00
ColazionetestoNon inclusa / Inclusa con bar locale
Dotazioni (sì/no per ogni voce)
Aria condizionata · Riscaldamento · TV · Cucina attrezzata · Lavatrice · Lavastoviglie · Macchina caffè · Frigorifero · Forno · Microonde · Bollitore · Biancheria · Asciugamani · Asciugacapelli · Ferro da stiro · Kit pronto soccorso · Rilevatore fumo · Rilevatore CO · Estintore · Balcone/Terrazza
Ambiente e Dintorni
VistatestoVista interna sul cortile
ParcheggiotestoNon disponibile / Privato gratuito
Navetta aeroportotestoSu richiesta, a pagamento
Info quartiere / come raggiungeretesto liberoZona pedonale, metro a 5 min
Ristoranti consigliatitesto liberonome, nome, nome
Gelaterie consigliatetesto liberonome, nome
Pizzerie consigliatetesto liberonome, nome
Locali per aperitivotesto liberonome, nome
Lingue parlate dal personalelistaIT, EN, FR, DE
📋

Il template a tendina qui sopra mostra i campi disponibili come riferimento. Non è necessario prepararli in anticipo né compilare alcun file — durante la call vi guidiamo campo per campo direttamente nell'app.

Linee Guida Operative

Il manuale operativo della vostra azienda è ciò che rende l'agente AI davvero vostro. Lo configurate direttamente nell'app Armonyco, nella sezione Controls → Policies — campo per campo, durante la call di configurazione guidata.

Template Guidelines — Sezioni da Compilare (clicca per espandere)
SezioneCosa includere
1. Istituzionale Missione, visione, valori, posizionamento. Tone of voice desiderato (formale, amichevole, professionale…)
2. Canali Ufficiali Sito web, email, telefono, link Guest Portal, link booking engine, sede legale
3. Personale e Ruoli Orari staff, lingue parlate, responsabilità esclusive (cosa serve approvazione umana?)
4. Politiche Generali Età minima, animali, fumo, feste, quiet hours, regole ospiti non registrati
5. Check-in / Check-out Orari, procedura self check-in, regole early/late check-in, documenti richiesti, codici accesso
6. Servizi Base Bagagli, pulizia extra, city tax (importi e metodo per proprietà), modifiche prenotazione
7. Servizi Aggiuntivi Transfer, colazione, esperienze, late check-out, notti extra — prezzi e condizioni
8. Prenotazioni e Vendita Canali ufficiali, booking engine, tariffe dinamiche o fisse, politica cancellazione
9. Escalation Quando l'AI deve passare a un umano? Livelli di urgenza, soglie di autonomia
10. Pagamenti e Rimborsi Metodi accettati, politica rimborsi, casi speciali
11. Feedback e Recensioni Come gestire feedback positivi/negativi, link Google Review, piattaforme OTA
12. Privacy e GDPR Trattamento dati, responsabile privacy, periodo conservazione, diritti ospite
✍️

Niente documenti da inviare. Le sezioni qui sopra sono solo un riferimento — durante la call vi guidiamo a compilarle direttamente in Controls → Policies, nel formato ottimale per l'AI.

Personalizzazione dell'Agente

Informazioni per configurare e personalizzare il vostro agente AI.

InformazioneDettagli
Nome dell'agente AI Ogni azienda sceglie il nome del proprio agente (es. Amelia, Sofia, Marco…)
Tono di voce Formale, informale, caloroso, professionale… come preferite
Lingue supportate Italiano, inglese, portoghese, spagnolo, ecc.
Logo aziendale Il vostro logo in alta risoluzione (PNG trasparente) per la piattaforma

ArmoCredits© e Ricarica Automatica

Ogni azione eseguita dall'agente AI — rispondere a un ospite, gestire un check-in, inviare una comunicazione — consuma ArmoCredits©. Ecco come funziona il sistema di crediti e perché è necessario aggiungere un metodo di pagamento.

Come funziona
Ogni esecuzione AI consuma crediti in base alla complessità
Il vostro piano include un pacchetto iniziale di ArmoCredits©. Ogni volta che l'agente esegue un'operazione con successo — una risposta WhatsApp, un'email, una decisione autonoma — il sistema deduce automaticamente i crediti corrispondenti dal vostro saldo. I crediti non scadono mai e il consumo è tracciato in tempo reale nella vostra dashboard, sezione Abbonamento.
Ricarica Automatica (AutoTopUp)
Il sistema ricarica automaticamente i crediti quando il saldo scende sotto la soglia minima
Per garantire che l'agente non si fermi mai, Armonyco offre la Ricarica Automatica: quando il vostro saldo ArmoCredits© scende sotto la soglia configurata (di default 1.000 crediti), il sistema aggiunge automaticamente un pacchetto di crediti e addebita l'importo corrispondente sul metodo di pagamento registrato, tramite Stripe.
Soglia: 1.000 crediti Ricarica: 100K crediti Prezzo: €5,00 / 1.000 crediti
⚠️ Obbligatorio
È necessario aggiungere un metodo di pagamento (carta di credito/debito)
Per attivare la Ricarica Automatica — e garantire la continuità operativa del vostro agente — è obbligatorio registrare un metodo di pagamento valido nella sezione Abbonamento → Ricarica Automatica della vostra dashboard Armonyco. Senza un metodo di pagamento registrato:
  • La Ricarica Automatica non può essere attivata
  • Quando i crediti si esauriscono, l'agente AI si ferma — nessuna risposta agli ospiti, nessuna automazione
  • Il servizio riprende automaticamente non appena il saldo viene ricaricato
I pagamenti vengono processati in modo sicuro tramite Stripe. Non conserviamo i dati della carta — sono gestiti interamente da Stripe (PCI DSS Level 1).
Come fare
Aggiungere il metodo di pagamento in 3 passaggi
  1. Accedete alla vostra dashboard Armonyco → sezione Abbonamento
  2. Nel riquadro Ricarica Automatica, cliccate su Add Payment Method
  3. Inserite i dati della carta nella finestra sicura di Stripe e confermate
Una volta aggiunto il metodo di pagamento, attivate il toggle Ricarica Automatica — da quel momento il sistema manterrà autonomamente il vostro saldo sopra la soglia minima.
💡

Potete anche ricaricare manualmente i crediti in qualsiasi momento dalla sezione Acquisto Gestito, senza attendere che il saldo scenda sotto la soglia. Il metodo di pagamento resta comunque obbligatorio come rete di sicurezza per evitare interruzioni del servizio.

Come Funziona

Un processo rapido e strutturato per essere operativi in meno di 48 ore.

Pagamento del piano
L'abbonamento Armonyco viene attivato tramite Stripe.
Ci inviate le credenziali
Dati base, credenziali PMS, Chat ID Telegram, autorizzazione Gmail. Proprietà e linee guida operative le compilate direttamente nell'app durante la call.
Call di configurazione (30 min)
Configuriamo insieme l'attivazione Telegram (Chat ID + link bot), autorizziamo Gmail e rispondiamo a qualsiasi domanda.
Setup interno
Il nostro team configura piattaforma, automazione e AI.
≤50 unità: entro 24h ≤500 unità: entro 48h 500+ unità: da concordare
Call di collaudo (30 min)
Primo login, verifica delle proprietà configurate in Controls → Properties e test live su tutti i canali attivi — WhatsApp, Gmail, Telegram.
Operativi Live
Il vostro agente AI è attivo e pronto ad accogliere gli ospiti.

Canali Inclusi nel Vostro Piano

Non dovete configurare nulla — i canali vengono attivati da noi durante l'onboarding.

💬 WhatsApp
📧 Gmail
📲 Telegram (staff)
🏨 PMS / Gestionale
ArmoCredits©
Crediti operativi inclusi nel piano
Fatturazione
Gestita automaticamente via Stripe
Sicurezza
GDPR, crittografia, accesso controllato
Dashboard
Analytics e KPI operativi in tempo reale