Chatbot-API-Integration: REST, Zapier & Webhooks erklärt

Eine Chatbot-API ist eine HTTP-Schnittstelle, mit der Sie Nachrichten programmatisch an einen KI-Chatbot senden und Antworten empfangen können — ohne ein visuelles Widget zu verwenden. Statt dass ein Nutzer in eine Chat-Blase tippt, sendet Ihr Code eine Anfrage, erhält eine Antwort und macht etwas damit: rendert eine individuelle UI, protokolliert die Antwort, löst eine Aktion aus oder leitet das Ergebnis an ein anderes System weiter.

Dieser Leitfaden behandelt, was eine Chatbot-API ist, wann Sie sie einem eingebetteten Widget vorziehen sollten, die drei wichtigsten Verbindungsmethoden (REST, Zapier und Webhooks) sowie praktische Muster für den Aufbau echter Integrationen.

Was ist eine Chatbot-API?

Eine Chatbot-API stellt Ihren trainierten KI-Chatbot als Dienst bereit, den jeder Code über HTTP aufrufen kann. Sie senden eine Nutzernachricht im Request-Body, und die API gibt die Antwort des Chatbots zurück — basierend auf welchen Quellen (Website-Inhalte, Dokumente, Q&A-Paare) auch immer Sie zum Training verwendet haben.

Der entscheidende Unterschied zu einem vorgefertigten Widget: Die API gibt Rohdaten zurück. Ihre Anwendung entscheidet, wie sie präsentiert werden. Das bedeutet, Sie können denselben Chatbot in einer mobilen App, einem Slack-Bot, einem internen Dashboard und einer Backend-Automatisierungspipeline einbetten — alle mit derselben trainierten Wissensdatenbank.

Die meisten Chatbot-APIs folgen einem ähnlichen Muster:

1. Authentifizieren — fügen Sie einen API-Schlüssel im Authorization-Header ein.
2. Eine Nachricht per POST senden — senden Sie den Text des Nutzers, eine Chatbot-ID und optional eine Unterhaltungs-ID für mehrstufigen Kontext.
3. Die Antwort verarbeiten — parsen Sie die Antwort, streamen Sie optional Tokens für ein Echtzeitgefühl und speichern Sie die conversationId für die nächste Runde.

Für Teams, die Chatbot-Optionen vergleichen, bevor sie sich für eine Plattform entscheiden, deckt diese Übersicht der besten KI-Chatbots für Websites ab, worauf Sie bei den einzelnen Tools achten sollten.

Wann Sie die API statt des Widgets nutzen sollten

Das eingebettete Widget deckt die meisten Website-Anwendungsfälle ab. Die API ist die richtige Wahl, wenn Sie etwas brauchen, das das Widget nicht bieten kann.

Wenn Ihr Anwendungsfall in die rechte Spalte fällt, ist die API das richtige Werkzeug. Alle Einbettungsoptionen — Widget, React-Komponente, iFrame und WordPress-Plugin — finden Sie im Leitfaden zur Chatbot-Integration.

Verbindungsmethoden und Tarifverfügbarkeit

Es gibt drei Möglichkeiten, Ihren Chatbot mit externen Systemen zu verbinden. Sie dienen unterschiedlichen Zwecken und sind in unterschiedlichen Tarifen verfügbar.

Die REST-API gibt Ihnen die meiste Kontrolle. Zapier ist schneller eingerichtet, wenn Sie keinen individuellen Code brauchen. Webhooks ergänzen beide — sie senden Daten aktiv an Sie, statt darauf zu warten, dass Sie sie abrufen.

Eine vollständige Übersicht darüber, was jeder Tarif enthält, finden Sie im Leitfaden zu Chatbot-Kosten und -Preisen.

Tarifanforderungen

Die jährliche Abrechnung reduziert den Preis jedes Tarifs um rund 20 %. API-Nachrichten zählen genauso auf Ihr monatliches Kontingent wie Widget-Nachrichten.

Authentifizierung

Jede API-Anfrage erfordert ein Bearer-Token. Sie generieren API-Schlüssel in den Workspace-Einstellungen Ihres Agentkit-Dashboards.

Einen API-Schlüssel generieren

1. Öffnen Sie Ihren Agentkit-Workspace.
2. Navigieren Sie zu Einstellungen und dann zu API-Schlüssel.
3. Klicken Sie auf API-Schlüssel erstellen.
4. Geben Sie einen aussagekräftigen Namen ein (z. B. „Slack Bot Production“).
5. Kopieren Sie den Schlüssel sofort. Er wird nicht erneut angezeigt.

Den Schlüssel in Anfragen verwenden

Fügen Sie Ihren API-Schlüssel im Authorization-Header ein:

Authorization: Bearer ak_live_your_api_key_here

Alle Anfragen müssen über HTTPS gesendet werden. Anfragen ohne gültiges Token liefern eine 401 Unauthorized-Antwort.

Best Practices für die Schlüsselverwaltung

• Speichern Sie API-Schlüssel in Umgebungsvariablen, niemals im clientseitigen Code.
• Rotieren Sie Schlüssel regelmäßig, besonders nach Team-Änderungen.
• Erstellen Sie separate Schlüssel für separate Integrationen, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.
• Löschen Sie Schlüssel, die Sie nicht mehr verwenden.

Vollständige Details zur Authentifizierung finden Sie in der Authentifizierungsdokumentation.

Der Chat-Endpunkt

Der Kern der API ist ein einzelner Endpunkt, der eine Nutzernachricht an Ihren Chatbot sendet und die KI-Antwort zurückgibt.

Anfrage

POST /api/v1/chat
Content-Type: application/json
Authorization: Bearer ak_live_your_api_key_here

Anfrage-Body:

{
  "chatbotId": "your-chatbot-id",
  "message": "What are your shipping options?",
  "conversationId": "optional-conversation-id",
  "visitorId": "optional-visitor-id",
  "metadata": {
    "page": "/products/shoes",
    "userTier": "premium"
  }
}

Antwort

{
  "id": "msg_abc123",
  "conversationId": "conv_xyz789",
  "message": "We offer three shipping options: Standard (5-7 business days, free over $50), Express (2-3 business days, $9.99), and Overnight ($24.99). All orders include tracking.",
  "sources": [
    {
      "title": "Shipping Policy",
      "url": "https://example.com/shipping"
    }
  ],
  "createdAt": "2026-02-22T14:30:00Z"
}

Die conversationId in der Antwort ist wichtig. Speichern Sie sie und übergeben Sie sie bei nachfolgenden Anfragen erneut, um den Gesprächskontext zu erhalten. Ohne sie beginnt jede Nachricht eine neue Unterhaltung, und der Chatbot verliert den Faden.

Fehlerantworten

Die vollständige Endpunktreferenz finden Sie in der API-Dokumentation.

Streaming-Antworten

Für Echtzeitanwendungen, bei denen Sie die Antwort während der Generierung anzeigen wollen (der Schreibmaschineneffekt, den Nutzer von KI-Chats erwarten), verwenden Sie Server-Sent Events (SSE).

Fügen Sie Ihrer Anfrage den Parameter stream: true hinzu:

{
  "chatbotId": "your-chatbot-id",
  "message": "Explain your return policy",
  "conversationId": "conv_xyz789",
  "stream": true
}

Die Antwort kommt als Stream von SSE-Events an:

data: {"type": "token", "content": "Our"}
data: {"type": "token", "content": " return"}
data: {"type": "token", "content": " policy"}
data: {"type": "token", "content": " allows"}
...
data: {"type": "sources", "sources": [{"title": "Return Policy", "url": "https://example.com/returns"}]}
data: {"type": "done", "conversationId": "conv_xyz789", "messageId": "msg_def456"}

Den Stream in JavaScript verarbeiten

const response = await fetch('https://api.agentkit.com/api/v1/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ak_live_your_api_key_here'
  },
  body: JSON.stringify({
    chatbotId: 'your-chatbot-id',
    message: 'Explain your return policy',
    stream: true
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value);
  const lines = chunk.split('\n').filter(line => line.startsWith('data: '));

  for (const line of lines) {
    const data = JSON.parse(line.slice(6));
    if (data.type === 'token') {
      appendToUI(data.content);
    }
  }
}

Streaming wird für jede nutzerseitige Integration empfohlen. Es lässt den Chatbot reaktionsschnell wirken, selbst bei der Generierung langer Antworten.

Webhooks

Während Sie über den Chat-Endpunkt Nachrichten an den Chatbot senden, ermöglichen es Webhooks dem Chatbot, Daten an Sie zu senden. Wenn bestimmte Ereignisse eintreten, sendet Agentkit eine HTTP-POST-Anfrage an eine von Ihnen konfigurierte URL. Webhooks sind ab dem Tarif Hobby verfügbar.

Webhooks einrichten

1. Gehen Sie in Ihrem Workspace zu Einstellungen und dann zu Webhooks.
2. Geben Sie Ihre Endpunkt-URL ein (muss HTTPS sein).
3. Wählen Sie aus, welche Ereignisse Sie abonnieren möchten.
4. Speichern Sie. Agentkit sendet eine Verifizierungsanfrage, um zu bestätigen, dass Ihr Endpunkt erreichbar ist.

Verfügbare Ereignisse

Webhook-Payload

Jeder Webhook-POST enthält einen JSON-Body mit einer einheitlichen Struktur:

{
  "event": "lead.captured",
  "timestamp": "2026-02-22T15:45:00Z",
  "chatbotId": "your-chatbot-id",
  "conversationId": "conv_xyz789",
  "data": {
    "name": "Alex Chen",
    "email": "[email protected]",
    "message": "Interested in the enterprise plan"
  },
  "signature": "sha256=abc123..."
}

Überprüfen Sie immer das Feld signature gegen Ihr Webhook-Secret, um zu bestätigen, dass die Anfrage von Agentkit stammt und nicht von Dritten.

Wiederholungsverhalten

Wenn Ihr Endpunkt einen Statuscode außerhalb des 2xx-Bereichs zurückgibt, wiederholt Agentkit mit exponentiellem Backoff: nach 1 Minute, 5 Minuten, 30 Minuten und stoppt dann. Fehlgeschlagene Zustellungen sehen Sie in den Webhook-Protokollen in Ihrem Dashboard.

Häufige Integrationsmuster

Muster 1: Slack-Bot

Leiten Sie Kundenfragen aus Ihrem Website-Chatbot an einen Slack-Kanal weiter und lassen Sie Ihr Team antworten, wenn die KI keine Antwort findet.

1. Erstellen Sie eine Slack-App mit aktivierten eingehenden Webhooks.
2. Richten Sie einen Agentkit-Webhook für conversation.completed-Ereignisse ein.
3. Prüfen Sie in Ihrem Webhook-Handler, ob die Unterhaltung gelöst oder eskaliert wurde.
4. Senden Sie im Eskalationsfall per POST eine formatierte Nachricht mit dem Gesprächsverlauf an Ihre Slack-Webhook-URL.

So hat Ihr Support-Team Einblick, ohne das Agentkit-Dashboard überwachen zu müssen.

Muster 2: Individuelle Chat-UI

Ersetzen Sie das Standard-Widget durch eine Chat-Erfahrung, die in Ihre Anwendung integriert ist.

1. Bauen Sie Ihre Chat-Oberfläche mit Ihrem bevorzugten Framework.
2. Rufen Sie beim Absenden einer Nachricht den Chat-Endpunkt mit stream: true auf.
3. Rendern Sie Tokens, sobald sie eintreffen, für Echtzeit-Feedback.
4. Speichern Sie die conversationId im lokalen State, um den Kontext über mehrere Nachrichten hinweg zu erhalten.

Das ist der richtige Ansatz für mobile Apps, Desktop-Anwendungen oder jedes Produkt, bei dem das schwebende Widget nicht ins Design passt. Für Teams, die beim Widget bleiben wollen, aber mehr Kontrolle über die Platzierung brauchen, deckt der Leitfaden zum Einbetten eines Chatbots auf Ihrer Website alle vier Einbettungsoptionen ab.

Muster 3: Backend-Automatisierung

Nutzen Sie den Chatbot als KI-Schicht in einem größeren Workflow, ganz ohne Chat-UI.

Beispiel: Support-Tickets verarbeiten.

1. Ein neues Ticket geht in Ihrem Ticketsystem ein.
2. Ihr Backend sendet den Ticketinhalt an den Chat-Endpunkt.
3. Der Chatbot generiert eine vorgeschlagene Antwort auf Basis Ihrer trainierten Wissensdatenbank.
4. Ihr System antwortet entweder automatisch (bei hoher Konfidenz) oder stellt den Vorschlag zur menschlichen Überprüfung in eine Warteschlange.

Dieses Muster funktioniert, weil der Chatbot auf derselben Wissensdatenbank trainiert ist, die Ihr Support-Team verwendet. Die API gibt Ihnen programmatischen Zugriff auf diese Intelligenz. Mehr dazu, womit Sie einen Chatbot trainieren können — Website-Crawls, PDFs, CSVs, Q&A-Paare — finden Sie unter Wie Sie einen Chatbot trainieren.

Muster 4: Analyse-Pipeline

Erfassen Sie jede Unterhaltung zur Analyse.

1. Abonnieren Sie die Webhook-Ereignisse message.received und message.sent.
2. Ihr Webhook-Handler schreibt Ereignisse in Ihr Data Warehouse (BigQuery, Snowflake usw.).
3. Erstellen Sie Dashboards, die häufige Fragen, Lösungsraten, Stoßzeiten und Gesprächstrends zeigen.

Über das metadata-Feld im Chat-Endpunkt hängen Sie Kontext an (Seiten-URL, Nutzersegment, A/B-Test-Variante), der Ihre Analysen anreichert.

Ratenlimit

Die API setzt Ratenlimits durch, um die Zuverlässigkeit für alle Nutzer sicherzustellen.

Wenn Sie das Limit erreichen, gibt die API einen 429-Statuscode mit einem Retry-After-Header zurück, der angibt, wie viele Sekunden Sie warten sollen. Bauen Sie eine Wiederholungslogik in Ihre Integration ein:

async function sendMessage(payload, retries = 3) {
  const response = await fetch(API_URL, {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(payload)
  });

  if (response.status === 429 && retries > 0) {
    const retryAfter = parseInt(response.headers.get('Retry-After') || '5');
    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
    return sendMessage(payload, retries - 1);
  }

  return response.json();
}

Sicherheitsüberlegungen

Beachten Sie beim Aufbau von API-Integrationen diese Praktiken:

• Legen Sie API-Schlüssel nie im clientseitigen Code offen. Wenn Sie eine individuelle Chat-UI für eine Web-App bauen, leiten Sie Anfragen über Ihr eigenes Backend.
• Validieren Sie Webhook-Signaturen. Überprüfen Sie immer die HMAC-Signatur, bevor Sie Webhook-Payloads verarbeiten.
• Nutzen Sie Domain-Beschränkungen. Beschränken Sie in Ihren Chatbot-Einstellungen, welche Domains mit Ihrem Chatbot interagieren dürfen.
• Überwachen Sie die Nutzung. Prüfen Sie Ihre API-Nutzung regelmäßig im Dashboard, um unerwartete Ausschläge zu erkennen, die auf einen geleakten Schlüssel hindeuten könnten.
• Wenden Sie das Prinzip der geringsten Berechtigung an. Wenn eine Integration nur Nachrichten senden muss, geben Sie ihr keinen Schlüssel mit Admin-Berechtigungen.

Für Teams, die erkunden, wie sich KI-Chatbot-APIs mit größeren Tool-Ökosystemen verbinden, lohnt es sich, MCP (Model Context Protocol) zu verstehen — einen aufkommenden Standard, der KI-Modellen strukturierten Zugriff auf externe Tools und Daten gibt.

Erste Schritte

Der schnellste Weg von null zu einer funktionierenden Integration:

1. Melden Sie sich für ein Agentkit-Konto an und erstellen Sie Ihren ersten Chatbot.
2. Trainieren Sie den Chatbot mit Ihren Inhalten (siehe Wie Sie einen Chatbot trainieren).
3. Führen Sie ein Upgrade auf den Tarif Hobby ($29.99/Monat) durch, um API-Zugriff zu aktivieren.
4. Generieren Sie einen API-Schlüssel in Ihren Workspace-Einstellungen.
5. Senden Sie Ihre erste Testanfrage mit cURL oder Postman.
6. Bauen Sie von dort aus weiter: individuelle UI, Slack-Bot, Automatisierung oder was Ihr Anwendungsfall verlangt.

Häufig gestellte Fragen

Was ist ein Chatbot-API-Schlüssel?

Ein Chatbot-API-Schlüssel ist ein geheimes Token, das Ihre Anwendung authentifiziert, wenn sie Anfragen an die Chatbot-API stellt. Sie generieren ihn in Ihren Workspace-Einstellungen, fügen ihn in jeder Anfrage im Authorization: Bearer-Header ein und behandeln ihn wie ein Passwort — speichern Sie ihn in Umgebungsvariablen, niemals im clientseitigen Code, und rotieren Sie ihn, wenn Sie vermuten, dass er offengelegt wurde. Jeder Schlüssel kann auf eine bestimmte Integration begrenzt werden, sodass Sie einen widerrufen können, ohne die anderen zu beeinträchtigen.

Gibt es eine kostenlose Chatbot-API?

Der Tarif Free von Agentkit ($0/Monat) enthält keinen REST-API-Zugriff — dafür ist der Tarif Hobby für $29.99/Monat erforderlich. Der Tarif Free enthält das einbettbare JS-Widget, Lead-Erfassung und Domain-Beschränkungen, die die meisten Website-Anwendungsfälle ganz ohne Code abdecken. Wenn Sie von Anfang an programmatischen Zugriff brauchen, ist der Tarif Hobby der Einstiegspunkt, und Sie können die gesamte Plattform kostenlos testen, bevor Sie upgraden.

Muss ich programmieren können, um eine Chatbot-API zu nutzen?

Nicht immer. Wenn Sie REST-API-Zugriff für individuelle Integrationen brauchen, müssen Sie Code schreiben — oder ein Tool wie Postman nutzen, um Aufrufe manuell zu testen. Wenn Ihr Ziel jedoch ist, den Chatbot ohne Code mit anderen Apps zu verbinden, verbindet die Zapier-Integration (verfügbar ab dem Tarif Hobby und höher) über eine No-Code-Oberfläche mit 7.000+ Apps. Für die Website-Einbettung ist außer dem Einfügen eines <script>-Tags kein Code erforderlich.

Welche KI-Modelle unterstützt die Chatbot-API?

Das zugrunde liegende KI-Modell wird pro Chatbot im Dashboard konfiguriert. Agentkit unterstützt Modelle von drei Anbietern: OpenAI (GPT-5.6 Sol, GPT-5.6 Terra, GPT-5.6 Luna), Anthropic (Claude Opus 5, Claude Sonnet 5, Claude Haiku 4.5) und Google (Gemini 3.7 Flash, Gemini 3.1 Pro). Die Standardeinstellung ist GPT-5.6 Luna. Ihre API-Aufrufe nutzen das jeweils für diesen Chatbot ausgewählte Modell — Sie geben das Modell nicht auf Ebene des API-Aufrufs an.

Kann ich die Chatbot-API nutzen, um Chat auf meiner Website einzubetten?

Ja, aber die JS-Widget-Einbettung ist für Website-Anwendungsfälle meist einfacher. Das Widget lädt asynchron über ein einzelnes <script>-Tag und übernimmt UI, Gesprächsstatus und Streaming automatisch. Nutzen Sie die API, wenn Sie eine vollständig individuelle UI, eine Integration in eine mobile App oder Backend-Automatisierung brauchen. Einen direkten Vergleich aller Einbettungsoptionen finden Sie im Leitfaden zum Einbetten eines Chatbots auf Ihrer Website.

Eine Chatbot-API macht aus einer trainierten Wissensdatenbank einen aufrufbaren Dienst — dieselben KI-Antworten, die im Widget erscheinen, stehen jedem System zur Verfügung, das eine HTTP-Anfrage stellen kann. Egal ob Sie eine individuelle Oberfläche bauen, einen Support-Workflow automatisieren oder Ihren Chatbot mit einem größeren Tool-Ökosystem verbinden — die API gibt Ihnen die Kontrolle, die ein vorgefertigtes Widget nicht bieten kann.

Erstellen Sie Ihren Chatbot kostenlos → Keine Kreditkarte erforderlich.