Für alles, was nicht in der Liste steht: Der Chatbot fragt dein eigenes System im Gespräch ab - per Eigener Aktion oder über einen MCP-Server.
Auf dieser Seite
Eigene Aktion
1
Öffne im Dashboard Integrationen und klicke auf Eigene Aktion.
2
Gib der Aktion einen Namen und beschreibe, wann der Chatbot sie benutzen soll (z. B. „Wenn jemand fragt, ob ein Produkt vorrätig ist“).
3
Trage die Adresse deines Systems (https) und die Methode ein. GET schickt die Angaben in der Adresse, POST als JSON.
4
Optional: Kopfzeile mit Schlüssel (z. B. X-Api-Key) - wird verschlüsselt gespeichert.
5
Lege die Angaben fest, die der Chatbot mitschicken soll (z. B. produkt). Markierst du eine Angabe als Pflicht, fragt der Chatbot danach, bevor er dein System aufruft.
6
Optional für Aktionen, die etwas ändern (z. B. stornieren): „Vor dem Ausführen bestätigen lassen“ – der Chatbot fasst zusammen und fragt nach. „Einmalcode per E-Mail verlangen“ – der Kunde bekommt einen 6-stelligen Code und nennt ihn im Chat; erst dann ruft der Chatbot dein System auf und schickt die bewiesene E-Mail mit.
Was passiert: Passt eine Frage zur Beschreibung, ruft der Chatbot dein System auf und formuliert die Antwort ausschließlich aus dem, was dein System zurückgibt. Geht auch mit Make und n8n (Webhook mit Antwort).
i
Gut zu wissen: Nur öffentliche https-Adressen, keine Umleitungen, 8 Sekunden Zeitlimit. Antwortet dein System nicht, antwortet der Chatbot wie gewohnt. Gibt deine Aktion persönliche Daten heraus (z. B. einen Rechnungslink zur Kundennummer), lass zur Sicherheit eine zweite Angabe mitschicken, etwa E-Mail oder Handynummer, und prüfe sie in deinem System.
Eigener MCP-Server
1
Stelle einen MCP-Server mit Streamable-HTTP-Transport bereit (z. B. https://mcp.deinshop.de/mcp).
2
Öffne im Dashboard Integrationen und klicke auf Eigener MCP-Server.
3
Trage die Adresse und, falls nötig, ein Zugangstoken (Bearer) ein.
4
Alpheris liest die Werkzeuge des Servers und zeigt sie an.
Was passiert: Passt eine Frage zu einem Werkzeug, ruft der Chatbot es auf und antwortet aus dem Ergebnis - wie Fin mit MCP-Connectoren. Bis zu fünf Server.
i
Gut zu wissen: Die Werkzeugbeschreibungen deines Servers entscheiden, wann der Chatbot sie benutzt - beschreibe sie klar.
Statuspage
1
Öffne im Dashboard Integrationen und klicke auf Statuspage.
2
Trage die Adresse deiner Atlassian-Statusseite ein (z. B. https://status.deinshop.de).
Was passiert: Fragt jemand nach einer Störung („Geht die Kasse gerade nicht?“), antwortet der Chatbot mit den offenen Störungen und Wartungen deiner Statusseite - oder dass alles normal läuft.
Angemeldete Kunden
1
Öffne im Dashboard Integrationen und klicke auf Angemeldete Kunden.
2
Klicke auf „Schlüssel erzeugen“ und bewahre den Schlüssel auf deinem Server auf. Er wird nur einmal angezeigt.
3
Berechne auf deinem Server für den eingeloggten Kunden: HMAC-SHA256 mit dem Schlüssel über seine E-Mail in Kleinbuchstaben, als Hex-Text. PHP: hash_hmac('sha256', strtolower($email), $schluessel). Node: crypto.createHmac('sha256', schluessel).update(email.toLowerCase()).digest('hex'). Python: hmac.new(schluessel.encode(), email.lower().encode(), hashlib.sha256).hexdigest().
4
Setz auf Seiten mit eingeloggten Kunden vor den Widget-Code: window.AlpherisKunde = { email: "…", name: "…", hash: "…" }.
Was passiert: Stimmt die Signatur, steht die E-Mail als bestätigt im Gespräch. Bestellstatus und offene Rechnungen nennt der Chatbot dann ohne Nachfrage, wenn die E-Mail zur Bestellung oder Rechnung passt. Ohne gültige Signatur ändert sich nichts.
i
Gut zu wissen: Der Schlüssel gehört nie in den Browser – wer ihn kennt, könnte sich als jeder Kunde ausgeben. Ein neuer Schlüssel macht den alten nach spätestens einer Minute ungültig.
Alpheris API
1
Lege im Dashboard unter Workspace, API Keys einen Schlüssel an.
2
Für Ereignisse: lege unter Workspace, Webhooks eine Adresse an.
Was passiert: Dein System liest und schreibt Gespräche, Tickets und Leads. Details stehen in der API-Referenz.
