Open Contact Center / Einsteiger

Web-Chat einbinden

Einen freigegebenen Agenten einbetten und die Übergabe im Test prüfen.

8 Min. Lesezeit · Zuletzt aktualisiert:

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.

html
<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.tsx
  • docs/product-acceptance/pilot-demo.md

Open Contact Center / Beginner

Embed web chat

Embed a released agent and test the handoff.

8 min read · Last updated:

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.

html
<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.tsx
  • docs/product-acceptance/pilot-demo.md