Chatbot Builder - Nápověda

Chatbot Builder - Nápověda

Kompletní průvodce pro vytváření AI chatbotů z různých dokumentů a webových zdrojů

📖

Přehled

Chatbot Builder (Chatbotty.ai) je Redis Cache optimalizovaná platforma pro vytváření AI chatbotů z různých dokumentů a webových zdrojů. Slouží všem, kdo potřebují poskytovat kvalitní odpovědi na dotazy uživatelů na základě aktuálních dokumentů a zdrojů - úřadům, organizacím, podnikatelům i jednotlivcům.

✨ Klíčové funkce

🤖 AI a zpracování

  • • AI chatboty z různých dokumentů a webových zdrojů
  • • Inteligentní AI routing pro optimální kvalitu odpovědí
  • • Vektorová databáze pro sémantické vyhledávání
  • • Pokročilé chunking podle typu dokumentů

⚡ Výkon a spolehlivost

  • • Multi-level caching (Memory → Redis → PostgreSQL)
  • • Asynchronní widget bez vlivu na rychlost stránky
  • • Ochrana proti zneužití a bot útokům
  • • Flexibilní rate limity pro jednotlivé chatboty

📊 Správa a analytika

  • • Rozsáhlé možnosti personalizace a nastavení
  • • Automatické přepsání dokumentů novými verzemi
  • • Analytika v reálném čase a optimalizace kvality
  • • Automatické subscription a tier management

🎯 Ideální pro

  • Úřady a veřejné instituce

    Automatizace informačních služeb pro občany, odpovědi na časté dotazy o úředních postupech

  • E-commerce a online služby

    Inteligentní zákaznická podpora bez call center, řešení objednávek a reklamací

  • Firmy s rozsáhlou dokumentací

    Rychlé vyhledávání v interních zdrojích, onboarding nových zaměstnanců

  • Vzdělávací instituce

    Podpora studentů a odpovědi na časté dotazy, informace o studijních programech

  • Zdravotnická zařízení

    Informace pro pacienty a administrativní podpora, návody pro pacienty

  • Právnické kanceláře

    Rychlý přístup k právním dokumentům a precedentům, analýza právních případů

  • IT a technologické firmy

    Automatizace technické podpory a API dokumentace, řešení běžných problémů

  • Konzultační společnosti

    Sdílení odborných znalostí a best practices, interní knowledge base

  • Marketingové agentury

    Analýza zákaznických potřeb a optimalizace obsahu, creative brief asistence

🚀

Začínáme

🎯 Rychlý průvodce

  1. 1
    Registrace a přihlášení

    Vytvořte si účet. Automaticky získáte Evaluation tier na 14 dní s 3 000 zprávami/měsíc (více než Elite 500) a všemi Elite funkcemi.

  2. 2
    Vytvoření prvního chatbota

    Klikněte na "Nový Chatbot" → zadejte název a popis → zvolte response style (formální/přátelský/profesionální). Po vytvoření budete přesměrováni do detailního nastavení, kde můžete přizpůsobit všechny parametry chatbota podle vašich potřeb.

  3. 3
    Nahrání dokumentů

    Drag & drop PDF/DOCX/TXT/MD soubory nebo zadejte URL webové stránky. Můžete zvolit typ dokumentu pro optimální chunking strategii (právní, technický, akademický, zpravodajský, obecný).

  4. 4
    Testování a embedding

    Otestujte chatbota v preview módu → zkopírujte embed kód → vložte na váš web

⚡ Rychlé tipy pro začátek

📄 Příprava dokumentů

  • Struktura: Používejte jasné nadpisy, odrážky a číslování
  • Formát: PDF s čitelným textem (ne skenované obrázky)
  • Velikost: Velikost souboru ovlivňuje rychlost zpracování
  • Obsah: Odstraňte duplicity a irelevantní části
  • Jazyk: Konzistentní terminologie a stylistika
  • Metadata: Jasné názvy souborů pro lepší organizaci
  • Aktuálnost: Používejte nejnovější verze dokumentů

🎨 Widget Integrace

Jednoduchá integrace pomocí JavaScript kódu:

<script 
  src="https://chatbotty.cz/chatbot-embed.js"
  data-chatbot-id="xxxxxxxx">
</script>
  • • Asynchronní načítání bez blokování stránky
  • • Cross-domain podpora
🤖

Správa Chatbotů

➕ Vytváření Chatbotů

🎯 Základní konfigurace

Základní informace:

  • Název chatbota: Identifikace vašeho chatbota
  • Popis: Stručný popis účelu chatbota
  • Styl odpovědi: Formální / Přátelský / Profesionální / Neformální

🎨 Vzhled

Přizpůsobení vzhledu chatbot widgetu:

  • Barva tématu: Výběr z přednastavených barev
  • Úvodní zpráva: Text pro první kontakt s uživatelem
  • Chybová zpráva: Text zobrazený při nedostupnosti chatbota
  • Povolené domény pro embedding: Určení, kde může být widget použit

💎 Maximální počet chatbotů podle tarifů

Free

1 chatbot

Evaluation

1 chatbot

14 dní trial

Basic

1 chatbot

Elite

2 chatboti

Enterprise

3 chatboti

🗑️ Potvrzení smazání

⚠️

Ochrana proti smazání

Při mazání chatbota se zobrazí potvrzovací dialog pro prevenci náhodného smazání. To zajišťuje, že nepřijdete o důležitá data omylem.

⚠️ Varování:

Všechna data chatbota, dokumenty a analytiky budou trvale odstraněny a nelze je obnovit.

🔧

Pokročilá nastavení chatbota

🧠 AI Chování a Prompty

📝 Systémové instrukce

Definují osobnost a chování AI asistenta. Obsahuje pokyny pro:

  • • Styl komunikace a tón odpovědí
  • • Obecné chování a pravidla
  • • Kritické instrukce pro omezení
🏷️ Dostupné zástupné značky

Následující zástupné značky lze použít v instrukcích a sděleních:

  • {current_datetime} - Aktuální datum a čas
  • {chatbot_id} - Jedinečný identifikátor chatbota
  • {fallback_message} - Vlastní záložní sdělení když není nalezena odpověď

⚡ Vyhledávání a kvalita odpovědí

🔍 Parametry vyhledávání

  • Práh podobnosti (0.4): Minimální shoda pro použití dokumentu
  • Počet úseků dokumentů v kontextu (5): Kolik úseků dokumentů AI dostane
  • Smart Model Routing: Automaticky vybírá vhodnější model na základě složitosti dotazu
  • Automatické support tickety: Když AI nedokáže odpovědět, nabídne vytvoření support ticketu. Vyžaduje souhlas uživatele a e-mail.
  • Force Fallback: Při zapnutí vždy zobrazí záložní zprávu pro dotazy s nízkou relevancí dokumentů. Při vypnutí AI odpovídá i bez relevantních dokumentů (konverzační režim).

⚙️ Jazykové preference a AI parametry

  • Jazyk odpovědi chatbota: Jazyk, ve kterém bude chatbot odpovídat
  • Časové pásmo: Pro odpovědi o aktuálním datu a času
  • Kreativita (Temperature): 0.0 = přesné, 1.0 = kreativní odpovědi
  • Maximální délka odpovědi (tokeny): Limit v tokenech (≈ 375 slov pro 500 tokenů)

🛡️ Antispam ochrana

  • Max požadavků/den: Maximální počet požadavků z jedné IP adresy za 24 hodin (anti-bot ochrana)
  • Max požadavků/session: Maximální počet požadavků za session (2 hodinové okno pro prevenci zneužití)
  • Rate Limit za minutu: Ochrana proti spam dotazům
  • Cache TTL (sekundy): Jak dlouho cachovat odpovědi

🔄 Obnovení výchozích hodnot

🔄

Obnovení výchozího nastavení

Tlačítko 'Obnovit výchozí' obnoví všechna pokročilá nastavení na výchozí hodnoty. Před obnovením se zobrazí potvrzovací dialog pro prevenci náhodných změn.

ℹ️ Poznámka:

Nastavení můžete kdykoliv obnovit na výchozí hodnoty, pokud chcete začít znovu nebo pokud něco nefunguje podle očekávání.

📄

Správa Dokumentů

📤 Nahrávání souborů

📋 Podporované zdroje

📄

Soubory

PDF, DOCX, TXT, MD, HTML

Elite+
🌐

Web URL

Automatický scraping

🔄

Aktualizace

Automatické přepsání verzí

🎯 Optimální příprava dokumentů

✅ Doporučené praktiky:

  • • Jasné nadpisy a struktura
  • • PDF s čitelným textem (ne obrázky)
  • • Konzistentní formátování
  • • Logické číslování sekcí

❌ Vyhněte se:

  • • Scannované obrázky bez OCR
  • • Přílišná fragmentace textu
  • • Nekonzistentní formátování
  • • Soubory větší než 10MB

💾 Limity podle tarifů

Free

10MB celkem

Evaluation

20MB celkem

Basic

10MB celkem

Elite

20MB celkem

Enterprise

50MB celkem

📋 Detekce duplicit

📋

Inteligentní správa duplicit

Při nahrávání dokumentu se stejným názvem jako existující se zobrazí potvrzovací dialog s možnostmi pro prevenci náhodného přepsání.

Dostupné možnosti:

  • Nahradit: Přepíše existující dokument novou verzí
  • Ponechat oba: Ponechá obě verze (nový soubor dostane číselnou příponu)

📄 Postup nahrání dokumentu

1

Vybrat chatbot

Zvolte chatbot, ke kterému bude dokument přiřazen

2

Vybrat způsob nahrání

📎 Soubory (PDF, DOCX, TXT, MD)

Maximálně 10 MB na soubor

Elite+

🌐 Web URL

Automatický scraping webových stránek

3

Vybrat typ dokumentu

Systém automaticky optimalizuje zpracování podle typu:

⚖️

Právní dokument:

Zákony, nařízení, smlouvy

🔧

Technický manuál:

Návody, specifikace, postupy

📰

Zpravodajství:

Články, tiskové zprávy

🎓

Akademický text:

Vědecké práce, studie

📄

Obecný dokument:

Univerzální nastavení

4

Popsat dokument (volitelné)

Přidejte popis pro snadnou budoucí orientaci v seznamu dokumentů

💡

Tip pro aktualizaci souborů

Při zadání stejného názvu dokumentu máte možnost automatického přehrání původní verze bez nutnosti mazání zastaralého dokumentu. Vaše data budou stále aktuální.

💬

Chat Widget

🔧 Embedding na web (zobrazení chatbota na vašich webových stránkách)

📋 Získání embed kódu

Embed kód najdete u každého chatbota v kontextovém menu (tři tečky). Klikněte na "Kopírovat embed kód" a vložte ho na svou webovou stránku před uzavírací </body> tag.

<script 
  src="https://chatbotty.cz/chatbot-embed.js"
  data-chatbot-id="xxxxxxxx">
</script>

💡 Tip: Widget se načte asynchronně a neovlivní rychlost vaší stránky. Chatovací bublina se zobrazí, jakmile je konfigurace načtena na pozadí.

🔴 Poznámka: Pokud je chatbot deaktivovaný, widget se na webu nezobrazí vůbec.

⚠️ Instalace přes GTM: Pokud vkládáte widget přes Google Tag Manager a návštěvník odmítne cookies, GTM se nenačte a chatbot se nezobrazí. Doporučujeme vkládat kód přímo do HTML, mimo GTM.

⚙️ Konfigurace widgetu

Widget můžete plně přizpůsobit v sekci "Vzhled" při editaci chatbota. Všechna nastavení se aplikují automaticky do embed kódu.

🎨 Vzhled a pozice:

  • Barva tématu: 6 přednastavených barev (modrá, červená, zelená, žlutá, fialová, oranžová)
  • Pozice widgetu: Vpravo dole / Vlevo dole
  • Úvodní zpráva: Přivítání uživatelů
  • Fallback zpráva: Text pro případy, kdy chatbot nezná odpověď na dotaz

⚙️ Chování chatbota:

  • Název chatbota: Zobrazí se v hlavičce
  • Popis: Krátký popis účelu chatbota (nezobrazuje se na webu)
  • Styl odpovědí: Profesionální, přátelský, formální
  • Status: Aktivní/neaktivní chatbot

🎯 Přizpůsobení widgetu

Možnosti pozice:

  • • Vpravo dole (výchozí)
  • • Vlevo dole

Efekty bubliny:

  • Pulzující efekt - Animovaná bublina pro přilákání pozornosti (lze zapnout/vypnout)

👁️ Náhled widgetu

Použijte modální okno s náhledem widgetu pro otestování chatbota před vložením:

  • • Klikněte na tlačítko "Náhled" v nastavení chatbota
  • • Otevře widget v modálním okně
  • • Otestujte všechny funkce a vzhled
  • • Není potřeba instalovat kód

🔗 Veřejná stránka widgetu

Přístup k vašemu widgetu na: /widget-embed/[widgetId]

  • • Samostatná stránka pro testování
  • • Lze sdílet s členy týmu
  • • Není vyžadována integrace na web

💡 Tip: Veškeré změny se projeví okamžitě na všech webech s embedovaným widgetem. Není potřeba měnit kód.

⚡ Výkonnostní optimalizace

🚀 Asynchronní načítání

  • • Asynchronní načítání na pozadí
  • • Bublina se zobrazí po načtení konfigurace
  • • Nulový vliv na rychlost hlavní stránky
  • • Postupné vylepšování

💾 Inteligentní cache

  • 90%+ úspěšnost cache
  • • 5minutová platnost konfigurace
  • • Rychlé načítání přes Redis
  • • Plynulé fungování i při výpadku Redis Cache

🔒 Bezpečnost a omezení

🌐 Domain restrictions

Omezte přístup pouze na povolené domény:

Příklad nastavení:

  • • example.com
  • • *.example.com (včetně subdomén)

🛡️ Antispam ochrana

Nastavení limitů požadavků pro ochranu před spamem a zneužitím

Max požadavků/den

50

Maximální počet požadavků z jedné IP adresy za 24 hodin (anti-bot ochrana)

Max požadavků/session

20

Maximální počet požadavků za session (2 hodinové okno pro prevenci zneužití)

Limit požadavků/min

10

🛡️ Ochrana proti spam dotazům

Cache TTL (sekundy)

300

⚡ Jak dlouho cachovat odpovědi

📝 Poznámka:

Tyto parametry jsou plně uživatelský nastavitelné v pokročilých nastaveních každého chatbota pro maximální flexibilitu.

📊

Analytika

🎯 Přístup podle tarifů

🆓 Free

Žádný přístup

Upgrade popup s návodem

⭐ Evaluation

Plný přístup

14 dní Elite-level funkcí

🔵 Basic

Základní metriky

  • • Počty zpráv
  • • Top queries
  • • Chatbot stats

👑 Elite+

Detailní analytika

  • • Míra úspěšnosti
  • • Export dat
  • • Detailní reporty
  • • Interaktivní prostředí
  • • Analytika pro každý chatbot zvlášť

🤖 Detailní analytika chatbotůElite+

📋 Zobrazení pro každý chatbot

  • Individuální přehled: Samostatná analytika pro každý chatbot
  • Filtrování dotazů: Zobrazení pouze relevantních konverzací
  • Izolované metriky: Výkony jednotlivých chatbotů odděleny
  • Srovnání chatbotů: Možnost porovnat výkon různých botů

🔍 Detailní zobrazení dotazů

  • Úplný dotaz: Zobrazení celé otázky od uživatele
  • Spolehlivost odpovědi: Přesná hodnota confidence skóre
  • Odpověď AI: Kompletní text odpovědi chatbota
  • Časové razítko: Datum a čas každého dotazu

💡 Praktické využití: Umožňuje přesnou analýzu toho, jak jednotlivé chatboty odpovídají na dotazy uživatelů, identifikaci problémových oblastí a optimalizaci dokumentů pro každý chatbot samostatně.

📈 Dostupné metriky

🎯 Hlavní KPIs

📊
Celkem dotazů
Počet všech zpráv za období
Úspěšnost
Procento plných odpovědí
⚠️
Částečné odpovědi
Procento částečných odpovědí
📈
Průměrná spolehlivost
Skóre podobnosti s dokumenty

📊 Kvalita odpovědí

✅ OdpovězenoXX%
Plná odpověď nalezena
⚠️ ČástečnéXX%
Částečná odpověď
❌ Bez odpovědiXX%
Odpověď nenalezena

⚠️ Omezení historie dat podle tarifu

Zachovávají se data odpovídající maximálnímu počtu dotazů za měsíc podle vašeho tarifu. Starší data jsou automaticky mazána pro optimalizaci výkonu databáze.

  • Free: 200 dotazů
  • Basic: 3000 dotazů
  • Elite: 6000 dotazů
  • Enterprise: 10000 dotazů

📤 Export a reporty

📋 Dostupnost: Export funkcionalita je dostupná pouze pro Elite+ tarify (Elite a Enterprise).

💡 Tip: Doporučujeme export dat k poslednímu dni každého měsíce pro možnost sledování plné historie dotazů zákazníků.

💾 Export formáty

  • CSV: Tabulková data pro Excel
  • JSON: Strukturovaná data pro API

🔍 Filtry dat

🕐 Časové filtry:

  • Tento týden: Posledních 7 dní
  • Tento měsíc: Aktuální měsíc
  • Tento rok: Aktuální rok

📋 Filtry podle odpovědí:

  • Všechny dotazy: Kompletní historie
  • ✓ Zodpovězeno: Úspěšné odpovědi
  • ⚠ Částečně odpovězeno: Nekompletní odpovědi
  • ✗ Neodpovězeno: Bez odpovědi
💎

Předplatné

🎯 Přehled tarifů

Current

Free

Perfect for getting started

$0/month

10MB storage

1 chatbot

100 requests/month

Basic support

✅ Conversation history

❌ Basic analytics

❌ Web URL scraping

❌ Analytics export

❌ API access

❌ Support tickets

❌ Webhook actions

❌ White-label branding

➕ Buy extra requests

Trial

Evaluation

14-day trial with Enterprise features

$0/month

10MB storage

1 chatbot

500 requests/month

✅ Conversation history

✅ Detailed analytics

✅ Web URL scraping

✅ Analytics export

✅ API access

✅ Support tickets (AI)

✅ Webhook actions (n8n)

❌ White-label branding

➕ Buy extra requests

Auto-downgrade to Free

Basic

For growing businesses

$15/month

25MB storage

1 chatbot

3000 requests/month (total)

Priority support

✅ Conversation history

✅ Basic analytics

❌ Web URL scraping

❌ Analytics export

❌ API access

❌ Support tickets

❌ Webhook actions

❌ White-label branding

➕ Buy extra requests

Popular

Elite

Most popular

$30/month

50MB storage

2 chatbots (max)

6000 requests/month (total)

Priority support

✅ Conversation history

✅ Detailed analytics

✅ Web URL scraping

✅ Analytics export

✅ API access

❌ Support tickets

❌ Webhook actions

❌ White-label branding

➕ Buy extra requests

Enterprise

Custom solutions

$50/month

100MB storage

3 chatbots (max)

10000 requests/month (total)

Premium support

✅ Conversation history

✅ Detailed analytics

✅ Web URL scraping

✅ Analytics export

✅ API access

✅ Support tickets (AI)

✅ Webhook actions (n8n)

✅ White-label branding

➕ Buy extra requests

💡 Datové využití

10MB dat odpovídá přibližně 1000 stránkám PDF dokumentu. V čistě textových formátech dokonce mnohem více.

Upozornění: Do datových limitů se započítává původní velikost nahrávaného souboru. Vložené obrázky v dokumentech mohou výrazně navýšit velikost nahrávaného souboru.

💰 Roční předplatné

Při ročním předplatném ušetříte 2 měsíce – platíte pouze za 10 měsíců!

Roční fakturace nabízí významné úspory oproti měsíčnímu placení. Můžete kdykoliv změnit fakturační období nebo předplatné.

⏰ Vypršení zkušební doby

  • • Automatický downgrade po 14 dnech na tarif Free
  • • Plynulý přechod bez ztráty dat

📊 Sledování využití

📊 Sledování v dashboardu

Sledujte využití vašich tarifů přímo v reálném čase:

📈 Měsíční limity
  • • Počet zpráv za měsíc
  • • Prognoza do konce měsíce
  • • Automatické resetování každý měsíc
📋 Trvalé limity
  • • Úložná kapacita (MB/MB)
  • • Počet chatbotů (číslo/limit)
📊 Statistiky
  • • Celkem vytvořených chatbotů
  • • Aktivní a funkční chatboti
  • • Celkem dotazů od uživatelů
  • • Nahraných dokumentů
📈 Vizualizace
  • • Barevné progress bary
  • • Sledování v reálném čase

⚠️ Vynucování limitů

  • Překročení úložiště: Upload blokován s upgrade promptem
  • Limit chatbotů: Vytváření blokováno, zobrazí se upgrade dialog
  • Měsíční zprávy: Widget se nenačte (tiché selhání)
  • Přístup k analytice: Omezení funkcí podle tarifu

💰 Přídavné zprávy a doplňky

Přídavné zprávy jsou dodatečné balíčky zpráv, které si můžete zakoupit pro rozšíření vašeho měsíčního limitu. Na rozdíl od měsíčního předplatného přídavné zprávy nikdy nevyprší a přetrvávají napříč fakturačními cykly.

🔄 Jak to funguje:

  1. Nejprve se spotřebovává váš měsíční limit
  2. Když je měsíční limit vyčerpán, automaticky se použijí přídavné zprávy
  3. Přídavné zprávy přetrvávají, dokud nejsou plně spotřebovány (bez vypršení)
  4. Zobrazují se v dashboardu s sledováním v reálném čase

📦 Dostupné balíčky:

💡 Kdy koupit:

  • Sezónní špičky návštěvnosti
  • Speciální kampaně
  • Testování před upgradem
  • Jednorázové vysoké využití

💳 Nákup:Klikněte na "Koupit přídavné zprávy" v dashboardu nebo v kartě sledování využití při blížení se k limitu.

📄

Faktury

📋 Přehled

Všechny faktury a historii plateb najdete přímo v zákaznickém portálu. Jsou tam předplatná, nákupy doplňků i veškeré minulé platby.

🔗 Jak se dostat k fakturám

  1. Přejděte do sekce Předplatné v bočním panelu
  2. Klikněte na tlačítko Manage Subscription
  3. Budete přesměrováni do zákaznického portálu, kde najdete všechny faktury a historii plateb
⚙️

Nastavení

👤 Správa uživatelského účtu

📝 Změnit jméno

Osobní údaje

  • Jméno: Zobrazované uživatelské jméno
  • • Lze změnit kdykoliv
  • • Zobrazuje se v profilu a komunikaci

📧 Změnit e-mail

Po odeslání nové adresy budou potvrzovací odkazy zaslány do obou e-mailových schránek — stávající i nové. Změna se projeví až po kliknutí na oba odkazy.

  • • Zkontrolujte stávající schránku a potvrďte odkaz
  • • Zkontrolujte novou schránku a potvrďte odkaz
  • • Teprve po obou potvrzeních se nový e-mail stane aktivním

🔒 Změnit heslo

Heslo musí mít alespoň 6 znaků

Požadavky na heslo:

  • • Minimálně 6 znaků
  • • Kombinace písmen a čísel
  • • Současné heslo potřebné

Zapomenuté heslo:

  • • Reset přes e-mail
  • • Bezpečný reset link
  • • Okamžité doručení

🌐 Nastavení jazyka

Přepínání mezi anglickým a českým rozhraním

  • • Klikněte na výběr jazyka v horní navigaci
  • • Dostupné jazyky: Angličtina (EN) / Čeština (CS)
  • Automatické obnovení stránky - Stránka se automaticky obnoví po změně jazyka pro aplikaci všech překladů
  • • Jazyková preference je uložena k vašemu účtu

⚠️ Nebezpečná zóna

Akce v této sekci jsou nevratné. Postupujte opatrně.

⚠️ Smazáním účtu se trvale odstraní všechny vaše data, chatboty, dokumenty a konverzace. Tato operace je nevratná.

Tlačítko "Smazat účet" spustí úplné odstranění všech dat z databáze.

🔗

API

🚀 Programový přístup k chatbotům

💎 Dostupnost pro vyšší tarify

API přístup je k dispozici pro uživatele s tarifem Evaluation, Elite a Enterprise. Umožňuje vám integrovat vaše chatboty do vlastních aplikací, webových stránek nebo systémů.

📋 Co získáte

  • REST API: Standardní HTTP požadavky
  • Příklady kódu: JavaScript, Python, PHP, Node.js
  • Chatbot ID: Jedinečný identifikátor pro každý chatbot
  • Kompletní dokumentace: Přímo v aplikaci

💡 Jak na to: Po přihlášení do aplikace najdete v menu sekci "API Integrace", kde najdete detailní návod včetně příkladů připojení pro různé programovací jazyky a testovací příklady.

🔐 Autentizace API

Jak to funguje

API přístup používá autentizaci pomocí Bearer tokenu. Každý API klíč je vázán na konkrétní chatbot.

  1. Vytvořte API klíč v Dashboardu → API integrace pro váš chatbot
  2. Zahrňte API klíč v Authorization headeru jako Bearer token
  3. Pošlete POST request na /api/chat endpoint
  4. Chatbot je automaticky identifikován z API klíče

Důležité: NEMUSÍTE posílat chatbot_id v těle requestu. Chatbot je určen z vašeho API klíče.

🔑 Správa API klíčů

Vytvoření API klíčů

Generujte zabezpečené API klíče pro programový přístup k vašim chatbotům.

Funkce:

  • Vlastní názvy - Označte klíče pro snadnou identifikaci
  • Max 50 klíčů - Limit na chatbot
  • Zabezpečené tokeny - Celý token se zobrazí pouze jednou při vytvoření
  • Sledování aktivity - Časová značka posledního použití
  • Přepínání aktivní/neaktivní - Dočasné zákázání bez odstranění

Zabezpečení:

  • • Tokeny jsou maskované v UI (zobrazují se pouze první/poslední znaky)
  • • Zkopírovat do schránky pro snadné použití
  • • Okamžitě smazat kompromitované klíče

Použití:

Zahrňte API klíč jako Bearer token v hlavičce Authorization:

Authorization: Bearer your-api-key-here

⚡ Měsíční kvóta: Využití API se započítává do vašeho měsíčního limitu zpráv. Při překročení kvóty lze zakoupit další zprávy.

💻 Příklady kódu

JavaScript (Prohlížeč)

// 1. první dotaz – bez conversation_id
const response = await fetch('https://chatbotty.cz/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VÁŠ_API_KLÍČ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Jaká je vaše reklamační politika?'
    // conversation_id není potřeba – vytvoří se automaticky
  })
})

const result = await response.json()
const conversationId = result.data.conversation_id // uložit pro navazující dotazy

// 2. navazující dotaz – kontext předchozích zpráv bude načten
const response2 = await fetch('https://chatbotty.cz/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VÁŠ_API_KLÍČ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'A jak je to s výměnou zboží?',
    conversation_id: conversationId
  })
})

Node.js

const response = await fetch('https://chatbotty.cz/api/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer VÁŠ_API_KLÍČ',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Jaká je vaše reklamační politika?',
    conversation_id: conversationId // volitelné: pro pokračování konverzace
  })
})

const result = await response.json()
console.log(result.data.message)
// result.data.conversation_id – uložte pro navazující dotazy

Python

import requests

response = requests.post(
    'https://chatbotty.cz/api/chat',
    headers={
        'Authorization': 'Bearer VÁŠ_API_KLÍČ',
        'Content-Type': 'application/json'
    },
    json={
        'message': 'Jaká je vaše reklamační politika?',
        'conversation_id': conversation_id  # volitelné: pro pokračování konverzace
    }
)

result = response.json()
print(result['data']['message'])

PHP

<?php
$ch = curl_init('https://chatbotty.cz/api/chat');

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer VÁŠ_API_KLÍČ',
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'message' => 'Jaká je vaše reklamační politika?',
    'conversation_id' => $conversationId // volitelné: pro pokračování konverzace
]));

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
echo $result['data']['message'];
?>

cURL

curl -X POST https://chatbotty.cz/api/chat   -H "Authorization: Bearer VÁŠ_API_KLÍČ"   -H "Content-Type: application/json"   -d '{"message": "Jaká je vaše reklamační politika?"}'

📋 Formát odpovědi

Úspěšná odpověď

{
  "success": true,
  "data": {
    "message": "Text odpovědi AI...",
    "conversation_id": "550e8400-e29b-41d4-a716-446655440000",
    "sources": [
      {
        "content": "Relevantní úryvek z dokumentu...",
        "similarity": 0.95,
        "page": 1
      }
    ],
    "metadata": {
      "tokensUsed": 150,
      "cached": false,
      "responseTime": 1234,
      "searchResults": 3
    }
  },
  "timestamp": "2025-01-28T10:00:00.000Z"
}

Chybová odpověď

{
  "success": false,
  "error": "Internal server error",
  "timestamp": "2025-01-28T10:00:00.000Z"
}

⚠️ Důležité poznámky

  • API klíče jsou specifické pro chatbot - Každý klíč funguje pouze s jedním chatbotem
  • Až 50 klíčů na chatbot - Vytvořte více klíčů pro různé aplikace
  • Klíče lze deaktivovat - Dočasně vypnout bez smazání
  • Platí měsíční kvóta - Omezeno měsíčním limitem zpráv podle tarifu + zakoupené extra zprávy
  • Žádné omezení rychlosti - API je navrženo pro programový přístup bez limitů požadavků
  • Žádná validace domén - API funguje z jakéhokoliv zdroje (používejte opatrně)
  • Kontext konverzace - Každá odpověď vrací conversation_id. Pro navazující dotazy ho přidejte do dalšího požadavku – systém automaticky načte historii posledních 20 zpráv. Bez conversation_id je každý požadavek samostatná nová konverzace bez kontextu – to je v pořádku, pokud nepotřebujete pamatovat předchozí dotazy (např. jednorázové vyhledávání v datech).
  • Zabezpečte své klíče - Nikdy nezveřejňujte API klíče v klientském kódu
💬

Konverzace

📝 Jak to funguje

Funkce Historie konverzací automaticky zaznamenává všechny relace chatbota s komplexními metadaty pro analytiku, compliance a zajištění kvality.

  • Logování relací: Každá konverzace je zaznamenána s unikátním ID relace
  • Sledování metadat: IP adresa, URL stránky, referrer, user agent
  • Časová razítka: Přesné časování každé výměny zpráv
  • Kontaktní údaje: Uživatelem poskytnutý email a jméno, pokud je k dispozici

🔍 Zobrazení konverzací

Přístup k historii konverzací z Dashboard → Konverzace v hlavním menu.

Dostupné filtry:

  • Období: Filtrovat podle časového období (tento měsíc, posledních 7 dní atd.)
  • Filtr (Chatbot): Zobrazit konverzace konkrétního chatbota nebo všech
  • Zdroj: Filtrovat podle zdroje (widget, API atd.)

Zobrazené sloupce:

  • • ID relace, Datum/Čas, Název chatbota
  • • Počet zpráv, Zdroj, Kontaktní email
  • • IP adresa (anonymizovaná), URL stránky

📋 Detail konverzace

Klikněte na jakoukoliv konverzaci pro zobrazení kompletní historie zpráv s detailními informacemi.

  • Časová osa zpráv: Všechny otázky uživatele a odpovědi AI
  • Časová data: Přesná časová razítka pro každou zprávu
  • Metadata zdroje: URL stránky, referrer, user agent
  • Kontaktní informace: Email a jméno, pokud je uživatel poskytl

💡 Tip: Využijte historii konverzací k identifikaci často kladených otázek a vylepšení znalostní báze vašeho chatbota. Vzorce v dotazech uživatelů vám pomohou přidat chybějící dokumentaci.

🎫

Support tickety

👑

Funkce Enterprise

AI podpůrné tickety jsou dostupné pouze pro uživatele s tarify Enterprise.

🤖 Jak to funguje

Systém AI Support Ticketů automaticky detekuje, když chatbot nemůže odpovědět na otázku uživatele, a nabídne vytvoření support ticketu pro lidské vyřízení.

  • Chytrá detekce: AI rozpozná, když nemůže poskytnout uspokojivou odpověď
  • Souhlas uživatele: Systém se zeptá, zda chce uživatel vytvořit ticket
  • Sběr emailu: Shromažďuje email uživatele pro následný kontakt
  • AI shrnutí: Generuje shrnutí konverzace pro podpůrný tým

📝 Průběh vytvoření ticketu

Vícekrokový průběh konverzace pro vytvoření ticketu:

  1. Aktivace: AI detekuje nezodpověditelnou otázku nebo frustraci uživatele
  2. Nabídka: "Chcete, abych pro vás vytvořil support ticket?"
  3. Souhlas: Uživatel potvrdí, že chce pokračovat
  4. Email: "Prosím, zadejte svou emailovou adresu pro kontaktování"
  5. Shrnutí: AI automaticky vygeneruje shrnutí konverzace
  6. Potvrzení: Ticket vytvořen s referenčním číslem

📋 Správa ticketů

Přístup a správa support ticketů z Dashboard → Support tickety.

Stavový workflow:

  • Open: Nový ticket čeká na vyřízení
  • In Progress: Podpůrný tým pracuje na problému
  • Resolved: Problém vyřešen, čeká na potvrzení
  • Closed: Ticket dokončen a archivován

Dostupné akce:

  • • Zobrazit kompletní kontext konverzace
  • • Aktualizovat stav ticketu
  • • Přidat interní poznámky
  • • Odeslat emailovou odpověď uživateli

⚙️ Konfigurace

Povolte a nakonfigurujte support tickety v Nastavení chatbota → záložka Support tickety.

  • Povolit/Zakázat: Zapnout/vypnout vytváření ticketů pro tento chatbot
  • Emailové notifikace: Přijímat upozornění na nové tickety
  • Automatická odpověď: Vlastní zpráva odeslaná uživateli po vytvoření ticketu
  • Aktivátory: Nastavit, kdy jsou nabídky ticketů zobrazeny

💡 Tip: Pravidelně kontrolujte tickety pro identifikaci mezer ve znalostní bázi. Častá témata ticketů ukazují oblasti, kde byste měli přidat více dokumentace.

🔗

Webhook akce

👑

Funkce Enterprise & Evaluation

Webhook akce jsou dostupné pro tarify Enterprise (až 10 webhooků, celkem až 10 nástrojů napříč všemi webhooky) a Evaluation (až 5 webhooků, celkem až 5 nástrojů napříč všemi webhooky).

🔗 Přehled

Webhook akce umožňují vašemu chatbotovi interakci s externími systémy prostřednictvím volání nástrojů spouštěných AI. Definujte vlastní webhooky se specifickými nástroji, které může AI vyvolat během konverzací.

  • Vlastní webhooky: Definujte endpointy s autentizací
  • AI nástroje: Specifikujte nástroje, které může AI volat (např. get_order_status)
  • Parametry: Definujte povinné a volitelné parametry pro každý nástroj
  • Zpracování odpovědí: AI přirozeně zpracovává odpovědi webhooků

⚙️ Nastavení webhooků

Konfigurujte webhooky v Dashboard → Webhooky pro každý chatbot.

  1. Vytvořit webhook: Zadejte název, URL a volitelně autentizační hlavičky
  2. Definovat nástroje: Přidejte nástroje, které může AI volat (např. get_order_status, check_inventory)
  3. Nastavit parametry: Definujte povinné parametry (např. order_id, product_sku)
  4. Testovat: Použijte funkci test pro ověření, že webhook funguje správně
  5. Aktivovat: Povolte webhook pro produkční použití

🔄 n8n integrace

n8n je výkonný nástroj pro automatizaci workflow, který bezproblémově spolupracuje s naším webhook systémem.

Rychlé nastavení:

  1. Vytvořte nový workflow v n8n
  2. Přidejte Webhook trigger node (metoda POST)
  3. Zkopírujte URL webhooku do konfigurace webhooku chatbota
  4. Sestavte logiku workflow (API volání, databázové dotazy atd.)
  5. Vraťte JSON odpověď, kterou AI zpracuje

Příklad formátu odpovědi:{"status": "odeslano", "tracking": "1Z999AA1", "doruceni": "2024-01-15"}

💡 Příklady použití

📦 Vyhledání stavu objednávky

Zákazník se ptá "Kde je moje objednávka?" → AI zavolá get_order_status s číslem objednávky → Vrátí informace o sledování

👤 CRM integrace

Uživatel poskytne email → AI zavolá lookup_customer → Vrátí detaily účtu a nedávnou aktivitu

📅 Rezervace termínu

Uživatel žádá o termín → AI zavolá check_availability a poté book_appointment → Potvrdí rezervaci

🔍 Kontrola skladu

Zákazník se ptá na dostupnost produktu → AI zavolá check_stock → Vrátí aktuální stav zásob

🔒 Bezpečnost

  • Vyžadováno HTTPS: Všechny webhook endpointy musí používat HTTPS
  • Vlastní hlavičky: Přidejte autentizační tokeny v hlavičkách
  • Timeout handling: 30sekundový timeout zabraňuje visícím požadavkům
  • SSRF ochrana: Soukromé IP adresy jsou blokovány z bezpečnostních důvodů
  • Rate limiting: Vestavěná ochrana proti nadměrným voláním

⚠️ Důležité: Nikdy nevystavujte citlivé API klíče v URL webhooků. Místo toho použijte autentizační hlavičky.

💡 Tip: Začněte s jednoduchými operacemi pouze pro čtení (jako vyhledání objednávky) před implementací operací pro zápis. Důkladně otestujte pomocí vestavěného testeru webhooků před aktivací v produkci.

💡

Tipy & Triky pro přípravu dokumentů a úspěšnou implementaci chatbota

📄 Příprava dokumentů

📋 Strukturování obsahu

  • Tématické rozdělení: Jeden soubor = jeden topic
  • Logické členění: Jasné sekce a nadpisy
  • Snadná aktualizace: Změna pouze relevantní části
  • Přehlednost: Rychlá orientace v obsahu

📝 Formát a pojmenování

  • Textové formáty: TXT, DOC, DOCX (bez obrázků)
  • Jednoznačné názvy: Popisné názvy souborů
  • Automatická aktualizace: Stejný název = nahrazení
  • Bez starostí: Stará verze se smaže automaticky

💡 Tip: Připravte si dokumenty předem v čistě textové podobě. Obrázky a složité formátování mohou zhoršit kvalitu odpovědí chatbota.

🎯 Sémantické vyhledávání

🔍 Jak chatbot hledá odpovědi

  • Sémantická shoda: Hledá podobný význam, ne přesný text
  • Klíčová slova: Identifikuje důležité pojmy v dotazu
  • Kontext: Bere v úvahu celý význam věty
  • Podobnost: Porovnává s existujícími informacemi

✍️ Optimální formulace

  • Přímé odpovědi: "X je starý Y let" místo "X oslavil Y let"
  • Různé formulace: Použijte různé způsoby vyjádření
  • Očekávané otázky: Myslete na možné dotazy uživatelů
  • Klíčová slova: Zahrňte synonyma a varianty

❌ Méně vhodné:

"Pražský orloj oslavil 615 let"

✅ Lépe:

"Pražský orloj je starý 615 let"

Proč:Druhá verze lépe odpovídá na otázky "Jak starý je orloj?" nebo "Kolik let je Pražskému orloji?"

📊 Optimalizace podle analytiky

🔍 Analýza nedostatků

  • Nezodpovězené dotazy: Sledujte časté otázky bez odpovědi
  • Nízká spolehlivost: Identifikujte dotazy s malou jistotou
  • Opakující se problémy: Najděte vzorce v neúspěšných dotazech
  • Uživatelské frustrace: Pozorujte body kde se uživatelé "zaseknou"

🎯 Cílené zlepšování

  • Rozšíření dokumentů: Doplňte chybějící informace
  • Přeformulování: Upravte nejasné pasáže
  • Nové formulace: Přidejte různé způsoby vyjádření
  • Test a iterace: Otestujte změny a měřte zlepšení
💯 Interpretace spolehlivosti

< 30%

Neúspěšná odpověď

30-40%

Částečně zodpovězeno

> 40%

Úspěšná odpověď

💡 Tip: Testujte své úpravy přímo v chatbotu. Pokládejte stejné otázky znovu a sledujte změnu spolehlivosti. Cílem je dosáhnout konzistentně nad 40% spolehlivost.

Proč tak nízké hodnoty? Pro 100% spolehlivost by musel být dotaz identifikován přesně ve stejném znění v dokumentu, což nastane zcela výjimečně. Proto jsou realistické hodnoty pro české prostředí nižší.

❓ FAQ optimalizace

📈 Analýza nejčastějších dotazů

  • Sledujte trendy: Identifikujte opakující se otázky
  • Prioritizace: Zaměřte se na nejfrekventovanější dotazy
  • Vzorce: Hledejte podobné formulace stejné otázky
  • Problémy: Najděte dotazy s nízkou spolehlivostí

📝 Tvorba FAQ dokumentu

  • Jeden odstavec = Q&A: Otázka a odpověď společně
  • Přirozený jazyk: Používejte běžné formulace
  • Kompletní odpovědi: Všechny potřebné informace najednou
  • Různé varianty: Zahrňte synonyma a alternativy
✨ Příklad optimalizovaného FAQ

Jak dlouho trvá vyřízení žádosti o občanský průkaz?Vyřízení žádosti o občanský průkaz trvá standardně 30 pracovních dnů od podání kompletní žádosti. V případě ztráty nebo odcizení je možné požádat o expresní vyřízení do 5 pracovních dnů za poplatek 1000 Kč. Občanský průkaz si můžete vyzvednout osobně na místě podání nebo jej nechat zaslat na adresu.

🚀 Výsledek: FAQ dokument dramaticky zvýší spolehlivost odpovědí na nejčastější dotazy. Uspokojíte 80-90% uživatelských otázek s vysokou přesností.

📊 Dlouhodobá analýza

🔍 Pravidelný monitoring

  • Týdenní kontrola: Sledujte neúspěšné odpovědi
  • Měsíční přehled: Analyzujte trendy a změny
  • Částečné odpovědi: Identifikujte oblasti pro zlepšení
  • Vzorce problémů: Najděte opakující se nedostatky

📤 Export analytikyElite+

  • CSV formát: Pro MS Excel a Numbers
  • Detailní data: Všechny dotazy a odpovědi
  • Spolehlivost: Úroveň confidence pro každý dotaz
  • Časové razítko: Sledování trendů v čase
📈 Doporučený workflow

1. Týdenní export

Stáhněte data z posledního týdne

2. Analýza v Excelu

Filtrujte podle spolehlivosti < 40%

3. Aktualizace

Upravte dokumenty na základě poznatků

💡 Pro pokročilé: Využijte Excel pivot tabulky pro seskupování podobných dotazů a identifikaci nejčastějších problémových oblastí.

🌐 Využití webových zdrojů

🔗 Web URL scrapingElite+

  • Přímý import: Načtěte obsah z webových stránek
  • FAQ sekce: Ideální pro existující Často kladené otázky
  • Dokumentace: Využijte již hotovou dokumentaci
  • Aktuální obsah: Vždy nejnovější verze informací

✅ Výhody web scrapingu

  • Úspora času: Žádné ruční přepisování
  • Konzistence dat: Žádné rozdíly mezi weby a chatbotem
  • Automatická aktualizace: Stačí znovu načíst URL
  • Strukturovaný obsah: Zachová se formátování
📋 Ideální zdroje pro scraping

✅ Vhodné stránky:

  • • FAQ sekce
  • • Dokumentace produktů
  • • Návody a postupy
  • • Kontaktní informace

❌ Méně vhodné:

  • • Stránky s mnoha obrázky
  • • Navigační menu
  • • Reklamní obsahy
  • • JavaScript generovaný obsah

💡 Tip: Pokud máte kvalitní FAQ nebo dokumentaci na webu, použijte URL scraping místo ručního přepisování. Předejdete tak nekonzistenci a ušetříte čas při aktualizacích.

💡 Tipy pro efektivní využití

Získejte od chatbota lepší odpovědi a vyťažte maximum z vašeho měsíčního limitu zpráv:

📄 Kvalita dokumentů:
  • • Odstraňte zbytečný obsah před nahráním — čistší dokumenty = přesnější odpovědi
  • • Používejte dobře strukturované dokumenty s jasnými nadpisy a sekcemi
  • • Vyhněte se duplicitním informacím napříč dokumenty
❓ Podpora konkrétních otázek:
  • • Konkrétní, zaměřené otázky dostávají lepší odpovědi než vágní dotazy
  • • Dobře připravené dokumenty vedou k rychlejším a přesnějším odpovědím
📊 Sledujte své využití:
  • • Sledujte svůj limit zpráv v dashboard analytice
  • • Pro sezónní špičky provozu použijte přídavné zprávy místo upgradu tarifu
  • • Kontrolujte měsíční trendy a zjistěte, zda vám aktuální tarif vyhovuje
🔧

Řešení Problémů

⚠️ Časté problémy

🤖 Chatbot neodpovídá

Možné příčiny:

  • • Překročen měsíční limit zpráv
  • • Doména je blokována omezením
  • • Aktivováno omezení rychlosti
  • • Chyba načítání widgetu

Řešení:

  • • Zkontrolujte využití v dashboardu
  • • Ověřte povolené domény
  • • Vývojářské nástroje prohlížeče → záložka Síť
  • • Kontaktujte podporu s podrobnostmi chyby

📄 Dokument se nezpracuje

Časté problémy:

  • • Soubor větší než limit tarifu
  • • Nepodporovaný formát
  • • Poškozený nebo heslem chráněný PDF
  • • Přetížení fronty zpracování

Diagnostika:

  • • Zkontrolujte velikost souboru vs limit tarifu
  • • Vyzkoušejte výběr textu v PDF
  • • Stav zpracování v dokumentech
  • • Opakujte nahrání pokud uvízl

🌐 Widget se nenačte

Problémy načítání:

  • • Blokování CORS politikou
  • • Vypršení času načítání skriptu
  • • CSP (Bezpečnostní politika obsahu)
  • • Interference ad blockerů

Kroky řešení:

  • • Chybové zprávy v konzoli prohlížeče
  • • Vyzkoušejte jiný prohlížeč/inkognito
  • • Dočasně vypněte blokátory reklam
  • • Zkontrolujte nastavení povolených domén

🆘 Kontakt podpory

📧 Emailová podpora

support@chatbotty.cz

  • Priority tarify: do 24h (výjimečně do 48h)
  • Free tarify: obvykle do 72h
  • • Přílohy: Snímky obrazovky, logy vítány

🔍 Co zahrnout

  • • Typ prohlížeče a verze
  • • Chybová zpráva nebo snímek obrazovky
  • • ID chatbota a URL widgetu
  • • Reprodukční kroky
  • • Chyby v konzoli (F12)