Widgets & Einbettung

Mit Widgets stellen Sie einen Agenten außerhalb von DocyIQ bereit – als Chat-Widget auf Ihrer eigenen Website oder als API-Schlüssel für eigene Integrationen. Besucher chatten dann anonym mit dem Agenten, ohne DocyIQ-Konto.

Dieser Bereich ist nur für Admins sichtbar.

Klicken Sie im Bereich Widgets auf Neues Widget erstellen.
Vergeben Sie eine Bezeichnung (z. B. „Marketing-Website"), wählen Sie den Agent und den Kanal:
- Webcomponent – das einbettbare Chat-Widget für Websites.
- API – ein geheimer Schlüssel für serverseitige Integrationen.
Nach Erstellen zeigt der Dialog Neuer Schlüssel erzeugt den Schlüssel an.

Schlüssel und Sicherheit

Die beiden Kanäle behandeln ihre Schlüssel unterschiedlich:

API-Schlüssel werden nur einmal angezeigt – speichern Sie sie sofort sicher ab; danach ist nur noch das Präfix sichtbar.
Webcomponent-Schlüssel sind bewusst veröffentlichbar und jederzeit auf der Detailseite abrufbar (sie stehen ohnehin im HTML Ihrer Website).

Über Schlüssel rotieren erzeugen Sie einen neuen Schlüssel; der alte bleibt 7 Tage gültig, damit Sie Ihre Website in Ruhe umstellen können. Widerrufen deaktiviert das Widget sofort und unwiderruflich.

Zugriff und Limits

Auf der Detailseite unter Zugriff & Limits:

Erlaubte Hosts – nur Websites mit diesen Hostnamen dürfen das Widget nutzen (z. B. example.com, ohne Protokoll oder Pfad). Ohne Eintrag funktioniert das Widget nirgends.
Anfragen pro Minute (pro IP) – schützt vor Missbrauch.
Max. Eingabezeichen – begrenzt die Länge einzelner Nachrichten.

Einbetten auf der eigenen Website

Der Abschnitt Schlüssel & Einbettung liefert das fertige Einbettungs-Snippet zum Kopieren – ein Skript-Tag plus das <kum-chat>-Element mit Ihrem Schlüssel. Beim Kanal API steht dort stattdessen ein API-Aufruf-Beispiel; alle Endpunkte und Parameter beschreibt die technische API-Referenz.

Unter Darstellung passen Sie den Widget-Titel und die Begrüßungsnachricht an, die Besucher als erste Nachricht sehen. Farben und Eckenradius stylen Sie per CSS Custom Properties direkt auf Ihrer Website.

Unterhaltungen einsehen

Der Abschnitt Unterhaltungen listet die Gespräche, die über das Widget oder den API-Schlüssel geführt wurden. Sie werden 90 Tage nach der letzten Nachricht aufbewahrt und danach automatisch gelöscht. Ein Klick öffnet den Verlauf inklusive eventueller Fragebogen-Antworten; einzelne Unterhaltungen lassen sich dauerhaft löschen.

Datenschutz-Hinweis für Ihre Website