HopySuite — Integrazione con Hostaway

1) Prima configurazione

Per integrare Hostaway è necessario che il nostro team attivi il tuo account HopySuite.
Se non lo hai ancora fatto, contattaci:
📧 support@hopysuite.com
Oppure richiedi una demo da questa pagina:
https://hopysuite.com/index.php/prenota-una-demo/

2) Requisiti Hostaway (cosa ti serve)

L'integrazione Hostaway richiede due credenziali tecniche:

• Account ID (client_id)


• API Secret Key (client_secret)

Per ottenerle: vai su Hostaway Dashboard → Marketplace → cerca HopySuite → Connect → Create

⚠️ Nota importante: Hostaway mostra la API Secret Key una sola volta. Conservala in modo sicuro.

3) Come collegare Hostaway a HopySuite

1. Accedi a HopySuite.
2. Vai in Configurazione → Integrazioni → Hostaway.
3. Inserisci:
   • Account ID
   • API Secret Key
4. Clicca “Salva configurazione”.

Cosa succede dopo:

• HopySuite salva Account ID e API Secret Key.
  
• HopySuite genera automaticamente un Access Token (necessario per le chiamate API).
• La sincronizzazione potrà partire subito (tramite cron automatici).

4) Gestione della connessione (stato + azioni)
Dalla pagina Hostaway puoi gestire lo stato dell’integrazione.
Stato integrazione

• ✅ Connesso — configurazione presente e integrazione attiva
• ⚠️ Account disabilitato — configurazione presente ma integrazione disattivata
  
• ℹ️ Token mancante — serve rigenerare il token (salva o abilita l’integrazione)

Azioni disponibili

• Salva configurazione (aggiorna credenziali e genera un nuovo token)
• Abilita account / Disabilita account

  
  Quando abiliti, HopySuite può rigenerare un token valido per garantire la connessione.

5) Funzionamento tecnico (in breve)

• HopySuite genera un Access Token da Hostaway con flusso client_credentials.
  
• Il token viene salvato e utilizzato dai cron di sincronizzazione.
  
• Se il token è scaduto o non valido, HopySuite lo rigenera automaticamente quando necessario.
• Non devi gestire manualmente refresh o scadenze.
• Nota tecnica:
  HopySuite utilizza un Provider ID ufficiale per tutte le chiamate API verso Hostaway.
  Questo consente a Hostaway di tracciare e certificare correttamente l'integrazione.

6) Quali dati importiamo da Hostaway?
HopySuite importa esclusivamente i dati necessari al corretto funzionamento dell’integrazione.
Tipologie / Strutture (Listings)
Informazioni generali sulle proprietà, come dati identificativi, indirizzo e posizione, capienza, caratteristiche principali, orari e immagini.
Prenotazioni (Reservations)
Dati relativi alle prenotazioni, inclusi stato, date del soggiorno, ospiti, importi principali, contatti dell’ospite e informazioni di canale.
Proprietari / Contatti
Hostaway non fornisce sempre un elenco proprietari dedicato.
Quando non disponibile, HopySuite ricava i contatti proprietario direttamente dai dati del listing .
✅ Nessun altro dato viene letto o archiviato da HopySuite oltre a quelli strettamente necessari all’integrazione.

7) Supporto
Se hai bisogno di aiuto:
📧 support@hopysuite.com
Oggetto consigliato: Integrazione Hostaway
Per assistenza più veloce, includi:

• ID account HopySuite
• Account ID Hostaway (se disponibile)
  
• Screenshot della pagina Hostaway su HopySuite
• Eventuali messaggi di errore visualizzati