# Collegare Channex

Channex è un channel manager usato da molti PMS e host. Il portale ospiti legge le tue prenotazioni Channex e crea un link al portale per ogni ospite.

## 1. Crea una chiave API Channex

1. Accedi a Channex (`https://app.channex.io`, o al tuo indirizzo Channex white-label).
2. Apri il tuo profilo utente e vai su **API keys**.
3. Crea una nuova chiave chiamata *Guest portal* e copiala.

## 2. Collegati dalla dashboard

1. Apri **Settings → Channels → Channex** (Impostazioni → Canali).
2. Incolla la **API key**.
3. **Base URL**: lascia `https://app.channex.io`, a meno che tu non stia facendo test su `https://staging.channex.io`. Sono accettati solo indirizzi Channex.
4. Spunta **Enabled**, poi **Save** e **Test**.

![Settings → Channels](/site/img/docs/d-settings-channels.webp "Settings → Channels")

## 3. Collega le tue strutture

**Show listings** elenca le tue strutture Channex con i relativi ID (UUID). **Add selected as properties** (vengono importate anche le foto — la prima diventa la copertina; **Import photos** nella scheda le scarica per le strutture collegate in precedenza) crea una struttura per ognuna di quelle spuntate — con nome, indirizzo, città, paese e fuso orario presi da Channex — la collega e ne importa le prenotazioni. Per una struttura che hai già creato a mano, togli la spunta e incolla invece l'ID in **Settings → Properties → Settings → Channex property ID**.

## 4. Importazione

Clicca **Import now**; in seguito le prenotazioni vengono importate ogni 30 minuti, comprese modifiche e cancellazioni.

### Aggiornamenti istantanei (webhook)

![Aggiornamenti istantanei nella scheda del canale](/site/img/docs/d-channels-instant.webp "Aggiornamenti istantanei nella scheda del canale")


1. In **Settings → Channels → Channex** clicca **Set up instant updates**, poi **Register in Channex**. Il portale ospiti crea il webhook delle prenotazioni nel tuo account Channex (uno per l'account, oppure uno per ogni struttura collegata se il tuo piano Channex consente solo webhook per struttura).
2. Le prenotazioni nuove, modificate e cancellate arrivano così in pochi secondi; la scheda mostra l'ultima chiamata. L'importazione periodica continua a funzionare come rete di sicurezza.

L'indirizzo è segreto. **New address** lo sostituisce e aggiorna automaticamente il webhook in Channex.

## 5. Conferma delle revisioni delle prenotazioni (facoltativo)

Channex si aspetta che il sistema che gestisce le tue prenotazioni **confermi** (acknowledge) ogni revisione di prenotazione del suo feed; le revisioni non confermate vengono reinviate e Channex ti avvisa via email. Spunta **Acknowledge booking revisions** nella scheda Channex se il portale ospiti è l'unico sistema che legge questo account Channex. Se un altro sistema (un altro PMS, o codeb-demo) le conferma già, lascia l'opzione disattivata — il portale ospiti legge allora direttamente le prenotazioni e non si perde nulla.

## 6. Scrivere agli ospiti

Per le prenotazioni Booking.com, Airbnb ed Expedia puoi scrivere all'ospite nella chat del canale: la sezione **Messages** della prenotazione mostra la conversazione, **Send portal link via …** invia il link alla guida del soggiorno e **Settings → Email → Also send it through the booking channel's chat** lo fa automaticamente prima dell'arrivo.

- Deve essere installata l'app Channex **Messages** (app.channex.io → Applications).
- Le prenotazioni Expedia Partner Solutions / affiliate non supportano i messaggi.
- Le prenotazioni importate prima che la messaggistica fosse disponibile vengono collegate alla successiva importazione.

## Domande frequenti

### Il portale ospiti modifica qualcosa in Channex?

No. Il collegamento legge le prenotazioni (e, se lo attivi, conferma le revisioni delle prenotazioni) e invia i messaggi agli ospiti che scrivi tu. Disponibilità e prezzi restano gestiti in Channex.

### Uso Channex tramite il mio PMS: posso comunque collegarlo?

Sì, purché tu possa creare una chiave API Channex con accesso alle strutture. Se hai solo un accesso white-label, chiedi al tuo fornitore PMS.