Ihr Chatbotty-Chatbot beantwortet bereits Fragen auf Ihrer Website über sein Widget. Aber was, wenn Sie möchten, dass Ihr KI-Chatbot auch an anderen Orten lebt – in Ihrer eigenen mobilen App, einem Kundenportal oder einem internen Tool, das Ihr Team täglich nutzt? Genau dafür ist eine **API** da. Dieser Leitfaden erklärt in einfachen Worten, was eine API ist, wie die Chatbotty-API funktioniert, was Sie damit bauen können und wie Sie Ihren ersten API-Schlüssel erstellen. Kein Informatikstudium erforderlich – nur ein klares Bild davon, wie die einzelnen Teile zusammenpassen. Dies ist der erste Artikel einer Serie. Hier behandeln wir das große Ganze; spätere Artikel gehen auf jeden Teil der API im Detail ein. ## Was genau ist eine API? API steht für *Application Programming Interface* (Programmierschnittstelle). Das klingt technisch, aber die Idee ist einfach: Eine API ist eine Möglichkeit, wie zwei Softwareteile direkt miteinander kommunizieren können, ohne dass ein Mensch zwischendurch Knöpfe drücken muss. Stellen Sie sich das vor wie eine Bestellung im Restaurant. Sie gehen nicht selbst in die Küche und kochen Ihr Essen. Sie sagen dem Kellner, was Sie möchten, der Kellner gibt die Bestellung an die Küche weiter, und das Essen kommt zurück an Ihren Tisch. Der Kellner ist die API – ein Bote, der Ihre Anfrage entgegennimmt, sie an das System weiterleitet, das die Arbeit erledigt, und die Antwort zurückbringt. Bei Chatbotty ist die „Küche“ Ihr KI-Chatbot und seine Wissensdatenbank. Die API ist der Bote, mit dem Ihre Software kommuniziert. Ihre App sendet eine Frage, der Chatbot findet die Antwort, und die API sendet diese Antwort in Bruchteilen einer Sekunde direkt zurück an Ihre App. ## Warum sollten Sie Ihren Chatbot mit einer API verbinden? Das Chat-Widget ist perfekt für Ihre Website. Aber eine API eröffnet Ihnen alle anderen Möglichkeiten: - **Bauen Sie einen Chatbot in Ihre eigene App ein.** Platzieren Sie Ihren KI-Assistenten in einer mobilen App oder einer maßgeschneiderten Web-App mit Ihrem eigenen Design. - **Verbinden Sie Ihren Chatbot mit anderen Tools.** Speisen Sie Antworten in ein Helpdesk, einen Slack-Kanal oder ein internes Dashboard ein. - **Automatisieren Sie Ihre Wissensdatenbank.** Laden Sie neue Dokumente automatisch in Ihren Chatbot hoch, sobald sich Ihre Produktinformationen ändern. - **Erstellen Sie eigene Berichte.** Lesen Sie Gesprächshistorien und Analysen in Ihre Systeme ein, anstatt das Dashboard manuell zu prüfen. Kurz gesagt: Das Widget ist die fertige Haustür, und die API ist der Schlüsselbund, mit dem Sie überall dort eigene Türen bauen können, wo Sie sie brauchen. ## Was Sie mit der Chatbotty-API machen können Die Chatbotty-API ist in fünf Bereiche unterteilt. Für jeden Bereich finden Sie direkt in Ihrem Dashboard unter **API Integration** fertige Codebeispiele zum Kopieren. - **Chat API** — senden Sie eine Nachricht an Ihren Chatbot und erhalten Sie die KI-Antwort zurück, das gleiche Gehirn, das Ihr Widget antreibt. - **Documents API** — laden Sie Dokumente hoch, listen Sie sie auf und entfernen Sie sie, die Ihre Chatbot-Wissensdatenbank bilden. - **Conversations API** — lesen Sie vergangene Gespräche und deren Nachrichten aus. - **Analytics API** — rufen Sie aggregierte Statistiken wie Gesamtfragen und Erfolgsrate ab. - **Tickets API** — listen Sie Support-Tickets auf, ändern Sie deren Status und fügen Sie interne Notizen hinzu. Machen Sie sich noch keine Sorgen um die Details. Jeder dieser Bereiche erhält einen eigenen Artikel. Für den Moment gilt: Fast alles, was Sie im Dashboard sehen, können Sie auch über die API erreichen. ## Wie API-Schlüssel Ihren Chatbot sichern Software kann sich nicht mit E-Mail und Passwort anmelden wie Sie. Stattdessen weist sie sich mit einem **API-Schlüssel** aus – einer langen, geheimen Zeichenfolge. Jede Anfrage, die Ihre App sendet, enthält diesen Schlüssel, damit Chatbotty weiß, dass die Anfrage wirklich von Ihnen kommt und zu welchem Chatbot sie gehört. Der Schlüssel wird in einem Teil der Anfrage namens *Authorization header* als sogenanntes **Bearer-Token** gesendet. Sie müssen diese Begriffe nicht auswendig lernen – die Codebeispiele in Ihrem Dashboard enthalten sie bereits. Ersetzen Sie einfach den Platzhalter `YOUR_API_KEY` durch Ihren echten Schlüssel, und fertig. Ein Schlüssel ist an einen bestimmten Chatbot gebunden. Sie müssen nie eine Chatbot-ID senden – Chatbotty erkennt anhand des Schlüssels, welchen Chatbot Sie meinen. Ein API-Schlüssel ist wie ein Passwort für Ihren Chatbot. Jeder, der ihn hat, kann mit Ihrem Chatbot sprechen und dessen Daten lesen. Fügen Sie ihn niemals in öffentlichen Code, die Frontend-Seite einer Website oder ein geteiltes Dokument ein – bewahren Sie ihn auf Ihrem eigenen sicheren Server auf. ## Wie Sie Ihren ersten API-Schlüssel erstellen Die Erstellung eines Schlüssels dauert etwa zehn Sekunden. So funktioniert der ganze Prozess. 1. Öffnen Sie Ihr Dashboard und gehen Sie im linken Menü zu **API Integration**. 2. Finden Sie den Chatbot, den Sie verbinden möchten. Jeder Chatbot hat seinen eigenen Bereich **API Keys**. 3. Klicken Sie auf **Create new API key**. 4. Geben Sie dem Schlüssel einen Namen, den Sie später wiedererkennen, z. B. *Produktiv-Website* oder *Mobile App*. Der Name ist nur für Sie – er hilft Ihnen, sich zu merken, wo jeder Schlüssel verwendet wird. 5. Klicken Sie auf **Create**. Ihr brandneuer Schlüssel erscheint sofort. Kopieren Sie Ihren Schlüssel jetzt und speichern Sie ihn an einem sicheren Ort. Aus Sicherheitsgründen wird der vollständige Schlüssel nur einmal angezeigt. Nachdem Sie dieses Fenster schließen, zeigt das Dashboard nur die ersten Zeichen an. Wenn Sie ihn verlieren, löschen Sie einfach den alten Schlüssel und erstellen einen neuen. Sie können mehrere Schlüssel pro Chatbot erstellen – eine praktische Möglichkeit, jeder App ihren eigenen Schlüssel zu geben. Sie können einen Schlüssel jederzeit deaktivieren, ohne ihn zu löschen, oder ihn endgültig entfernen, wenn er nicht mehr benötigt wird. ## Ihre erste API-Anfrage Sobald Sie einen Schlüssel haben, ist die Kommunikation mit Ihrem Chatbot eine einfache Anfrage. Hier ist das kleinste Beispiel mit cURL, einem grundlegenden Kommandozeilen-Tool: ```bash curl -X POST "https://www.chatbotty.ai/api/v1/chat" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message": "Wie sind Ihre Öffnungszeiten?"}' ``` Ihr Chatbot liest die Nachricht, durchsucht seine Wissensdatenbank und antwortet – genau wie im Widget. Die allererste Chat-Anfrage erstellt auch eine *Konversation*, und Sie können deren ID bei der nächsten Anfrage zurückgeben, um das Gespräch mit vollem Kontext fortzusetzen. Bevorzugen Sie JavaScript, Python oder Node.js? Jedes Beispiel im Dashboard ist auch in diesen Sprachen verfügbar und bereit zum Kopieren. ## Wer kann die API nutzen? Die Chatbotty-API ist in den Plänen **Evaluation**, **Elite** und **Enterprise** verfügbar. Wenn Ihr aktueller Plan noch keinen API-Zugang enthält, zeigt die Seite API Integration die Upgrade-Optionen an. Chat-Anfragen, die über die API gesendet werden, zählen zu Ihrem monatlichen Nachrichtenkontingent, genau wie Chats über das Widget – die anderen Bereiche wie Analytics und Conversations verbrauchen keine Nachrichten. ## Bereit zum Start? Das ist das Gesamtbild: Eine API lässt Ihre eigene Software direkt mit Ihrem Chatbot sprechen, ein API-Schlüssel sichert diese Verbindung, und das Dashboard liefert Ihnen funktionierenden Code für jeden Teil davon. Öffnen Sie die Seite API Integration, erstellen Sie Ihren ersten Schlüssel und probieren Sie eine einzelne Chat-Anfrage aus – sobald Sie sehen, wie Ihr Chatbot über die API antwortet, fügt sich der Rest zusammen. Behalten Sie die nächsten Artikel dieser Serie im Auge, in denen wir die Chat-, Dokumenten-, Gesprächs-, Analyse- und Ticket-APIs einzeln erkunden.