KI-Chatbot-API

Erstellen Sie eigene KI-Chatbot-Integrationen mit unserer REST-API. Senden Sie Nachrichten und erhalten Sie intelligente KI-Antworten für jede Plattform, jede Anwendung und jede eigene Lösung.

API-Schlüssel holen Preise ansehen

Bauen Sie alles mit KI

Mit unserer REST-API integrieren Sie KI-Chatbot-Funktionen in jede Anwendung

# Nachricht an die KI senden
curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Wie sind Ihre Öffnungszeiten?"}'

Einfache REST-API

Ein einziger API-Endpunkt für Nachrichten und KI-Antworten. Nutzen Sie cURL, Python, JavaScript oder jede Sprache, die HTTP-Anfragen senden kann. Kein komplexes SDK nötig.

# KI-Antwort
{
  "success": true,
  "response": "Wir haben Montag bis Freitag
    9 bis 18 Uhr geöffnet. Wie kann ich helfen?"
,
  "session_id": "abc123"
}

Intelligente Antworten

Die KI kennt Ihr Unternehmen genau. Sie greift auf Ihre Website, Ihre Dokumente und Ihre eigenen Anweisungen zu und gibt darauf gestützte, passende Antworten auf jede Frage.

# Unterhaltung mit Kontext
{
  "message": "Was war meine letzte Frage?",
  "session_id": "user_12345"
}

# Die KI merkt sich die Unterhaltung

Gesprächsverlauf

Mit Session-IDs bleibt der Gesprächskontext erhalten. Die KI merkt sich frühere Nachrichten und antwortet über mehrere Interaktionen hinweg zusammenhängend.

Für Entwickler gebaut

Alles, was Sie brauchen, um KI-Chatbot-Funktionen in Ihre Anwendungen einzubauen

RESTful-Design

Klare, verständliche REST-API nach bewaehrten Standards. Einfach zu verstehen, einfach zu integrieren, einfach zu pflegen.

Einfache Authentifizierung

Sichere Authentifizierung per API-Schlüssel. Schlüssel in den Header setzen und los geht es.

Kurze Antwortzeiten

Auf Geschwindigkeit ausgelegt. KI-Antworten in Millisekunden statt Sekunden.

Session-Verwaltung

Eingebaute Gesprächsverfolgung mit Session-IDs. Kontext über mehrere Nachrichten hinweg ganz ohne Aufwand.

Mehrsprachig

Die KI erkennt die Sprache des Nutzers und antwortet darin. Betreuen Sie ein weltweites Publikum ohne Zusatzaufwand.

Sicher und zuverlässig

HTTPS-Verschlüsselung, Ratenbegrenzung und 99,9 % Verfügbarkeit. Ihre Integration ist sicher und immer erreichbar.

Bereit, mit der KI-Chatbot-API zu bauen?

Testen Sie den Chatbot kostenlos mit 100 Nachrichten. Der API-Zugang benötigt einen bezahlten Tarif.Keine Kreditkarte nötig.

Ihren API-Schlüssel holen

So funktioniert es

In drei einfachen Schritten mit der KI-Chatbot-API starten

1

Registrieren und API-Schlüssel holen

Legen Sie Ihr Konto an und erzeugen Sie den API-Schlüssel im Dashboard. Ihre KI nutzt dann automatisch die Inhalte Ihrer Website.

2

Erste Anfrage senden

Senden Sie eine POST-Anfrage mit Ihrer Nachricht an unseren Chat-Endpunkt. Die KI verarbeitet sie und liefert eine intelligente Antwort.

3

Überall integrieren

Nutzen Sie die API in Ihrer mobilen App, auf Ihrer Website, in internen Werkzeugen oder auf jeder eigenen Plattform. Die Möglichkeiten sind offen.

API-Dokumentation ansehen

Anwendungsfälle

Die KI-Chatbot-API ist vielseitig und liefert KI-Support für jede Plattform und jede Anwendung, die Sie sich vorstellen können.

  • Mobile Apps (iOS, Android, React Native)
  • Eigene Webanwendungen
  • Interne Support-Werkzeuge
  • Sprachassistenten und IVR-Systeme
  • Slack-Bots, Discord-Bots und mehr
# Python-Beispiel
import requests

response = requests.post(
  "https://asyntai.com/api/v1/chat/",
  headers={"Authorization": "Bearer API_KEY"},
  json={"message": "Hallo!"}
)

print(response.json()["response"])

Einfache, klare Preise

Der Free-Tarif umfasst 100 Testnachrichten im Dashboard. Der API-Zugang beginnt mit Starter.Nachrichten. Upgraden, wenn Ihre API-Nutzung wächst.

Free
$0
für immer
100 Nachrichten
Loslegen
Starter
$39
pro Monat
2.500 Nachrichten
Loslegen
Pro
$449
pro Monat
50.000 Nachrichten
Loslegen

Warum unsere API

Starke KI-Chatbot-Integrationen mit minimalem Aufwand bauen

Schneller ausliefern

Sparen Sie Monate an KI-Entwicklung. Binden Sie unsere API ein und haben Sie noch heute intelligente Chatbot-Funktionen in Ihrer App.

Immer aktuell

Aktualisieren Sie das Wissen Ihrer KI jederzeit im Dashboard. Änderungen an der API sind nicht nötig, wenn sich Ihr Geschaeft weiterentwickelt.

Kosteneffizient

Zahlen Sie nur, was Sie nutzen. Keine Infrastrukturkosten, keine Kosten für KI-Training, kein Wartungsaufwand.

Starten Sie noch heute

Der API-Zugang benötigt Starter, Standard oder Pro. Mit einem kostenlosen Konto testen Sie zuerst den Chatbot.inklusive. Jederzeit upgraden, wenn Ihre Nutzung wächst.

Ihren API-Schlüssel holen

Häufige Fragen

Alles Wichtige zur KI-Chatbot-API

Wie starte ich mit der API?
Hier klicken, um den API-Schlüssel zu holen. Legen Sie ein Konto an, tragen Sie die URL Ihrer Website ein, damit die KI Ihr Unternehmen kennt, und erzeugen Sie den API-Schlüssel. Senden Sie dann Ihre erste Anfrage mit cURL, Python, JavaScript oder einem beliebigen HTTP-Client.
Welche Programmiersprachen werden unterstützt?
Jede Sprache, die HTTP-Anfragen senden kann, funktioniert mit unserer API. Dazu gehören Python, JavaScript, PHP, Ruby, Java, C#, Go, Swift, Kotlin und viele weitere. Codebeispiele finden Sie in unserer Dokumentation.
Wie funktioniert der Gesprächskontext?
Senden Sie den Parameter session_id in Ihren Anfragen mit. Die KI merkt sich alle früheren Nachrichten dieser Session und antwortet passend zum Verlauf. Nutzen Sie eine beliebige eindeutige Kennung je Nutzer oder Unterhaltung.
Woher kennt die KI mein Unternehmen?
Sie geben der KI Wissen über Ihr Unternehmen, indem Sie Ihre Website-URL angeben, die wir automatisch auslesen, Dokumente hochladen, etwa PDF- oder Textdateien, eigene Anweisungen ergaenzen oder konkrete Frage-Antwort-Paare hinterlegen. All das laeuft über das Dashboard, Änderungen an der API sind nicht nötig.
Wie hoch sind die Ratenbegrenzungen?
Die Ratenbegrenzungen hängen von Ihrem Tarif ab. Die API ist für Chat-Anwendungen in Echtzeit ausgelegt. Wenn Sie höhere Grenzen brauchen, sprechen Sie uns an.
Ist die API sicher?
Ja. Alle API-Anfragen laufen über HTTPS. Halten Sie Ihren API-Schlüssel geheim und geben Sie ihn niemals im Code auf der Client-Seite preis. Wir empfehlen, API-Aufrufe von Ihrem eigenen Server aus zu senden.
Entwickler-Referenz

Ihre erste Anfrage

Ein POST liefert eine KI-Antwort auf Basis Ihrer Wissensdatenbank. Kein SDK nötig.

POST /api/v1/chat/curl
curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Liefern Sie nach Deutschland?"}'

# 200 OK
{
  "success": true,
  "response": "Ja, wir liefern in 3-5 Tagen nach Deutschland.",
  "session_id": "api_1042_87"
}

Vor dem ersten Aufruf füllen Sie Ihre Wissensdatenbank. Die API antwortet auf Basis Ihrer eigenen Dokumentation, Preise und Richtlinien. Ist die Wissensdatenbank leer, bleiben die Antworten allgemein.

Authentifizierung

Jede Anfrage trägt Ihren API-Schlüssel im Header. Zwei Header-Formen sind zulässig und verhalten sich gleich. Wählen Sie eine. Den Schlüssel erzeugen Sie unter Einstellungen → API.

Nur Header. Der Schlüssel wird nie aus dem Query-String gelesen. Ein Schlüssel in einer URL landet in Server-Logs, Proxy-Logs, im Browserverlauf und in Referer-Headern. Deshalb wird dieser Weg nicht unterstützt.

Zwei zulässige Formenhttp
# Variante A - Bearer-Token
Authorization: Bearer YOUR_API_KEY

# Variante B - eigener Header
X-API-Key: YOUR_API_KEY

Der Chat-Endpunkt

POST https://asyntai.com/api/v1/chat/

Anfrage-Body

FeldTypPflichtBeschreibung
messagestringerforderlichDie Nachricht des Nutzers. Ein leerer Wert ergibt einen 400er.
session_idstringoptionalIhre eigene Kennung für eine Unterhaltung. Senden Sie denselben Wert erneut, um den Kontext zu behalten. Ohne Angabe nutzt das Konto eine einzige gemeinsame Session.
website_idintegeroptionalWelcher Ihrer Agenten antworten soll. Ohne Angabe wird Ihre primäre Website genutzt, sonst die erste im Konto.

Antwort-Body

FeldTypBeschreibung
successbooleantrue, wenn die KI eine Antwort erzeugt hat.
responsestringDer Antworttext.
session_idstringDie Session, unter der diese Nachricht abgelegt wurde. Senden Sie sie beim nächsten Aufruf zurück.

Gesprächsverlauf

Übergeben Sie eine feste session_id, dann werden die letzten 10 Nachrichten dieser Unterhaltung als Kontext mitgegeben. So wird eine Rückfrage wie "und was kostet das?" richtig verstanden. Nutzen Sie je Endnutzer eine eigene session_id. Ohne Angabe teilen sich alle Aufrufe des Kontos einen Verlauf, was im Produktivbetrieb fast nie gewollt ist.

Kontext über zwei Aufrufe haltenjson
// erster Aufruf
{ "message": "Liefern Sie nach Deutschland?", "session_id": "user-8842" }

// zweiter Aufruf - gleiche session_id, daher wird "das" verstanden
{ "message": "Was kostet das?", "session_id": "user-8842" }

Integrationsbeispiele

Kopieren, einfügen, Schlüssel ersetzen.

fetch auf dem Serverjavascript
const res = await fetch('https://asyntai.com/api/v1/chat/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Liefern Sie nach Deutschland?',
    session_id: 'user-8842'
  })
});

const data = await res.json();
if (!data.success) throw new Error(data.error);
console.log(data.response);

// Geben Sie Ihren API-Schlüssel nie im Browser-Code aus. Rufen Sie dies
// vom eigenen Server oder einer Edge-Funktion auf und reichen Sie das Ergebnis weiter.
Python 3python
import requests

resp = requests.post(
    "https://asyntai.com/api/v1/chat/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "message": "Liefern Sie nach Deutschland?",
        "session_id": "user-8842",
    },
    timeout=30,
)

data = resp.json()
if not data["success"]:
    raise RuntimeError(data["error"])

print(data["response"])
PHP 8php
$ch = curl_init('https://asyntai.com/api/v1/chat/');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'message'    => 'Liefern Sie nach Deutschland?',
        'session_id' => 'user-8842',
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

if (empty($data['success'])) {
    throw new Exception($data['error']);
}
echo $data['response'];
Node.js 18+javascript
const ASYNTAI_KEY = process.env.ASYNTAI_API_KEY;

export async function ask(message, sessionId) {
  const res = await fetch('https://asyntai.com/api/v1/chat/', {
    method: 'POST',
    headers: {
      'X-API-Key': ASYNTAI_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ message, session_id: sessionId })
  });

  if (res.status === 429) throw new Error('Monatliches Nachrichtenlimit erreicht');

  const data = await res.json();
  if (!data.success) throw new Error(data.error);
  return data.response;
}
Shellcurl
curl -X POST https://asyntai.com/api/v1/chat/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Liefern Sie nach Deutschland?",
    "session_id": "user-8842"
  }'

Fehlerantworten

Jeder Fehler liefert {"success": false, "error": "..."} mit einem dieser Statuscodes.

StatusBedeutungWas zu tun ist
400Ungültiger JSON-Body, fehlendes message oder eine website_id, die nicht zu Ihrem Konto gehört.Korrigieren Sie die Nutzdaten. Der Text in error nennt das Problem.
401Kein API-Schlüssel, oder der Schlüssel passt zu keinem Konto.Prüfen Sie den Header-Namen und ob der Schlüssel neu erzeugt wurde.
403Das Konto nutzt den Free-Tarif. Der API-Zugang benötigt Starter, Standard oder Pro.Tarif upgraden.
429Monatliches Nachrichtenlimit erreicht. Der Body enthält zusätzlich "limit_reached": true.Drosseln und upgraden, oder auf den nächsten Abrechnungszeitraum warten.
503Der KI-Dienst konnte diese Anfrage nicht beantworten.Mit Wartezeit erneut versuchen. Der Fehler ist vorübergehend.

Prüfen Sie success, nicht nur den Statuscode. Behandeln Sie 429 ausdrücklich, wenn Sie viele Anfragen senden. Sonst wirkt ein erreichtes Limit auf Ihre Nutzer wie ein allgemeiner Fehler.

Vollständige Endpunkt-Referenz

Basis-URL https://asyntai.com/api/v1/. Alle Endpunkte nutzen dieselbe Authentifizierung.

Chat

MethodePfadZweck
POST/chat/Nachricht senden, KI-Antwort erhalten.

Websites und Agenten

MethodePfadZweck
GETPOST/websites/Agenten auflisten oder einen anlegen und das Auslesen starten.
GET/websites/{id}/Details zu einem Agenten.
GETPATCH/websites/{id}/settings/Widget-Einstellungen lesen oder ändern.
GETPUT/websites/{id}/instructions/KI-Anweisungen lesen oder ersetzen.

Wissensdatenbank

MethodePfadZweck
GET/knowledge/Alles auflisten, worauf die KI zugreifen kann.
POST/knowledge/text/Reinen Text hinzufügen.
POST/knowledge/url/Eine Seite per URL hinzufügen.
POST/knowledge/spreadsheet/Eine Tabelle hinzufügen.
GETDELETE/knowledge/{context_id}/Einen Eintrag lesen oder entfernen.
POSTPUT/knowledge/{context_id}/tags/Schlagworte eines Eintrags verwalten.

Unterhaltungen und Daten

MethodePfadZweck
GET/conversations/Frühere Unterhaltungen.
GET/sessions/Sessions mit Nachrichtenzahl.
GET/leads/Vom Chatbot erfasste Kontaktdaten.
GET/account/Tarif, Nutzung und Grenzen.

Webhooks

MethodePfadZweck
GETPOST/webhooks/Webhook auflisten oder registrieren.
DELETE/webhooks/{webhook_id}/Webhook entfernen.

Voraussetzungen und Grenzen

PunktDetail
TarifDer API-Zugang benötigt einen bezahlten Tarif: Starter, Standard oder Pro. Free-Konten erhalten einen 403er.
NachrichtenkontingentAPI-Nachrichten zählen auf dasselbe monatliche Kontingent wie Widget-Unterhaltungen. Den aktuellen Stand liefert GET /api/v1/account/.
VerlaufstiefeBis zu 10 vorherige Nachrichten je session_id werden als Kontext mitgegeben.
ÜbertragungNur HTTPS. JSON in Anfrage und Antwort.
SchlüsselwechselErzeugen Sie den Schlüssel unter Einstellungen → API neu. Der alte Schlüssel wird sofort ungültig.

Bereit, mit KI zu bauen?

Legen Sie ein kostenloses Konto an und testen Sie den Chatbot im Dashboard. Für den API-Schlüssel wählen Sie dann einen bezahlten Tarif.Sie kostenlos mit 100 API-Aufrufen und sehen Sie, wie einfach sich KI-Chatbot-Funktionen in Ihre Anwendung einbauen lassen.

API-Schlüssel holen - bezahlter Tarif erforderlich