Zulässige Domain
Der Request-Origin muss mit einer in den Assistenten-Einstellungen zugelassenen Domain übereinstimmen. Browser senden ihn automatisch.
Ergänzen Sie Ihre Website um das Chat-Widget oder Informio Search. Eigene Oberflächen nutzen die öffentliche API mit freigegebenen Domains, Lokalisierung und den vorhandenen Assistentendaten.
Einfachste Bereitstellung
Erlauben Sie zunächst die Domain Ihrer Website in den Assistenten-Einstellungen. Ersetzen Sie dann ASSISTANT_ID durch die öffentliche Assistenten-ID und fügen Sie den Code in die Seite ein. Das Widget lädt sein Erscheinungsbild, seine Beschriftungen und den Gesprächsverlauf automatisch.
<script src="https://informio.eu/widget.js" data-assistant="ASSISTANT_ID" defer></script>Platzieren Sie den Code vor dem schließenden </body>-Tag. Das defer-Attribut verhindert, dass das Laden der Seite blockiert wird, und das Widget funktioniert auf Desktop und Mobilgeräten.
Der Request-Origin muss mit einer in den Assistenten-Einstellungen zugelassenen Domain übereinstimmen. Browser senden ihn automatisch.
Ihre zufällige session_id bewahrt den Chat-Verlauf zwischen Nachrichten und beim erneuten Öffnen des Clients.
Die Assistenten-ID ist kein geheimer API-Schlüssel. Legen Sie niemals Geheimnisse oder Zugangsdaten des KI-Anbieters im Client ab.
Informio Search
Das Skript stellt Suchfeld, Vorschläge und Ergebnisse dar und ruft die Informio-API selbst auf. Die einbindende Website benötigt kein eigenes Such-Backend.
<div id="informio-search"></div>
<script src="https://informio.eu/search.js"
data-assistant="ASSISTANT_ID"
data-target="#informio-search" defer></script>data-target ist ein CSS-Selektor für einen vorhandenen Container. Ohne dieses Attribut erscheint das Feld an der Skriptposition. Container-IDs müssen eindeutig sein. Nutzen Sie pro Suchfeld ein eigenes Skript und einen eigenen Container.
Lassen Sie den Container in React/Vue oder einer anderen SPA im dauerhaften Layout und laden Sie das Skript einmal nach seiner Erstellung mit document.createElement('script'). Über innerHTML eingefügte Skripte werden nicht ausgeführt. Für häufig wechselnde Komponenten nutzen Sie die API unten.
Farbe, Design, Ecken und Sprache stammen vom Assistenten. Wählen Sie Inline- oder Dialogergebnisse und die optionale KI-Zusammenfassung. Shadow DOM trennt die Oberfläche vom CSS der Website.
Ausgewählte Website-/XML-Quellen benötigen öffentliche HTTP(S)-URLs. Eigenständige MD- und Dokumentquellen werden nicht unterstützt. Ergebnisse nutzen die zuletzt synchronisierten Daten.
Autocomplete ruft keine KI auf. Eine erfolgreiche bestätigte KI-Suche samt optionaler Zusammenfassung verbraucht eine Antwort der Organisation.
Diese API ist für eigene Oberflächen gedacht. Das fertige search.js übernimmt bereits alle Anfragen. Search benötigt weder session_id noch einen geheimen API-Schlüssel.
/api/search/{assistant}Liefert Darstellung, Sprache, Anzeigemodus, Branding und lokalisierte Texte.
/api/search/{assistant}/suggest?q=wellnessTextvorschläge ohne KI, maximal 6 Treffer. Der erforderliche Parameter q umfasst 3–300 Zeichen.
/api/search/{assistant}/resultsDer JSON-Body enthält q mit 3–300 Zeichen. Liefert maximal 24 Treffer sowie summary, mode und notice.
Senden Sie Accept: application/json und bei POST zusätzlich Content-Type: application/json. Der Browser sendet Origin automatisch; die Domain muss freigegeben sein. Accept-Language wählt bei automatischer Assistentensprache die Sprache. Verzögern Sie Vorschläge um 300 ms und brechen Sie veraltete Anfragen ab.
const assistantId = 'ASSISTANT_ID';
const query = 'wellness';
const response = await fetch(
`https://informio.eu/api/search/${assistantId}/results`,
{
method: 'POST',
credentials: 'omit',
headers: {
Accept: 'application/json',
'Content-Type': 'application/json',
'Accept-Language': document.documentElement.lang || 'en',
},
body: JSON.stringify({ q: query }),
},
);
if (!response.ok) throw new Error(String(response.status));
const { results, summary, mode, notice } = await response.json();
const container = document.querySelector('#custom-search-results');
container.replaceChildren();
for (const item of results) {
const url = new URL(item.url);
if (!['https:', 'http:'].includes(url.protocol)
|| url.username || url.password) continue;
const link = document.createElement('a');
link.href = url.href;
link.textContent = item.title;
container.append(link);
}{
"results": [
{
"title": "Wellness und Öffnungszeiten",
"url": "https://example.com/wellness",
"type": "page",
"excerpt": "Pool, Saunalandschaft und praktische Hinweise vor Ihrem Besuch.",
"image_url": null,
"price": null,
"currency": null,
"in_stock": null
}
],
"summary": null,
"mode": "ai",
"notice": null
}results enthält Karten; type ist page, article, product, event oder profile. Bild, Preis, Währung und Lagerstatus können null sein. summary ist Text oder null; mode ist ai oder text; notice ist eine lokalisierte Meldung oder null. Maximal 24 Treffer, ohne Paginierung.
Das JavaScript-Beispiel erwartet den Container #custom-search-results und zeigt Links an. Nutzen Sie für Auszüge, summary und notice textContent statt innerHTML. Prüfen Sie HTTP(S)-URLs und laden Sie Bilder nur bei vorhandenem image_url.
Konfiguration und Vorschläge teilen sich 120 Anfragen pro Minute je Assistent/IP. Für Ergebnisse gelten 20 pro Minute je Assistent/IP. Beachten Sie bei 429 den Retry-After-Header.
Bei KI-Fehlern oder erreichtem Tariflimit kann HTTP 200 mit mode: text erscheinen, ohne Antwortverbrauch. Scheitert nur die Zusammenfassung, bleibt mode: ai, summary ist null und die Ergebnisse zählen als eine KI-Suche.
OpenAPI herunterladenSchnellstart
Ersetzen Sie ASSISTANT_ID durch die öffentliche ID aus den Assistenten-Einstellungen. Senden Sie während der gesamten Unterhaltung dieselbe session_id.
Basis-URL
https://informio.eu/apicurl --request POST \
--url https://informio.eu/api/widget/ASSISTANT_ID/messages \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Origin: https://example.com' \
--data '{
"session_id": "visitor-session-01JEXAMPLE1234567890",
"message": "When are you open?"
}'API-Referenz
Stabile Endpunkte, die vom offiziellen Informio-Widget verwendet werden.
/widget/{assistant}Gibt den Namen, das Erscheinungsbild, die Beschriftungen, die Verfügbarkeit der Operatoren und den vorhandenen Verlauf für eine Sitzung zurück.
/widget/{assistant}/messagesSendet die Frage eines Besuchers und gibt eine Antwort, Produkte oder den aktuellen Human-Handoff-Status zurück.
/widget/{assistant}/syncLädt neue Operatornachrichten, den Übernahmestatus und den Abschluss der Unterhaltung, ohne die gesamte Oberfläche neu zu laden.
/widget/{assistant}/handoffFordert das verfügbare Team auf, die Unterhaltung zu übernehmen, wenn Human Handoff für den Assistenten aktiviert ist.
/widget/{assistant}/page-viewOrdnet der Unterhaltung eine besuchte URL und einen Seitentitel zu, ohne Formularinhalte oder Query-Parameter.
/widget/{assistant}/endBeendet die aktuelle Unterhaltung und speichert optional eine positive oder negative Besucherbewertung.
Empfohlener Ablauf
Der Client benötigt nur eine öffentliche Assistenten-ID, einen zulässigen Origin und eine stabile session_id.
Wenn der Chat geöffnet wird, rufen Sie sein Erscheinungsbild, seine Beschriftungen und den vorhandenen Verlauf der Sitzung ab.
Senden Sie jede Frage mit derselben session_id und fügen Sie auf der Website die aktuelle Seite hinzu.
Laden Sie nach der Anforderung einer Person regelmäßig neue Nachrichten und den Operatorstatus.
Importieren Sie das OpenAPI-YAML in Postman oder Insomnia, oder verwenden Sie es, um in Ihrer bevorzugten Sprache einen Client zu generieren.
OpenAPI herunterladenDer öffentliche Vertrag umfasst Chat, Widget und Search. Verwaltungs-APIs für Assistenten und Wissensquellen sind nicht öffentlich. Kontaktieren Sie info@informio.eu.
Starten Sie ohne Zahlungskarte oder API-Schlüssel. Die standardmäßige Informio AI ist automatisch einsatzbereit, während Ihr eigenes OpenAI-Konto oder Ihr eigener AI-Server optional bleibt.
KOSTENLOSER Plan · 100 Antworten · keine Zahlungskarte