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
- 1Registrace 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.
- 2Vytvoř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.
- 3Nahrá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ý).
- 4Testová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
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
Vybrat chatbot
Zvolte chatbot, ke kterému bude dokument přiřazen
Vybrat způsob nahrání
📎 Soubory (PDF, DOCX, TXT, MD)
Maximálně 10 MB na soubor
🌐 Web URL
Automatický scraping webových stránek
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í
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
📊 Kvalita odpovědí
⚠️ 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ů
Free
Perfect for getting started
•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
Evaluation
14-day trial with Enterprise features
•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
•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
Elite
Most popular
•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
•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:
- Nejprve se spotřebovává váš měsíční limit
- Když je měsíční limit vyčerpán, automaticky se použijí přídavné zprávy
- Přídavné zprávy přetrvávají, dokud nejsou plně spotřebovány (bez vypršení)
- 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
- Přejděte do sekce Předplatné v bočním panelu
- Klikněte na tlačítko Manage Subscription
- 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.
- Vytvořte API klíč v Dashboardu → API integrace pro váš chatbot
- Zahrňte API klíč v Authorization headeru jako Bearer token
- Pošlete POST request na
/api/chatendpoint - 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í dotazyPython
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. Bezconversation_idje 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:
- Aktivace: AI detekuje nezodpověditelnou otázku nebo frustraci uživatele
- Nabídka: "Chcete, abych pro vás vytvořil support ticket?"
- Souhlas: Uživatel potvrdí, že chce pokračovat
- Email: "Prosím, zadejte svou emailovou adresu pro kontaktování"
- Shrnutí: AI automaticky vygeneruje shrnutí konverzace
- 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.
- Vytvořit webhook: Zadejte název, URL a volitelně autentizační hlavičky
- Definovat nástroje: Přidejte nástroje, které může AI volat (např. get_order_status, check_inventory)
- Nastavit parametry: Definujte povinné parametry (např. order_id, product_sku)
- Testovat: Použijte funkci test pro ověření, že webhook funguje správně
- 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í:
- Vytvořte nový workflow v n8n
- Přidejte Webhook trigger node (metoda POST)
- Zkopírujte URL webhooku do konfigurace webhooku chatbota
- Sestavte logiku workflow (API volání, databázové dotazy atd.)
- 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)