Open Contact Center / Einsteiger
Web-Chat einbinden
Einen freigegebenen Agenten einbetten und die Übergabe im Test prüfen.
Status dieser Funktion
Web-Chat & Embed-Widget Verfügbar
Einbettbarer Chatbot mit Embed-Keys Verfügbar
Web Chat als Contact Center Kanal Vorschau
Übernahme im Browser, gespeicherte Webchat-Antworten von Menschen und Rückgabe sind lokal geprüft; k3d prüft zusätzlich die KI-Antwort im eingebetteten Chat vor und nach der Rückgabe mit einem Fake-LLM. Produktiver Widget-Einsatz und echte Anbieterzustellung sind noch nicht geprüft. Webchat-Antworten von Menschen sind Sitzungsnachrichten. Keine Live-Sprachantwort, kein Mithören, Flüstern oder Einschalten.
1. Agent und Einbettung prüfen
Öffne den Agenten in der Anwendung. Prüfe Evaluation, Veröffentlichung und die Konfiguration der Einbettung. Wähle im Widget Studio den veröffentlichbaren Embed-Schlüssel eines veröffentlichten Chatbots oder einer Public-Link-App. Prüfe dessen erlaubte Origins. Die Embed-Adresse verwendet /embed/oap_pk_..., keine bloße Agenten-ID. Übernimm bevorzugt das dort erzeugte iframe-Snippet. Ersetze im Beispiel App-Adresse und Schlüssel. Die Adresse ist ein Platzhalter, kein öffentlicher Demodienst.
2. Auf einer Testseite einbauen
Füge das iframe in die dafür vorgesehene Stelle deiner Website ein. Bestehende Zugriffsvorgaben des Agenten gelten weiter. Prüfe auch, ob die Einbettungs- und Sicherheitsrichtlinien deiner Website das App-Ziel erlauben.
<iframe
src="https://APP-ADRESSE/embed/oap_pk_DEIN_OEFFENTLICHER_EMBED_SCHLUESSEL"
title="Kontakt zum KI-Assistenten"
width="100%"
height="600"
></iframe>3. Gespräch und Übergabe prüfen
Öffne die Testseite als vorgesehener Besucher und sende eine synthetische Frage. Kontrolliere die Antwort und das gespeicherte Gespräch im Contact Center. Übernimm dort das Gespräch, sende eine menschliche Antwort und gib es anschließend an die KI zurück. Prüfe eine weitere KI-Antwort im Widget.
Ergebnis prüfen
Der Chat ist erreichbar und die Zuständigkeit lässt sich nachvollziehen. Bei leerem Widget App-Adresse, Embed-Schlüssel, erlaubte Origin, Freigabe und Limits prüfen. Ein sichtbares iframe allein ist noch kein erfolgreiches Gespräch.
Die einzelnen Schritte zur Gesprächsübernahme erklären den menschlichen Teil.
Grundlage im Repository
apps/web/src/app/embed/[agentId]/page.tsxdocs/product-acceptance/pilot-demo.md
Open Contact Center / Beginner
Embed web chat
Embed a released agent and test the handoff.
Feature status
Web chat & embed widget Available
Embeddable chatbot with publishable keys Available
Web chat as a contact center channel Preview
Browser takeover, persisted human web-chat replies and handback are verified locally; k3d also verifies the embedded chat AI reply before and after handback with a fake LLM. Production widget deployment and real provider delivery remain unverified. Human web-chat replies are session messages. No live voice reply, listen, whisper or barge.
1. Check the agent and embedding
Open the agent in the application. Check evaluation, release and embed configuration. In Widget Studio, select the publishable embed key of a released chatbot or a public-link app. Check its allowed origins. The embed address uses /embed/oap_pk_..., not a bare agent ID. Prefer the iframe snippet generated there. Replace the app address and key in the example. The address is a placeholder, not a public demo service.
2. Add it to a test page
Insert the iframe in the intended place on your website. The agent's existing access requirements still apply. Also check whether your website's embedding and security policies allow the app destination.
<iframe
src="https://APP-ADRESSE/embed/oap_pk_DEIN_OEFFENTLICHER_EMBED_SCHLUESSEL"
title="Kontakt zum KI-Assistenten"
width="100%"
height="600"
></iframe>3. Check the conversation and handoff
Open the test page as the intended visitor and send a synthetic question. Check the response and the saved conversation in the Contact Center. Take over the conversation there, send a human reply and then hand it back to the AI. Check for another AI reply in the widget.
Check the result
The chat is accessible and ownership is traceable. If the widget is empty, check the app address, embed key, allowed origin, release and limits. A visible iframe alone is not yet a successful conversation.
The individual steps for taking over a conversation explain the human part.
Repository sources
apps/web/src/app/embed/[agentId]/page.tsxdocs/product-acceptance/pilot-demo.md