# Qabbad Channex

Channex huwa channel manager użat minn ħafna PMS u hosts. Il-portal tal-mistednin jaqra l-bookings tiegħek minn Channex u joħloq link tal-portal għal kull mistieden.

## 1. Oħloq API key ta' Channex

1. Idħol f'Channex (`https://app.channex.io`, jew l-indirizz white-label ta' Channex tiegħek).
2. Iftaħ il-profil tal-utent tiegħek u mur f'**API keys**.
3. Oħloq ċavetta ġdida bl-isem *Guest portal* u kkupjaha.

## 2. Qabbad mid-dashboard tiegħek

1. Iftaħ **Settings → Channels → Channex**.
2. Waħħal l-**API key**.
3. **Base URL**: ħalli `https://app.channex.io` sakemm ma tkunx qed tittestja fuq `https://staging.channex.io`. Jiġu aċċettati biss indirizzi ta' Channex.
4. Immarka **Enabled**, **Save**, **Test**.

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

## 3. Orbot il-proprjetajiet tiegħek

**Show listings** jelenka l-proprjetajiet tiegħek f'Channex bl-IDs tagħhom (UUIDs). **Add selected as properties** (jiġu importati r-ritratti wkoll — l-ewwel wieħed isir il-cover; **Import photos** fil-karta jġibhom għall-proprjetajiet marbuta qabel) joħloq proprjetà għal kull waħda mmarkata — bl-isem, l-indirizz, il-belt jew raħal, il-pajjiż u ż-żona tal-ħin minn Channex — jorbotha u jimporta l-bookings tagħha. Għal proprjetà li diġà ħloqt manwalment, neħħi l-marka u minflok waħħal l-ID f'**Settings → Properties → Settings → Channex property ID**.

## 4. Importa

Ikklikkja **Import now**; wara dan il-bookings jiġu importati kull 30 minuta, inklużi l-modifiki u l-kanċellazzjonijiet.

### Aġġornamenti istantanji (webhook)

![Aġġornamenti istantanji fil-karta tal-kanal](/site/img/docs/d-channels-instant.webp "Aġġornamenti istantanji fil-karta tal-kanal")


1. F'**Settings → Channels → Channex** ikklikkja **Set up instant updates**, imbagħad **Register in Channex**. Il-portal tal-mistednin joħloq il-webhook tal-bookings fil-kont Channex tiegħek (wieħed għall-kont, jew wieħed għal kull proprjetà marbuta jekk il-pjan Channex tiegħek jippermetti biss webhooks tal-proprjetà).
2. Il-bookings ġodda, mibdula u kkanċellati mbagħad jaslu fi ftit sekondi; il-karta turi l-aħħar sejħa. L-import regolari jibqa' għaddej bħala xibka ta' sigurtà.

L-indirizz huwa sigriet. **New address** jibdlu u jaġġorna l-webhook f'Channex awtomatikament.

## 5. Ikkonferma r-reviżjonijiet tal-bookings (fakultattiv)

Channex jistenna li s-sistema li tmexxi l-bookings tiegħek **tikkonferma** (acknowledge) kull reviżjoni ta' booking mill-feed tiegħu; ir-reviżjonijiet mhux ikkonfermati jerġgħu jintbagħtu u Channex iwissik bl-email. Immarka **Acknowledge booking revisions** fil-karta ta' Channex meta l-portal tal-mistednin ikun l-unika sistema li taqra dan il-kont Channex. Jekk sistema oħra (PMS ieħor, jew codeb-demo) diġà tikkonfermahom, ħallih mitfi — il-portal tal-mistednin imbagħad jaqra l-bookings direttament u xejn ma jintilef.

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

Għall-bookings ta' Booking.com, Airbnb u Expedia tista' tikteb lill-mistieden fiċ-chat tal-kanal stess: is-sezzjoni **Messages** tal-booking turi l-konversazzjoni, **Send portal link via …** jibgħat il-link tal-gwida tas-soġġorn, u **Settings → Email → Also send it through the booking channel's chat** jagħmel dan awtomatikament qabel il-wasla.

- L-app **Messages** ta' Channex trid tkun installata (app.channex.io → Applications).
- Il-bookings ta' Expedia Partner Solutions / affiljati ma jappoġġjawx messaġġi.
- Il-bookings importati qabel ma kienu disponibbli l-messaġġi jintrabtu fl-import li jmiss.

## Mistoqsijiet frekwenti

### Il-portal tal-mistednin jibdel xi ħaġa f'Channex?

Le. Il-konnessjoni taqra l-bookings (u, jekk tixgħelha, tikkonferma r-reviżjonijiet tal-bookings) u tibgħat il-messaġġi li tikteb lill-mistednin. Id-disponibbiltà u l-prezzijiet jibqgħu jiġu mmaniġġjati f'Channex.

### Nuża Channex permezz tal-PMS tiegħi — xorta nista' nqabbad?

Iva, sakemm tkun tista' toħloq API key ta' Channex b'aċċess għall-proprjetajiet. Staqsi lill-fornitur tal-PMS tiegħek jekk għandek biss login white-label.