Dokumentace
← cabintale.com EN · CZ Napsat na podporu
Propojení kanálů · Návod

Import iCal (Zdroje rezervací)

Stahujte rezervace z Airbnb, Booking.com a dalších platforem, aby se v Cabintale ukázaly jako blokované.

Po dokončení tohoto návodu budete mít aspoň jeden externí kalendář, který se napojuje do Cabintale, importované rezervace se zobrazí vedle vašich přímých — a budete vědět, jak je udržet v synchronizaci.

Jeden pojem: Zdroje rezervací. Cabintale má sjednocenou sekci Zdroje, která pokrývá jak automaticky synchronizované iCal kanály (Airbnb, Booking.com…), tak manuální zdroje bez URL (Megaubytko, E-chalupy a všechno, co řešíte e-mailem). Každá rezervace je buď Přímá, nebo z iCalu, nebo ručně přiřazená k některému manuálnímu zdroji — nikdy ne víc najednou.

Než začnete

Co budete potřebovat

  • Nemovitost v sekci Vaše nastavení → Místa
  • Přístup k Airbnb / Booking.com / Vrbo / Google Calendar — k tomu, co chcete importovat
  • iCal URL z každé platformy (kde je hledat, ukážeme)
  • ~10 minut
Co získáte
  • Jeden nebo víc externích kalendářů napojených na vaši nemovitost
  • První synchronizaci, importované rezervace viditelné v kalendáři Cabintale
  • Jistotu, že váš widget neprodá datum, které je už zabraný na Airbnb

Krok 1: Najděte iCal URL každé platformy

Každá platforma vystavuje soukromou odběrovou URL končící .ics. Bývají schované jinde.

PlatformaKde to najít
AirbnbCalendar → Calendar settings (ozubené kolečko) → Connect to another website → Export Calendar
Booking.comCalendar → Sync calendars → iCal URL
VrboCalendar → Export calendar → zkopírujte URL
Google CalendarNastavení kalendáře → Integrovat kalendář → Tajná adresa ve formátu iCal
Apple CalendarPravým tlačítkem na kalendář → Sdílet kalendář → Veřejná URL kalendáře (vyžaduje, abyste kalendář zveřejnili)

URL si zkopírujte — vložíte ji do Cabintale. Každý kalendář má svou vlastní URL.

Krok 2: Otevřete Zdroje

V postranní nabídce → Místa → vaše nemovitost → záložka Zdroje rezervací.

Zdroje jsou rozdělené do tří sekcí:

  • Vaše exporty — odkazy ven z Cabintale: váš feed rezervací pro OTA a úklidový kalendář (popsané v Export iCal (Feed rezervací pro OTA) a Úklidový kalendář).
  • Vlastní zdroje — řádek Přímé (vaše vlastní rezervace) plus jakékoli manuální zdroje, které si přidáte ručně (Megaubytko, E-chalupy…).
  • Příchozí kalendáře — externí iCal kanály (Airbnb, Booking.com…) synchronizované do Cabintale. Tahle sekce se objeví, až jeden přidáte.

Tenhle návod je o té poslední sekci. Každá sekce má vlastní tlačítko Přidat.

Krok 3: Přidejte zdroj (příchozí kalendář nebo vlastní zdroj)

Jsou dvě samostatná tlačítka a to, na které kliknete, určí typ zdroje natrvalo:

  • Přidat příchozí kalendářiCal-synchronizovaný zdroj. Okno chce Název a iCal URL (vložte z Kroku 1) plus Barvu (jedna ze šesti přednastavených). Cabintale rezervace z této URL synchronizuje automaticky.
  • Přidat vlastní zdrojmanuální zdroj. Okno chce Název a Barvu — žádné pole pro URL. Manuální zdroje se nesynchronizují; jsou to jen popisky, které přiřadíte k ručně vytvořené rezervaci (např. k té, co přišla přes Megaubytko nebo E-chalupy).

Rezervace z daného zdroje se v mřížce kalendáře zobrazí jeho Barvou, takže je na první pohled rozeznáte.

Klikněte na Přidat. Nový zdroj se objeví ve své tabulce. Sloupce Stav a Poslední synchronizace se vyplní u příchozích kalendářů a zůstanou prázdné u vlastních zdrojů — není co synchronizovat.

První synchronizace neproběhne sama. U příchozího kalendáře klikněte na tlačítko Sync v řádku, abyste rezervace stáhli poprvé. Vlastní zdroje tlačítko Sync nemají.

Vyberte správné tlačítko — později to nepřepnete. Jestli je zdroj příchozí kalendář, nebo vlastní zdroj, se zafixuje při vytvoření. Úpravou změníte název, barvu, URL (jen u příchozích kalendářů) a stav aktivní — typ ne. Pro změnu zdroj smažte a přidejte znovu druhým tlačítkem.

Krok 4: Spusťte synchronizaci

Klikněte na Sync v řádku. Uvidíte jednu ze dvou věcí:

  • „iCal byl úspěšně synchronizován! Vytvořeno: 5, Aktualizováno: 0, Odstraněno: 0" — synchronizace stáhla 5 rezervací.
  • „Synchronizace iCal se nezdařila: …" — něco se pokazilo. Viz Řešení problémů níž.

Sloupec Poslední synchronizace se aktualizuje na aktuální čas.

Jak synchronizace funguje

Každá rezervace z každé platformy má unikátní ID (iCal UID). Cabintale ho používá, aby udržela věci konzistentní napříč synchronizacemi:

  • Nové události ve feedu → nové rezervace v Cabintale.
  • Existující události se změněnými daty → odpovídající rezervace se aktualizují.
  • Události odstraněné z feedu → odpovídající nadcházející rezervace se odstraní. Minulé rezervace zůstávají, aby vám neutekla historie.
  • Zrušené rezervace (STATUS:CANCELLED nebo vzory „Not available") → ignorují se.

Cabintale automaticky pozná, jestli feed pochází od Google, Airbnb nebo z generického zdroje — Airbnb v DTEND zahrnuje den odjezdu, Google ne. Parser to umí ošetřit.

Frekvence synchronizace

  • Ručně: klikněte na Sync kdykoli. Limit je 1 synchronizace za minutu na kalendář, takže to nepřehánějte.
  • Plánovaně: pokud má vaše prostředí nastavený cron, všechny kalendáře se synchronizují automaticky (obvykle každých pár hodin).
  • Realita: i kdyby Cabintale synchronizovalo každých 15 minut, Airbnb svůj iCal feed obnovuje jen každých 6–24 hodin. Booking.com je rychlejší (1–4 hodiny); Vrbo denně; Google nejblíž reálnému času. Synchronizace je jen tak čerstvá, jak čerstvý je zdroj.

Úprava nebo smazání zdroje

Kdykoli můžete upravit název, barvu i příznak aktivní; u příchozích kalendářů také URL. Vypnutím aktivní pozastavíte importy bez ztráty propojení. (Typ zdroje je pevně daný při vytvoření — viz poznámka v Kroku 3.)

Když kliknete na Smazat, otevře se modal s otázkou, co s rezervacemi, které k tomuto zdroji patří:

  • Ponechat rezervace (změnit zdroj na přímé) — zůstávají v Cabintale, ale už nejsou označené, že pocházejí z tohoto zdroje.
  • Smazat rezervace — odstraní se.

Minulé rezervace nelze smazat; vždy zůstávají (s přepnutým zdrojem na „přímé").

Přímý zdroj

V sekci Vlastní zdroje je vždycky řádek Přímé — zdroj pro rezervace, které přijdou přes widgety nebo administrační formulář (cokoli bez příchozího kalendáře nebo manuálního zdroje). Smazat ho nelze, ale přes ⋯ → Upravit mu můžete dát vlastní barvu, aby přímé rezervace v kalendáři vynikly.

Váš odchozí feed rezervací pro OTA je samostatný řádek v sekci Vaše exporty — viz Export iCal (Feed rezervací pro OTA).

Přiřazení zdroje k ručně vytvořené rezervaci

Když rezervaci vytváříte ručně (postranní nabídka → Místa → vaše nemovitost → Rezervace+ Nová rezervace, nebo kliknutím na datum v kalendáři), hlavička stránky má rozbalovátko Zdroj vedle Status výběru a tlačítka Uložit.

  • Přímé je předvybrané. Nechte tak pro rezervace, které přišly přes widget, telefonicky nebo jiným „výchozím" kanálem.
  • Manuální zdroje (např. Megaubytko, E-chalupy) jsou v rozbalovátku k výběru. Zvolte ten, odkud rezervace pochází.
  • iCal zdroje se v seznamu zobrazí s příponou „(iCal — automaticky)" ale jsou zakázané — vyplňuje je Cabintale přes synchronizaci, ručně přiřadit nelze.

Rezervace v kalendáři používá barvu zdroje a první písmeno jeho názvu jako avatar. Přímé rezervace mají uprostřed avataru malou bílou tečku místo písmena, ve značkové zelené.

Co když dva kalendáře pokrývají stejné datum?

Pokud dva iCal feedy hlásí rezervace na překrývajících se datech, vyhrává naposledy synchronizovaná. V praxi je to vzácné — pokud se to děje, něco je špatně na straně zdroje (například jste omylem připojili dva kalendáře téhož Airbnb listingu).

Řešení problémů

PříznakPříčinaŘešení
„Failed to fetch iCal. HTTP 404"URL je špatná, nebo platforma vygenerovala novou soukromou URLZkopírujte URL z platformy znovu; některé (zejména Booking.com) ji periodicky obměňují
„Rate limited by iCal provider"Příliš mnoho pokusů o synchronizaci v krátkém okněPočkejte 10–15 minut. Synchronizujte méně často
„This URL is blocked"URL míří na soukromou/lokální IP — Cabintale je blokuje, aby zabránila skenováníPoužijte veřejnou iCal URL platformy; soukromé/interní kalendářové servery nebudou fungovat
Rezervace se zobrazují o den vedleČasové pásmo feedu se neshoduje s nemovitostíZkontrolujte, že Časové pásmo vaší nemovitosti (Základní informace o nemovitosti) odpovídá skutečné poloze
První synchronizace ukazuje 0 vytvořeno, ale vím, že tam rezervace jsouFeed nemá VEVENT bloky (prázdný kalendář), nebo všechny události mají STATUS:CANCELLEDOtevřete iCal URL v prohlížeči — soubor by měl obsahovat řádky BEGIN:VEVENT. Pokud ne, problém je na straně zdroje
Smazal/a jsem iCal kalendář omylem a vybral/a „Smazat rezervace"Tahle volba je nevratná — rezervace jsou z Cabintale pryčiCal přidejte znovu — rezervace se znovu naimportují při příští synchronizaci, dokud jsou pořád ve zdrojovém feedu

Související návody

Nejde to?

Odpovídáme na každý e-mail do jednoho pracovního dne.

Napsat na podporu →