Verbinden Sie Ihr eigenes System

Lassen Sie die KI angemeldete Kunden aus Ihrem eigenen System beantworten — im Chat und in Widget-Sprachanrufen — ohne Ihre Kundendaten an OrderInChat weiterzugeben.

Übersicht

Kanäle & Integrationen → Eigenes System (/de/integrations/own-system) ist für Shops, die Kundenkonten in ihrem eigenen System (zum Beispiel ein Logistikportal) führen und diese Daten nicht in OrderInChat kopieren möchten.

Sie betten das OrderInChat-Widget auf Ihren angemeldeten Seiten ein.
Ihr Server signiert ein kurzlebiges Token für den angemeldeten Benutzer und gibt es an das Widget weiter.
Wenn dieser Kunde nach seinem eigenen Konto fragt (zum Beispiel "Wo ist meine Sendung?"), ruft die KI Ihre eigenen schreibgeschützten MCP-Tools mit dem Token dieses Benutzers im Textchat und in Sprachanrufen ab, die vom Widget gestartet werden.
OrderInChat überprüft nur Ihre Signatur. Es erstellt niemals Identitäten, liest niemals Ihre Datenbank und speichert nicht, was Ihre Tools zurückgeben.

Verfügbar in kostenpflichtigen Plänen (Starter, Pro, Ultra). Besucher ohne ein gültiges Token sind anonym: Die KI antwortet aus Ihrer Wissensdatenbank und fordert sie auf, sich für Kontofragen anzumelden.

Die KI Ihrer Entwickler bauen lassen

Klicken Sie unter Für die KI Ihrer Entwickler auf Anleitung kopieren und fügen Sie den Text unverändert in den KI-Assistenten Ihrer Entwickler ein (Claude Code, Cursor, ChatGPT…). Er ist auf Englisch und beschreibt genau, was zu bauen ist — Token-Endpunkt, signierter MCP-Server und Widget-Snippet — mit Ihrer Shop-ID und Ihren Adressen. Am Ende soll die KI eine Liste der Werte für diese Seite liefern. Geheimnisse stehen nie im Text: Erstellen Sie die Signatur-Secrets auf dieser Seite und hinterlegen Sie sie selbst auf Ihrem Server.

1. Benutzeranmeldetoken

Ihr Server signiert ein JWT für den angemeldeten Benutzer:

Anspruch	Erforderlich	Bedeutung
`sub`	ja	Die Benutzer-ID in Ihrem System
`exp`	ja	Ablauf — höchstens 15 Minuten im Voraus
`name`, `email`	nein	Wird Ihrem Team im Posteingang und auf der Kundenkarte angezeigt
`iss`, `aud`	nein	Wird nur überprüft, wenn Sie sie auf der Einstellungsseite ausfüllen

Wählen Sie, wie OrderInChat es überprüft:

JWKS-URL (ES256 oder RS256) — die HTTPS-Adresse Ihrer öffentlichen Schlüssel.
Öffentlicher Schlüssel (ES256 oder RS256) — fügen Sie den PEM-öffentlichen Schlüssel ein.
Geteiltes Geheimnis (HS256) — mindestens 32 Zeichen, verschlüsselt gespeichert.

Fügen Sie ein Beispiel-Token unter Token testen ein, um es zu überprüfen, bevor Sie live gehen. Ein ungültiges oder abgelaufenes Token führt niemals zu einem Fehler im Chat — der Besucher wird einfach als anonym behandelt.

2. Ihr MCP-Server

Geben Sie die Adresse Ihres MCP-Servers (Streamable HTTP, tools/list und tools/call) ein. Test und Live haben jeweils ihre eigene Adresse und Signaturgeheimnis; Aktivmodus wählt aus, welches die KI verwendet.

Klicken Sie auf Erstellen, um ein Signaturgeheimnis zu erhalten. Es wird einmal angezeigt — speichern Sie es auf Ihrem Server. Widerrufen entfernt es sofort (Anrufe in diesem Modus stoppen, bis Sie ein neues erstellen).

Jede Anfrage, die OrderInChat an Ihren Server sendet, trägt:

X-OIC-Timestamp — Unix-Sekunden
X-OIC-Signature — v1= + hex HMAC-SHA256 von timestamp.body mit Ihrem Signaturgeheimnis
X-OIC-User-Token — das Token des Benutzers, unverändert (überprüfen Sie es selbst und geben Sie nur die Daten dieses Benutzers zurück)
X-OIC-Mode — test oder live

Lehnen Sie Anfragen ab, deren Signatur nicht übereinstimmt oder deren Zeitstempel älter als 5 Minuten ist. OrderInChat hat keine feste IP-Adresse, verwenden Sie also die Signatur anstelle einer IP-Whitelist.

3. Tools

Klicken Sie auf Tools entdecken, um die Tools zu lesen, die Ihr Server auflistet, und schalten Sie die ein, die die KI verwenden darf. Erlauben Sie nur schreibgeschützte Tools. Tools, die später erscheinen, sind zunächst deaktiviert, bis Sie sie aktivieren.

Textchat: Ein Toolaufruf kann bis zu 8 Sekunden dauern.
Sprachanrufe: bis zu 3 Sekunden; der Assistent sagt zuerst kurz "Lassen Sie mich nachsehen". Wenn Ihr Server langsam ist, sagt er, dass er gerade nicht nachsehen konnte.
Was Ihre Tools zurückgeben, wird nur als Daten behandelt, niemals als Anweisungen, und wird nicht im Chatverlauf gespeichert.

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken wird aufgerufen, wenn das Token kurz vor dem Ablauf steht. Nachdem das Skript geladen wurde, können Sie auch OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (bei Abmeldung) und OrderInChat.onTokenRefresh(fn) verwenden.

Mit einem gültigen Token und dem Sprachassistenten wird im Widgetkopf ein Telefon-Button angezeigt. Der Anruf erfolgt im Widget und wird wie jeder Website-Anruf von KI-Credits abgerechnet (Toolaufrufe sind im Anruf enthalten). Webanruf-Audio wird nicht aufgezeichnet.

Anpassen öffnet die Widget-Einstellungen in einem neuen Tab. Das Snippet lädt das Aussehen des Widgets bei jedem Seitenaufruf von OrderInChat (per data-tenant-id), Änderungen dort gelten also sofort — ohne den Code neu einzufügen. Verwendet wird das für Ihren Shop gewählte Widget-Profil (sonst das aktive oder erste Profil); es wird kein neues Profil angelegt.

5. Verbindung testen

Unter Tools führt Verbindung testen feste Prüfungen gegen Ihre Test-MCP-Adresse mit dem Test-Signaturgeheimnis aus. Keine KI ist beteiligt, nichts wird gespeichert. Geprüft wird, dass:

die Adresse öffentliches https ist (kein localhost, keine private Netzwerkadresse);
ein korrekt signiertes tools/list funktioniert;
eine Anfrage mit falscher Signatur abgelehnt wird;
eine korrekte Signatur mit einem Zeitstempel älter als 5 Minuten abgelehnt wird;
tools/call auf ein eingeschaltetes Tool ohne Benutzer-Token einen Fehler und keine Daten liefert;
mit einem unter Token testen eingefügten Beispiel-Token tools/call funktioniert — und wie schnell (über 2 Sekunden ist zu langsam für Sprachanrufe; Sprachanrufe geben nach 3 Sekunden auf).

Aufgerufen werden nur Tools, die Sie gefunden und eingeschaltet haben, mit leeren Argumenten; das Beispiel-Token wird nur für diesen Test verwendet und nie gespeichert. Jeder fehlgeschlagene Punkt zeigt, wie er zu beheben ist. Ergebnisse für Ihren Entwickler kopieren kopiert einen englischen Bericht für Ihren Entwickler oder dessen KI; wiederholen Sie den Test, bis nichts mehr fehlschlägt.

Was Ihr Team sieht

Posteingang → Web: der Name und die E-Mail des Kunden aus dem Token oder Benutzer #ID, wenn Sie weder senden. Jede KI-Antwort zeigt, welches Ihrer Tools verwendet wurde und ob es funktioniert hat — niemals die Daten.
Posteingang → Anrufe: Widget-Anrufe erscheinen unter Shop-Website und in Live, während sie laufen; das Transkript zeigt jeden Schritt des Tools (Name und Ergebnis nur).
Kunden: Eine Kundenkarte wird für jede Benutzer-ID (Shop-Benutzer-ID) erstellt oder wiederverwendet, sodass Chats und Anrufe derselben Person verknüpft sind.