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.
Bauen Sie alles mit KI
Mit unserer REST-API integrieren Sie KI-Chatbot-Funktionen in jede Anwendung
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.
{
"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.
{
"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.
So funktioniert es
In drei einfachen Schritten mit der KI-Chatbot-API starten
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.
Erste Anfrage senden
Senden Sie eine POST-Anfrage mit Ihrer Nachricht an unseren Chat-Endpunkt. Die KI verarbeitet sie und liefert eine intelligente Antwort.
Ü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.
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
import requests
response = requests.post(
"https://asyntai.com/api/v1/chat/",
headers={"Authorization": "Bearer API_KEY"},
json={"message": "Hallo!"}
)
print(response.json()["response"])
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.
Häufige Fragen
Alles Wichtige zur KI-Chatbot-API
Ihre erste Anfrage
Ein POST liefert eine KI-Antwort auf Basis Ihrer Wissensdatenbank. Kein SDK nötig.
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.
# 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
message | string | erforderlich | Die Nachricht des Nutzers. Ein leerer Wert ergibt einen 400er. |
session_id | string | optional | Ihre 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_id | integer | optional | Welcher Ihrer Agenten antworten soll. Ohne Angabe wird Ihre primäre Website genutzt, sonst die erste im Konto. |
Antwort-Body
| Feld | Typ | Beschreibung |
|---|---|---|
success | boolean | true, wenn die KI eine Antwort erzeugt hat. |
response | string | Der Antworttext. |
session_id | string | Die 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.
// 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.
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.
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"])
$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'];
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;
}
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.
| Status | Bedeutung | Was zu tun ist |
|---|---|---|
400 | Ungü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. |
401 | Kein 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. |
403 | Das Konto nutzt den Free-Tarif. Der API-Zugang benötigt Starter, Standard oder Pro. | Tarif upgraden. |
429 | Monatliches Nachrichtenlimit erreicht. Der Body enthält zusätzlich "limit_reached": true. | Drosseln und upgraden, oder auf den nächsten Abrechnungszeitraum warten. |
503 | Der 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
| Methode | Pfad | Zweck |
|---|---|---|
| POST | /chat/ | Nachricht senden, KI-Antwort erhalten. |
Websites und Agenten
| Methode | Pfad | Zweck |
|---|---|---|
| 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
| Methode | Pfad | Zweck |
|---|---|---|
| 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
| Methode | Pfad | Zweck |
|---|---|---|
| GET | /conversations/ | Frühere Unterhaltungen. |
| GET | /sessions/ | Sessions mit Nachrichtenzahl. |
| GET | /leads/ | Vom Chatbot erfasste Kontaktdaten. |
| GET | /account/ | Tarif, Nutzung und Grenzen. |
Webhooks
| Methode | Pfad | Zweck |
|---|---|---|
| GETPOST | /webhooks/ | Webhook auflisten oder registrieren. |
| DELETE | /webhooks/{webhook_id}/ | Webhook entfernen. |
Voraussetzungen und Grenzen
| Punkt | Detail |
|---|---|
| Tarif | Der API-Zugang benötigt einen bezahlten Tarif: Starter, Standard oder Pro. Free-Konten erhalten einen 403er. |
| Nachrichtenkontingent | API-Nachrichten zählen auf dasselbe monatliche Kontingent wie Widget-Unterhaltungen. Den aktuellen Stand liefert GET /api/v1/account/. |
| Verlaufstiefe | Bis zu 10 vorherige Nachrichten je session_id werden als Kontext mitgegeben. |
| Übertragung | Nur HTTPS. JSON in Anfrage und Antwort. |
| Schlüsselwechsel | Erzeugen 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.