# Kif tqabbad Hostaway

Meta Hostaway ikun imqabbad, kull riżervazzjoni (minn Airbnb, Booking.com, Vrbo, diretta …) tiġi importata fil-portal tal-mistednin tiegħek awtomatikament: id-dati, in-numru ta' mistednin, l-isem u d-dettalji ta' kuntatt tal-mistieden. Il-kanċellazzjonijiet u t-tibdil fid-dati jiġu segwiti wkoll. Id-data tal-check-in, il-pagamenti u n-noti tiegħek qatt ma jinkitbu fuqhom mill-importazzjoni.

## 1. Oħloq API key f'Hostaway

1. Idħol fid-dashboard ta' Hostaway tiegħek.
2. Iftaħ **Settings → Hostaway API**.
3. Ikklikkja **Create** biex iżżid API key ġdid, agħtih isem (pereżempju *Guest portal*) u ssalva.
4. Ikkopja l-**Account ID** u l-**API key** (Hostaway isejjaħlu client secret). Il-key jintwera darba biss.

## 2. Qabbad Hostaway fid-dashboard tiegħek

1. Iftaħ **Settings → Channels → Hostaway**.
2. Waħħal l-**Account ID** u l-**API key (client secret)**.
3. Ħalli **API base URL** vojt — imbagħad juża `https://api.hostaway.com/v1`. Imlieh biss biex tuża endpoint kompatibbli ma' Hostaway (pereżempju endpoint ta' CodeB); irid ikun indirizz https pubbliku.
4. Immarka **Enabled** u kklikkja **Test** (l-ewwel jissalva). Għandek tara *Hostaway: connected*.

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

## 3. Orbot il-proprjetajiet tiegħek

1. Ikklikkja **Show listings** fil-kard ta' Hostaway. Tara kull listing bl-ID tiegħu u jekk huwiex diġà marbut.
2. **Ġdid fil-portal tal-mistednin?** Ħalli l-listings immarkati u kklikkja **Add selected as properties**. Kull listing isir proprjetà bl-isem, l-indirizz, il-belt, il-pajjiż, iż-żona tal-ħin u l-ħinijiet tal-check-in / check-out minn Hostaway, jintrabat u l-bookings tiegħu jiġu importati minnufih.
3. **Diġà ħloqt proprjetà bl-idejn?** Neħħi l-marka minn dak il-listing (titneħħa awtomatikament meta proprjetà jkollha l-istess isem) u minflok waħħal l-ID tal-listing f'**Settings → Properties → Settings → Hostaway listing ID**, biex ma jkollokx kopja.

![Show listings: immarka l-listings li trid iżżid — dawk marbuta u l-proprjetajiet bl-istess isem jiġu rikonoxxuti](/site/img/docs/d-channels-listings.webp "Show listings: immarka l-listings li trid iżżid — dawk marbuta u l-proprjetajiet bl-istess isem jiġu rikonoxxuti")

Il-kard turi l-progress u d-dashboard tiġi aġġornata waħedha meta l-bookings ikunu daħlu. Ir-**ritratti** tal-listing jiġu importati wkoll (sa 12 għal kull proprjetà, maħżuna fuq is-server tal-portal tal-mistednin innifsu); l-ewwel wieħed isir ir-ritratt tal-qoxra. Agħżel qoxra oħra f'**Guide editor → Property & welcome → Photos from Hostaway**. Għall-proprjetajiet marbuta qabel, ikklikkja **Import photos** fil-kard ta' Hostaway — iġib biss dak li jonqos, għalhekk tista' terġa' tikklikkja mingħajr periklu (pereżempju wara restart tas-server).

![Waqt li l-bookings qed jiġu importati, il-kard turi l-progress u taġġorna d-dashboard meta jkunu daħlu](/site/img/docs/d-channels-progress.webp "Waqt li l-bookings qed jiġu importati, il-kard turi l-progress u taġġorna d-dashboard meta jkunu daħlu")

Imbagħad imla kull proprjetà: Wi-Fi, kodiċijiet tal-bieb, liċenzja tal-MTA, taxxa tat-turisti u pagamenti.

## 4. Importazzjoni

Ikklikkja **Import now** biex iġġib ir-riżervazzjonijiet minnufih. Wara dan, l-importazzjonijiet isiru awtomatikament kull 30 minuta għal soġġorni minn 30 jum ilu sa madwar 18-il xahar 'il quddiem.

### Aġġornamenti istantanji (webhook)

Minflok ma tistenna sa 30 minuta għall-importazzjoni li jmiss, Hostaway jista' jgħarraf lill-portal tal-mistednin dwar riżervazzjonijiet ġodda u mibdula fi ftit sekondi:

1. F'**Settings → Channels → Hostaway** ikklikkja **Set up instant updates** u **Copy** l-indirizz.
2. Fid-dashboard ta' Hostaway iftaħ **Settings → Integrations → Webhooks** (unified webhooks), żid webhook b'dan l-URL u ssalva. Ħalli l-login u l-password vojta — l-indirizz innifsu huwa ċ-ċavetta.
3. Il-kard turi meta Hostaway ċempel l-aħħar darba u x'ġara. L-importazzjoni regolari tibqa' għaddejja bħala xibka ta' sigurtà.

![Aġġornamenti istantanji: l-indirizz sigriet tal-webhook u l-aħħar sejħa](/site/img/docs/d-channels-instant.webp "Aġġornamenti istantanji: l-indirizz sigriet tal-webhook u l-aħħar sejħa")

L-indirizz huwa sigriet: kull min għandu jista' jitlob lill-portal tal-mistednin jerġa' jiċċekkja booking (il-booking innifsu dejjem jinġieb minn Hostaway bl-API key tiegħek). **New address** jissostitwih jekk qatt joħroġ — imbagħad waħħal il-ġdid f'Hostaway.

## 5. Stieden lill-mistednin

Il-bookings importati jirċievu l-link tal-portal tagħhom minnufih. Tista' tibagħtu:

- bl-email mill-booking (**Email portal link to guest**);
- **fiċ-chat tal-kanal** — **Send portal link via Airbnb** (jew Booking.com, Vrbo …) fil-booking. Il-messaġġ jgħaddi minn Hostaway għall-inbox tal-mistieden fuq il-pjattaforma li biha bbukkja;
- awtomatikament ftit jiem qabel il-wasla: **Settings → Email** — *Email the portal link to new guests automatically* u/jew *Also send it through the booking channel's chat*.

## 6. Ibgħat messaġġi lill-mistednin

It-taqsima **Messages** tal-booking turi l-konversazzjoni minn Hostaway (il-messaġġi tal-mistieden u tiegħek) u tħallik twieġeb fiċ-chat tal-kanal. Il-messaġġi jintbagħtu eżattament kif miktuba — placeholders bħal `[guest_name]` ma jimtlewx, għalhekk messaġġ li għad fih wieħed jiġi rrifjutat. Dettalji: [Email u notifiki](/docs/email-and-notifications).

## Mistoqsijiet frekwenti

### Liema data tiġi minn Hostaway u liema tibqa' hawn?

Inquiries, talbiet pendenti u mhux ikkonfermati (pereżempju request to book ta' Vrbo), talbiet skaduti jew miċħuda u soġġorni tas-sid ma jiġux importati — biss soġġorni reali. Hostaway huwa s-sors tad-dati, l-istatus, in-numru ta' mistednin u d-dettalji ta' kuntatt mill-booking — ħlief in-numri tal-mistednin li kkoreġejt fil-booking (**Guests → Change**), li l-importazzjonijiet ta' wara jżommu. Id-data tal-check-in online, il-pagamenti, l-istatus tad-depożitu, il-kodiċijiet tal-bieb u n-noti tiegħek jinżammu fil-portal tal-mistednin u qatt ma jinkitbu fuqhom.

### Kif naġġorna r-ritratti ta' proprjetà waħda?

**Settings → Properties → Settings → Photos → Refresh photos** iġib ritratti ġodda, ineħħi dawk li Hostaway m'għadux jelenka u qatt ma jniżżel ritratt darbtejn. **Refresh and use the first as cover** jerġa' jissettja wkoll ir-ritratt tal-qoxra.

![Settings tal-proprjetà: aġġorna r-ritratti ta' proprjetà waħda](/site/img/docs/d-property-photos.webp "Settings tal-proprjetà: aġġorna r-ritratti ta' proprjetà waħda")

### X'jiġri meta riżervazzjoni tiġi kkanċellata f'Hostaway?

Il-booking jiġi mmarkat bħala kkanċellat fl-importazzjoni li jmiss; il-portal tal-mistednin juri l-kanċellazzjoni u d-dati jinħelsu.

### Xi mistednin m'għandhomx indirizz tal-email?

Il-kanali spiss jaħbu l-email reali. Minflok, ibgħat il-link tal-portal permezz taċ-chat tal-kanal — **Send portal link via …** fil-booking, jew ixgħel l-istedina awtomatika fiċ-chat f'**Settings → Email**.