Je Chatbotty-chatbot beantwoordt al vragen op je website via de widget. Maar wat als je wilt dat je AI-chatbot ook ergens anders leeft — in je eigen mobiele app, een klantenportaal of een intern hulpmiddel dat je team dagelijks gebruikt? Daar is een **API** precies voor bedoeld. Deze gids legt in eenvoudige taal uit wat een API is, hoe de Chatbotty API werkt, wat je ermee kunt bouwen en hoe je je eerste API-sleutel maakt. Geen diploma informatica nodig — alleen een duidelijk beeld van hoe de onderdelen samenwerken. Dit is het eerste artikel in een serie. Hier behandelen we het grote geheel; latere artikelen duiken dieper in elk deel van de API. ## Wat is een API precies? API staat voor *Application Programming Interface* (toepassingsprogrammeerinterface). Dat klinkt technisch, maar het idee is simpel: een API is een manier voor twee softwareonderdelen om direct met elkaar te communiceren, zonder dat een mens tussendoor knoppen hoeft te klikken. Denk eraan als bestellen in een restaurant. Je loopt niet de keuken in om zelf te koken. Je vertelt de ober wat je wilt, de ober geeft je bestelling door aan de keuken en het eten komt terug naar je tafel. De ober is de API — een boodschapper die je verzoek meeneemt, het aflevert bij het systeem dat het werk doet, en het antwoord terugbrengt. Bij Chatbotty is de "keuken" je AI-chatbot en zijn kennisbank. De API is de boodschapper waar je software mee praat. Je app stuurt een vraag, de chatbot zoekt het antwoord uit, en de API stuurt dat antwoord razendsnel terug naar je app. ## Waarom je chatbot verbinden met een API? De chatwidget is perfect voor je website. Maar een API opent alle andere mogelijkheden: - **Bouw een chatbot in je eigen app.** Plaats je AI-assistent in een mobiele app of een aangepaste webapp, met je eigen ontwerp eromheen. - **Verbind je chatbot met andere tools.** Voer antwoorden in een helpdesk, een Slack-kanaal of een intern dashboard. - **Automatiseer je kennisbank.** Upload automatisch nieuwe documenten naar je chatbot zodra je productinformatie verandert. - **Haal je eigen rapporten op.** Lees gespreksgeschiedenis en analyses in je systemen in plaats van handmatig het dashboard te controleren. Kortom: de widget is de kant-en-klare voordeur, en de API is de set sleutels waarmee je je eigen deuren bouwt waar je ze nodig hebt. ## Wat je kunt doen met de Chatbotty API De Chatbotty API is verdeeld in vijf gebieden. Je vindt kant-en-klare codevoorbeelden voor elk gebied direct in je dashboard, onder **API Integration**. - **Chat API** — stuur een bericht naar je chatbot en krijg het AI-antwoord terug, dezelfde intelligentie die je widget aandrijft. - **Documents API** — upload, lijst en verwijder de documenten die de kennisbank van je chatbot vormen. - **Conversations API** — lees eerdere gesprekken en hun berichten. - **Analytics API** — haal geaggregeerde statistieken op zoals totaal aantal vragen en succespercentage. - **Tickets API** — lijst supporttickets, wijzig hun status en voeg interne notities toe. Maak je nog geen zorgen over de details. Elk van deze krijgt een eigen artikel. Voor nu is het belangrijk om te weten dat bijna alles wat je in het dashboard ziet, ook via de API bereikbaar is. ## Hoe API-sleutels je chatbot beveiligen Software kan niet inloggen met een e-mail en wachtwoord zoals jij dat doet. In plaats daarvan bewijst het wie het is met een **API-sleutel** — een lange, geheime tekenreeks. Elk verzoek dat je app verstuurt bevat deze sleutel zodat Chatbotty weet dat het verzoek echt van jou komt en bij welke chatbot het hoort. De sleutel wordt meegezonden in een onderdeel van het verzoek dat de *Authorization header* heet, als iets dat een **Bearer token** wordt genoemd. Je hoeft die termen niet te onthouden — de codevoorbeelden in je dashboard bevatten ze al. Vervang gewoon de tijdelijke aanduiding `YOUR_API_KEY` door je echte sleutel en je bent klaar. Een sleutel is gekoppeld aan één specifieke chatbot. Je hoeft nooit een chatbot-ID mee te sturen — Chatbotty weet aan de hand van de sleutel zelf welke chatbot bedoeld wordt. Een API-sleutel is als een wachtwoord voor je chatbot. Iedereen die hem heeft kan met je chatbot praten en de data lezen. Plak hem nooit in openbare code, de voorkant van een website of een gedeeld document — bewaar hem op je eigen beveiligde server. ## Hoe maak je je eerste API-sleutel aan Een sleutel aanmaken duurt ongeveer tien seconden. Dit is het hele proces. 1. Open je dashboard en ga naar **API Integration** in het linkermenu. 2. Zoek de chatbot die je wilt verbinden. Elke chatbot heeft een eigen **API Keys** sectie. 3. Klik op **Create new API key**. 4. Geef de sleutel een naam die je later herkent, zoals *Productiewebsite* of *Mobiele app*. De naam is alleen voor jou — het helpt je herinneren waar elke sleutel voor wordt gebruikt. 5. Klik op **Create**. Je gloednieuwe sleutel verschijnt direct. Kopieer je sleutel nu en bewaar hem op een veilige plek. Uit veiligheidsoverwegingen wordt de volledige sleutel maar één keer getoond. Nadat je dit venster sluit toont het dashboard alleen de eerste paar tekens. Als je hem ooit kwijtraakt, verwijder dan de oude sleutel en maak een nieuwe aan. Je kunt meerdere sleutels per chatbot aanmaken — handig om elke app zijn eigen sleutel te geven. Je kunt een sleutel op elk moment uitschakelen zonder hem te verwijderen, of definitief verwijderen als hij niet meer nodig is. ## Je eerste API-verzoek Zodra je een sleutel hebt, is praten met je chatbot één simpel verzoek. Hier is het kleinste voorbeeld met cURL, een basis commandoregeltool: ```bash curl -X POST "https://www.chatbotty.ai/api/v1/chat" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"message": "Wat zijn jullie openingstijden?"}' ``` Je chatbot leest het bericht, doorzoekt de kennisbank en antwoordt — precies zoals in de widget. Het allereerste chatverzoek maakt ook een *gesprek* aan, en je kunt het ID daarvan meegeven bij het volgende verzoek om het gesprek met volledige context voort te zetten. Liever JavaScript, Python of Node.js? Elk voorbeeld in het dashboard is ook beschikbaar in die talen, klaar om te kopiëren. ## Wie kan de API gebruiken? De Chatbotty API is beschikbaar in de **Evaluation**, **Elite** en **Enterprise** abonnementen. Als je huidige abonnement nog geen API-toegang heeft, toont de pagina API Integration de upgrade-opties. Chatverzoeken via de API tellen mee voor je maandelijkse berichtquota, net als chats vanuit de widget — de andere gebieden, zoals analytics en gesprekken, gebruiken geen berichten. ## Klaar om te beginnen met bouwen? Dat is het hele plaatje: een API laat je eigen software direct met je chatbot praten, een API-sleutel houdt die verbinding veilig, en het dashboard geeft je werkende code voor elk onderdeel. Open de pagina API Integration, maak je eerste sleutel aan en probeer een enkel chatverzoek — zodra je je chatbot via de API ziet antwoorden, valt de rest op zijn plek. Houd de volgende artikelen in deze serie in de gaten, waarin we de Chat, Documents, Conversations, Analytics en Tickets APIs één voor één verkennen.