Váš chatbot Chatbotty již odpovídá na otázky na vašich webových stránkách prostřednictvím svého widgetu. Ale co když byste chtěli, aby váš AI chatbot žil i jinde — například ve vaší vlastní mobilní aplikaci, zákaznickém portálu nebo interním nástroji, který váš tým používá každý den? Přesně k tomu slouží **API**. Tento průvodce vysvětluje, co je API jednoduchou angličtinou, jak funguje Chatbotty API, co s ním můžete vytvořit a jak si vytvořit svůj první API klíč. Nepotřebujete titul z informatiky — stačí jasná představa, jak jednotlivé části spolu souvisejí. Toto je první článek ze série. Zde pokrýváme celkový přehled; další články se podrobně věnují jednotlivým částem API. ## Co přesně je API? API znamená *Application Programming Interface* (programové rozhraní aplikace). Zní to technicky, ale myšlenka je jednoduchá: API je způsob, jak mohou dva softwarové systémy komunikovat přímo mezi sebou, bez nutnosti, aby člověk klikal na tlačítka mezi tím. Představte si to jako objednávání v restauraci. Nevstoupíte do kuchyně a neuvaříte si jídlo sami. Řeknete číšníkovi, co chcete, číšník předá vaši objednávku do kuchyně a jídlo se vrátí ke stolu. Číšník je API — posel, který vezme vaši žádost, doručí ji systému, který práci vykoná, a přinese zpět odpověď. U Chatbotty je „kuchyní“ váš AI chatbot a jeho znalostní báze. API je posel, se kterým váš software komunikuje. Vaše aplikace pošle otázku, chatbot najde odpověď a API ji okamžitě pošle zpět do vaší aplikace — to vše během zlomku sekundy. ## Proč připojit svého chatbota k API? Chat widget je ideální pro vaše webové stránky. Ale API otevírá úplně nové možnosti: - **Vytvořte chatbota ve své vlastní aplikaci.** Umístěte svého AI asistenta do mobilní aplikace nebo vlastní webové aplikace s vlastním designem. - **Propojte chatbota s dalšími nástroji.** Posílejte odpovědi do helpdesku, Slack kanálu nebo interního dashboardu. - **Automatizujte svou znalostní bázi.** Automaticky nahrávejte nové dokumenty do chatbota vždy, když se změní informace o produktu. - **Vytahujte vlastní reporty.** Čtěte historii konverzací a analytiku přímo do svých systémů místo ručního kontrolování dashboardu. Stručně řečeno: widget je hotové vstupní dveře a API je sada klíčů, která vám umožní postavit si vlastní dveře tam, kde je potřebujete. ## Co můžete dělat s Chatbotty API Chatbotty API je rozděleno do pěti oblastí. Hotové příklady kódu pro každou z nich najdete přímo ve svém dashboardu v sekci **API Integration**. - **Chat API** — pošlete zprávu svému chatbotovi a získejte odpověď AI, stejný mozek, který pohání váš widget. - **Documents API** — nahrávejte, vypisujte a odstraňujte dokumenty, které tvoří znalostní bázi vašeho chatbota. - **Conversations API** — čtěte minulé konverzace a jejich zprávy. - **Analytics API** — získávejte agregované statistiky jako celkový počet otázek a úspěšnost. - **Tickets API** — vypisujte podporové tikety, měňte jejich stav a přidávejte interní poznámky. Nemusíte se zatím zabývat detaily. Každá z těchto oblastí dostane svůj vlastní článek. Prozatím stačí vědět, že téměř vše, co vidíte v dashboardu, můžete také ovládat přes API. ## Jak API klíče udržují vašeho chatbota v bezpečí Software se nemůže přihlásit pomocí e-mailu a hesla jako vy. Místo toho dokazuje svou identitu pomocí **API klíče** — dlouhého tajného řetězce znaků. Každý požadavek, který vaše aplikace odešle, obsahuje tento klíč, aby Chatbotty věděl, že požadavek opravdu pochází od vás a ke kterému chatbotovi patří. Klíč se posílá v části požadavku zvané *Authorization header* jako tzv. **Bearer token**. Nemusíte si tyto termíny pamatovat — příklady kódu ve vašem dashboardu je už obsahují. Stačí nahradit zástupný text `YOUR_API_KEY` vaším skutečným klíčem a je to. Klíč je vázán na jeden konkrétní chatbot. Nikdy nemusíte posílat ID chatbota — Chatbotty zjistí, o který chatbot jde, přímo z klíče. API klíč je jako heslo k vašemu chatbotovi. Kdokoli, kdo ho má, může s chatbotem komunikovat a číst jeho data. Nikdy ho nevkládejte do veřejného kódu, front-endu webu nebo sdíleného dokumentu — uchovávejte ho na svém vlastním zabezpečeném serveru. ## Jak vytvořit svůj první API klíč Vytvoření klíče zabere asi deset sekund. Zde je celý postup. 1. Otevřete svůj dashboard a v levém menu přejděte do **API Integration**. 2. Najděte chatbota, kterého chcete připojit. Každý chatbot má svou sekci **API Keys**. 3. Klikněte na **Create new API key**. 4. Pojmenujte klíč tak, abyste ho později poznali, například *Produkční web* nebo *Mobilní aplikace*. Název je jen pro vás — pomáhá vám zapamatovat si, kde se který klíč používá. 5. Klikněte na **Create**. Nový klíč se zobrazí okamžitě. Zkopírujte si klíč nyní a uložte ho na bezpečné místo. Z bezpečnostních důvodů se celý klíč zobrazí pouze jednou. Po zavření tohoto okna dashboard zobrazí jen několik prvních znaků. Pokud ho někdy ztratíte, jednoduše starý klíč smažte a vytvořte nový. Můžete vytvořit několik klíčů pro jednoho chatbota — praktický způsob, jak dát každé aplikaci vlastní klíč. Klíč můžete kdykoli deaktivovat bez smazání nebo ho trvale odstranit, když už není potřeba. ## Váš první API požadavek Jakmile máte klíč, komunikace s chatbotem je jeden jednoduchý požadavek. Zde je nejmenší možný příklad pomocí cURL, základního nástroje příkazového řádku: ```bash curl -X POST "https://www.chatbotty.ai/api/v1/chat" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message": "Jaké jsou vaše otevírací hodiny?"}' ``` Váš chatbot přečte zprávu, prohledá svou znalostní bázi a odpoví — přesně jako ve widgetu. První chatový požadavek také vytvoří *konverzaci* a můžete při dalším požadavku předat její ID, abyste udrželi konverzaci s plným kontextem. Preferujete JavaScript, Python nebo Node.js? Každý příklad v dashboardu je k dispozici i v těchto jazycích, připravený ke zkopírování. ## Kdo může API používat? Chatbotty API je dostupné v plánech **Evaluation**, **Elite** a **Enterprise**. Pokud váš současný plán API přístup ještě neobsahuje, stránka API Integration vám nabídne možnosti upgradu. Chatové požadavky odeslané přes API se počítají do vašeho měsíčního limitu zpráv stejně jako chaty z widgetu — ostatní oblasti, jako analytika a konverzace, zprávy neodebírají. ## Připraven začít stavět? To je celý přehled: API umožňuje vašemu softwaru přímo komunikovat s chatbotem, API klíč udržuje toto spojení v bezpečí a dashboard vám dává funkční kód pro každou jeho část. Otevřete stránku API Integration, vytvořte svůj první klíč a vyzkoušejte jeden chatový požadavek — jakmile uvidíte odpověď chatbota přes API, vše ostatní do sebe zapadne. Sledujte další články této série, kde budeme postupně zkoumat Chat, Documents, Conversations, Analytics a Tickets API.