Dokumentace

Připojení Perly k webu vaší kliniky

Od registrace po živý chat na vašem webu. Krok za krokem, se snímky obrazovky a příklady pro každou běžnou platformu.

≈ 10 minutVývojáře nepotřebujete

Jak to funguje

Tři věci, které je dobré chápat, než něco vložíte.

Profil kliniky je zdroj pravdy

Hodiny, adresa, lékaři, služby s cenami, pojišťovny a pravidla předání recepci. Perla odpovídá pacientům výhradně z těchto dat a nic si nevymýšlí. Čím úplnější profil, tím přesnější odpovědi.

Klíč spojuje widget právě s vaší klinikou

Každá klinika má vlastní klíč ve tvaru pk_live_… Je veřejný: leží ve zdrojovém kódu webu, a to je v pořádku. Klíč umožňuje přesně jednu věc — vést chat jménem vaší kliniky, nic víc.

Widget je od vašeho webu izolovaný

Chat se načítá ve vlastním okně (iframe) z domény getperla.eu. Styly vašeho webu tedy nikdy nerozbijí chat a styly chatu se nikdy nedotknou vašeho webu. Jeden řádek kódu a hotovo.

Krok za krokem

Snímky ze skutečného rozhraní. Oranžově je vyznačeno, kam kliknout.

01

Klikněte na „Začít zdarma“

Otevřete getperla.eu a klikněte na tlačítko v pravém horním rohu. Na začátku nepotřebujete kartu.

Klikněte na „Začít zdarma“
Hlavní stránka Perly — tlačítko registrace je vpravo nahoře.
02

Vytvořte účet kliniky

Zadejte název kliniky, pracovní e-mail a heslo alespoň o 8 znacích. Název se pak objeví v záhlaví chatu, který vidí pacienti — napište ho tak, jak ho chcete lidem ukázat.

Vytvořte účet kliniky
Registrační formulář: název kliniky, e-mail, heslo.
03

Vyplňte profil a zkopírujte klíč

Po přihlášení se dostanete do Přehledu. Projděte čtyři body checklistu — profil, otevírací dobu, lékaře, služby a ceny. Pak sjeďte na konec stránky: tam najdete blok Integrační klíč. Klikněte na Kopírovat.

Vyplňte profil a zkopírujte klíč
Dashboard → Přehled. Klíč je na konci stránky.

Vyplňte profil před spuštěním

Pokud je ceník nebo otevírací doba prázdná, Perla pacientovi poctivě řekne, že cenu upřesní recepce — místo aby si číslo vymyslela. To je správné chování, ale mnohem lepší výsledek dostanete s kompletním profilem.

Vložení kódu na web

Vyberte svou platformu a ukážu vám přesně, kam kód patří.

Vaše platforma

  1. 1Otevřete soubor stránky — obvykle index.html nebo sdílenou šablonu (footer, layout).
  2. 2Vložte kód přímo před uzavírací tag </body>.
  3. 3Pokud máte více stránek a žádnou sdílenou šablonu, přidejte kód na každou stránku.
  4. 4Uložte a nahrajte soubory na hosting.
  5. Máte-li sdílený soubor patičky, vložte ho tam jednou a chat se objeví všude.
index.html
<!-- Perla -->
<script
  src="https://getperla.eu/widget.js"
  data-perla-key="pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
  defer
></script>

Nahraďte pk_live_… klíčem ze svého dashboardu. Stejný kód patří na každou stránku webu.

Parametry widgetu

Nastavuje se přímo v tagu skriptu.

AtributPovinnýCo dělá
data-perla-keyAnoKlíč vaší kliniky z dashboardu. Bez něj se widget nespustí.
data-perla-langNeJazyk rozhraní chatu: uk, cs, en, ru nebo de. Když ho neuvedete, použije se první jazyk z profilu kliniky. Na samotné odpovědi to nemá vliv — Perla vždy odpovídá jazykem, kterým píše pacient.
deferNeDoporučujeme ponechat. Widget se pak načte až po hlavním obsahu a nezpomalí vykreslení stránky.

Ověření, že to funguje

Tři minuty po vložení kódu.

  1. 1

    Tlačítko se objevilo

    Otevřete web kliniky na nové kartě. V pravém dolním rohu by se mělo objevit kulaté tlačítko s robotem. Pokud jste kód právě vložili, obnovte stránku přes Ctrl+Shift+R (Cmd+Shift+R na Macu).

  2. 2

    Chat odpovídá vašimi daty

    Klikněte na tlačítko a zeptejte se na něco z vašeho profilu: „Kolik stojí dentální hygiena?“ nebo „Máte otevřeno v sobotu?“. Odpověď se musí shodovat s tím, co jste vyplnili.

  3. 3

    Konverzace se objevila v dashboardu

    Vraťte se do dashboardu, sekce Konverzace. Váš testovací rozhovor tam má být. Zkuste se také objednat — uveďte jméno a telefon, a na stejném místě se objeví žádost o termín.

Co Perla umí a co ne

Na rovinu, aby před pacienty nebyla žádná překvapení.

Funguje už teď

  • Odpovídá na dotazy na ceny, otevírací dobu, adresu, lékaře a pojišťovny — z vašeho profilu
  • Mluví jazykem pacienta: ukrajinsky, česky, anglicky, rusky, německy
  • Sbírá žádost o termín: jméno, telefon a přibližný čas, a ukáže ji v dashboardu
  • Předá konverzaci recepci podle vašich vlastních pravidel — třeba při akutní bolesti či stížnosti
  • Běží nepřetržitě, včetně nocí a víkendů, kdy je recepce zavřená

Zatím neumí

  • Nezapisuje pacienta přímo do kalendáře — žádost potvrzuje člověk telefonicky
  • Nestanovuje diagnózy ani nedoporučuje léčbu: to je práce lékaře, ne recepce
  • Neuvede cenu, která ve vašem ceníku není — místo toho řekne, že ji upřesní recepce
  • Nepřijímá platby online

Časté dotazy

Je bezpečné mít klíč ve zdrojovém kódu webu?+

Ano. pk_live_… je veřejný klíč a má být ve zdroji stránky vidět, stejně jako klíč Google Maps nebo Stripe. Umožňuje přesně jednu věc: vést chat jménem vaší kliniky. Přečíst vaše konverzace, změnit profil nebo se dostat do dashboardu s ním nelze. Navíc platí limit počtu zpráv za minutu, aby ho nikdo nemohl zneužít.

Zpomalí widget můj web?+

Ne. Soubor má několik kilobajtů a načítá se s atributem defer — tedy až poté, co se stránka návštěvníkovi vykreslila. Samotný chat se načítá ve zvláštním okně a váš web nikdy neblokuje.

Widget se neobjevil. Co teď?+

Zkontrolujte tři věci. Zaprvé: kód musí být před uzavíracím tagem </body>, ne v HEAD. Zadruhé: na Tildě a Webflow je nutné web po uložení kódu zvlášť publikovat. Zatřetí: obnovte stránku s vymazáním cache (Ctrl+Shift+R). Pokud to nepomůže, otevřete konzoli prohlížeče (F12) a hledejte zprávu začínající [Perla].

Můžu změnit barvu tlačítka?+

Ano. V dashboardu otevřete sekci Widget a vyberte barvu — z palety nebo vlastní. Na webu se projeví okamžitě, kód měnit nemusíte.

Můžu dát widget na několik webů jedné kliniky?+

Ano, jeden klíč funguje na libovolném počtu stránek i domén. Všechny konverzace se sejdou v jednom dashboardu.

Kde se ukládají data pacientů?+

Konverzace a žádosti o termín se ukládají na serverech v Evropské unii. Perla si od pacienta nikdy nežádá číslo karty, doklady ani zdravotní historii — jen jméno a telefon pro zpětné zavolání.

Něco nesedí?

Napište nám — vyřešíme to společně a v případě potřeby widget nasadíme za vás.