Twój chatbot Chatbotty już odpowiada na pytania na Twojej stronie internetowej poprzez widget. Ale co, jeśli chciałbyś, aby Twój chatbot AI działał również gdzie indziej — w Twojej własnej aplikacji mobilnej, portalu klienta lub narzędziu wewnętrznym, którego Twój zespół używa na co dzień? Dokładnie do tego służy **API**. Ten przewodnik wyjaśnia, czym jest API prostym językiem, jak działa API Chatbotty, co możesz z nim zbudować i jak stworzyć swój pierwszy klucz API. Nie jest potrzebny dyplom informatyczny — wystarczy jasne zrozumienie, jak wszystko do siebie pasuje. To pierwszy artykuł z serii. Tutaj omawiamy ogólny obraz; kolejne artykuły szczegółowo zagłębią się w każdą część API. ## Czym dokładnie jest API? API oznacza *Application Programming Interface* (Interfejs Programowania Aplikacji). Brzmi technicznie, ale idea jest prosta: API to sposób, w jaki dwa programy mogą się ze sobą komunikować bezpośrednio, bez udziału człowieka klikającego przyciski. Pomyśl o tym jak o zamawianiu w restauracji. Nie wchodzisz do kuchni i nie gotujesz sam swojego posiłku. Mówisz kelnerowi, co chcesz, kelner przekazuje zamówienie do kuchni, a jedzenie wraca do Twojego stolika. Kelner to API — posłaniec, który przyjmuje Twoje żądanie, dostarcza je do systemu wykonującego pracę i przynosi odpowiedź. W Chatbotty „kuchnią” jest Twój chatbot AI i jego baza wiedzy. API to posłaniec, z którym rozmawia Twoje oprogramowanie. Twoja aplikacja wysyła pytanie, chatbot znajduje odpowiedź, a API odsyła tę odpowiedź bezpośrednio do Twojej aplikacji — wszystko w ułamku sekundy. ## Dlaczego warto połączyć chatbota z API? Widget czatu jest idealny na Twoją stronę internetową. Ale API otwiera zupełnie nowe możliwości: - **Zbuduj chatbota w swojej własnej aplikacji.** Umieść swojego asystenta AI w aplikacji mobilnej lub niestandardowej aplikacji webowej, z własnym designem. - **Połącz chatbota z innymi narzędziami.** Przekazuj odpowiedzi do help desku, kanału Slack lub wewnętrznego panelu. - **Automatyzuj swoją bazę wiedzy.** Automatycznie przesyłaj nowe dokumenty do chatbota za każdym razem, gdy zmienia się informacja o produkcie. - **Generuj własne raporty.** Pobieraj historię rozmów i analizy do swoich systemów zamiast sprawdzać dashboard ręcznie. Krótko mówiąc: widget to gotowe wejście, a API to zestaw kluczy, który pozwala budować własne wejścia tam, gdzie ich potrzebujesz. ## Co możesz zrobić z API Chatbotty API Chatbotty jest podzielone na pięć obszarów. Znajdziesz gotowe do skopiowania przykłady kodu dla każdego z nich bezpośrednio w swoim dashboardzie, w sekcji **API Integration**. - **Chat API** — wyślij wiadomość do chatbota i otrzymaj odpowiedź AI, ten sam silnik, który zasila widget. - **Documents API** — przesyłaj, wyświetlaj i usuwaj dokumenty tworzące bazę wiedzy chatbota. - **Conversations API** — odczytuj poprzednie rozmowy i ich wiadomości. - **Analytics API** — pobieraj zagregowane statystyki, takie jak łączna liczba pytań i wskaźnik sukcesu. - **Tickets API** — wyświetlaj zgłoszenia wsparcia, zmieniaj ich status i dodawaj notatki wewnętrzne. Nie martw się szczegółami na razie. Każdy z tych obszarów będzie miał dedykowany artykuł. Na razie wystarczy wiedzieć, że prawie wszystko, co widzisz w dashboardzie, możesz też osiągnąć przez API. ## Jak klucze API zabezpieczają Twojego chatbota Oprogramowanie nie loguje się za pomocą e-maila i hasła tak jak Ty. Zamiast tego potwierdza swoją tożsamość za pomocą **klucza API** — długiego, tajnego ciągu znaków. Każde żądanie wysyłane przez Twoją aplikację zawiera ten klucz, dzięki czemu Chatbotty wie, że żądanie pochodzi naprawdę od Ciebie i do którego chatbota należy. Klucz jest wysyłany w części żądania zwanej *nagłówkiem Authorization*, jako coś, co nazywa się **tokenem Bearer**. Nie musisz zapamiętywać tych terminów — przykłady kodu w Twoim dashboardzie już je zawierają. Wystarczy, że zastąpisz symbol zastępczy `YOUR_API_KEY` swoim prawdziwym kluczem i gotowe. Klucz jest powiązany z jednym konkretnym chatbotem. Nigdy nie musisz wysyłać ID chatbota — Chatbotty rozpoznaje, o który chatbot chodzi na podstawie samego klucza. Klucz API jest jak hasło do Twojego chatbota. Każdy, kto go posiada, może rozmawiać z Twoim chatbotem i czytać jego dane. Nigdy nie wklejaj go do publicznego kodu, front-endu strony ani współdzielonych dokumentów — trzymaj go na własnym, bezpiecznym serwerze. ## Jak stworzyć swój pierwszy klucz API Stworzenie klucza zajmuje około dziesięciu sekund. Oto cały proces. 1. Otwórz swój dashboard i przejdź do **API Integration** w lewym menu. 2. Znajdź chatbota, którego chcesz połączyć. Każdy chatbot ma własną sekcję **API Keys**. 3. Kliknij **Create new API key**. 4. Nadaj kluczowi nazwę, którą łatwo zapamiętasz, np. *Strona produkcyjna* lub *Aplikacja mobilna*. Nazwa jest tylko dla Ciebie — pomaga zapamiętać, gdzie używany jest dany klucz. 5. Kliknij **Create**. Twój nowy klucz pojawi się od razu. Skopiuj klucz teraz i przechowuj go w bezpiecznym miejscu. Ze względów bezpieczeństwa pełny klucz jest pokazany tylko raz. Po zamknięciu tego okna dashboard wyświetla tylko pierwsze kilka znaków. Jeśli go zgubisz, po prostu usuń stary klucz i utwórz nowy. Możesz stworzyć kilka kluczy dla jednego chatbota — to wygodny sposób, aby każda aplikacja miała swój własny klucz. Możesz wyłączyć klucz w dowolnym momencie bez usuwania go lub usunąć go na stałe, gdy nie jest już potrzebny. ## Twoje pierwsze żądanie API Gdy masz już klucz, rozmowa z chatbotem to jedno proste żądanie. Oto najmniejszy możliwy przykład używający cURL, podstawowego narzędzia wiersza poleceń: ```bash curl -X POST "https://www.chatbotty.ai/api/v1/chat" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message": "Jakie są wasze godziny otwarcia?"}' ``` Twój chatbot odczytuje wiadomość, przeszukuje bazę wiedzy i odpowiada — dokładnie tak jak w widgetcie. Pierwsze żądanie czatu tworzy także *konwersację*, której ID możesz przekazać w kolejnym żądaniu, aby kontynuować rozmowę z pełnym kontekstem. Wolisz JavaScript, Python lub Node.js? Każdy przykład w dashboardzie jest dostępny również w tych językach, gotowy do skopiowania. ## Kto może korzystać z API? API Chatbotty jest dostępne w planach **Evaluation**, **Elite** i **Enterprise**. Jeśli Twój obecny plan nie obejmuje jeszcze dostępu do API, strona API Integration pokaże Ci opcje aktualizacji. Zapytania czatu wysyłane przez API liczą się do miesięcznego limitu wiadomości, tak samo jak czaty z widgetu — pozostałe obszary, takie jak analityka i konwersacje, nie zużywają wiadomości. ## Gotowy, by zacząć budować? To cały obraz: API pozwala Twojemu oprogramowaniu rozmawiać bezpośrednio z chatbotem, klucz API zabezpiecza to połączenie, a dashboard daje Ci działający kod dla każdej jego części. Otwórz stronę API Integration, stwórz swój pierwszy klucz i wypróbuj pojedyncze żądanie czatu — gdy zobaczysz odpowiedź chatbota przez API, reszta ułoży się sama. Śledź kolejne artykuły z tej serii, w których po kolei omówimy API Chat, Dokumentów, Konwersacji, Analityki i Zgłoszeń.